通过

Remove-PSSnapin

  • 参考
模块:
Microsoft.PowerShell.Core

从当前会话中删除 Windows PowerShell 管理单元。

语法

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

说明

Remove-PSSnapin cmdlet 从当前会话中移除 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*

此命令将删除名称中包含 event 的所有 Windows PowerShell 管理单元。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定要从当前会话中删除的 Windows PowerShell 管理单元的名称。 允许使用通配符 (*)。

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

返回一个表示管理单元的对象。 默认情况下，此 cmdlet 将不产生任何输出。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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。