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 会将其从会话中删除。此管理单元支持的提供程序和 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。

通过