将 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。

输出

None or System.Management.Automation.PSSnapInInfo

默认情况下,Remove-PsSnapin 不生成任何输出。但是,如果使用 PassThru 参数,则会生成表示管理单元的 System.Management.Automation.PSSnapInInfo 对象。

说明

还可以使用 Remove-PSSnapin 的内置别名“rsnp”来对其进行引用。有关详细信息,请参阅 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 在会话中不再可用。

当通过管道将对象传递到 Remove-PSSnapin 时,对象的名称与 Name 参数关联,该参数从管道接受具有 Name 属性的对象。






示例 3

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

说明
-----------
此命令删除名称中包含“event”的所有 Windows PowerShell 管理单元。此命令指定“Name”参数名称,但由于该参数名称是可选的,因此可以省略。






另请参阅




目录