共用方式為

Remove-PSSnapin

  • 參考
模組:
Microsoft.PowerShell.Core

從目前的會話中移除 Windows PowerShell 嵌入式管理單元。

語法

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

Description

Cmdlet Remove-PSSnapin 會從目前的會話中移除 Windows PowerShell 嵌入式管理單元。 您可以使用它來移除已新增至 Windows PowerShell 的嵌入式管理單元：您無法使用此 Cmdlet 來移除隨 Windows PowerShell 一起安裝的嵌入式管理單元。

從目前會話移除嵌入式管理單元之後，嵌入式管理單元仍會載入，但是該嵌入式管理單元中的 Cmdlet 和提供者已無法在會話中使用。

範例

範例 1：移除嵌入式管理單元

Remove-PSSnapin -Name Microsoft.Exchange

此命令會 從目前的會話中移除 Microsoft.Exchange 嵌入式管理單元。 當命令完成時，會話中無法使用支援嵌入式管理單元的 Cmdlet 和提供者。

範例 2：搭配管線使用名稱來移除嵌入式管理單元

Get-PSSnapIn smp* | Remove-PSSnapIn

此命令會從目前會話中移除名稱開頭為 smp 的 Windows PowerShell 嵌入式管理單元。

命令會 Get-PSSnapin 使用 Cmdlet 來取得代表嵌入式管理單元的物件。管線運算子 （|） 會將結果傳送至 Remove-PSSnapin Cmdlet，以從會話中移除它們。 此嵌入式管理單元支援的提供者和 Cmdlet 已無法在工作階段中使用。

當您使用管線將對象傳送至 Remove-PSSnapin時，對象的名稱會與 Name 參數相關聯，該參數會接受來自具有 Name 屬性之管線的物件。

範例 3：使用名稱移除嵌入式管理單元

Remove-PSSnapin -Name *event*

此命令會移除包含事件名稱的所有 Windows PowerShell 嵌入式管理單元。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定要從目前會話中移除的 Windows PowerShell 嵌入式管理單元名稱。 允許通配符 （*） 。

類型:String[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-PassThru

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

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

PSSnapInInfo

您可以使用管線將嵌入式管理單元物件傳送至此 Cmdlet。

輸出

None, System.Management.Automation.PSSnapInInfo

如果您指定 PassThru 參數，此 Cmdlet 會產生代表嵌入式管理單元的 System.Management.Automation.PSSnapInInfo 物件。 根據預設， Remove-PSSnapin 不會產生任何輸出。

備註

Windows PowerShell 包含下列的 Remove-PSSnapin別名：

  • rsnp

Remove-PSSnapin 在從會話中移除嵌入式管理單元之前，不會檢查 Windows PowerShell 的版本。 如果無法移除嵌入式管理單元，則會出現警告，命令會失敗。

Remove-PSSnapin 只會影響目前的會話。 如果您已將命令新增 Add-PSSnapin 至 Windows PowerShell 設定檔，您應該刪除 命令，以從未來的工作階段中移除嵌入式管理單元。 如需指示，請輸入 Get-Help about_Profiles。