Remove-PSSnapin

發行項
10/30/2009

移除目前工作階段中的 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" 參數名稱，但是因為此參數名稱為選擇項，所以可以省略。

請參閱

概念

Add-PSSnapin
Get-PSSnapin
about_Profiles

共用方式為