移除目前工作階段中的 Windows PowerShell 嵌入式管理單元。

語法

Remove-PSSnapin [-Name] <string[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

描述

Remove-PSSnapin Cmdlet 會從目前的工作階段移除 Windows PowerShell 嵌入式管理單元。您可以使用它來移除已新增到 Windows PowerShell 的嵌入式管理單元,不過,您無法用它來移除與 Windows PowerShell 一起安裝的嵌入式管理單元。

嵌入式管理單元在從目前的工作階段移除之後仍為載入狀態,但是,您已無法再於此工作階段中使用該嵌入式管理單元內的 Cmdlet 和提供者。

參數

-Name <string[]>

指定要從目前工作階段中移除之 Windows PowerShell 嵌入式管理單元的名稱。參數名稱 ("Name") 為選擇項,而且允許在其值中使用萬用字元 (*)。

必要?

true

位置?

1

預設值

接受管線輸入?

true (ByPropertyName)

接受萬用字元?

true

-PassThru

傳回代表嵌入式管理單元的物件。根據預設,此 Cmdlet 不會產生任何輸出。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Confirm

在執行命令前先提示確認。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-WhatIf

說明執行命令時將會發生何種情況,但不會實際執行命令。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.Management.Automation.PSSnapInInfo

您可以經由管道將嵌入式管理單元物件輸出至 Remove-PSSnapin。

輸出

無或 System.Management.Automation.PSSnapInInfo

根據預設,Remove-PsSnapin 不會產生任何輸出。不過,如果您使用 PassThru 參數,它就會產生代表嵌入式管理單元的 System.Management.Automation.PSSnapInInfo 物件。

附註

您也可以利用內建的別名 "rsnp" 來參照 Remove-PSSnapin。如需詳細資訊,請參閱 about_Aliases。

Remove-PSSnapin 在從工作階段移除 Windows PowerShell 嵌入式管理單元之前,不會檢查嵌入式管理單元的版本。如果無法移除嵌入式管理單元,便會出現警告訊息,而且命令會失敗。

Remove-PSSnapin 只會影響目前的工作階段。如果您已將 Add-PSSnapin 命令新增至 Windows PowerShell 設定檔,則必須刪除此命令,未來建立工作階段時便不會包含該嵌入式管理單元。如需相關指示,請參閱 about_Profiles。

範例 1

C:\PS>remove-pssnapin -name Microsoft.Exchange

描述
-----------
這個命令會從目前的工作階段中移除 Microsoft.Exchange 嵌入式管理單元。當此命令完成時,此工作階段就無法再使用該嵌入式管理單元所支援的 Cmdlet 和提供者。






範例 2

C:\PS>get-PSSnapIn smp* | remove-PSSnapIn

描述
-----------
這個命令會從目前的工作階段中移除名稱開頭為 "smp" 的 Windows PowerShell 嵌入式管理單元。

此命令會使用 Get-PSSnapin Cmdlet 來取得代表這些嵌入式管理單元的物件。管線運算子 (|) 會將結果傳送到 Remove-PSSnapin Cmdlet,此 Cmdlet 會從工作階段中移除這些嵌入式管理單元。此工作階段中將無法再使用這個嵌入式管理單元所支援的提供者和 Cmdlet。

當您經由管道將物件輸出至 Remove-PSSnapin 時,這些物件的名稱就會與 Name 參數產生關聯,而這個參數會接受由管線傳入且包含 Name 屬性的物件。






範例 3

C:\PS>remove-pssnapin -name *event*

描述
-----------
這個命令會移除名稱中包含 "event" 的所有 Windows PowerShell 嵌入式管理單元。這個命令會指定 "Name" 參數名稱,但是因為此參數名稱為選擇項,所以可以省略。






請參閱




目錄