Remove-PSSnapin 帮助信息

 

如下说明是翻译: help Remove-PSSnapin 产生的帮助信息.

译者: Edengundam(马涛)

 

Remove-PSSnapin

 

大纲

从当前控制台中移除Windows PowerShell管理单元.

 

语法

Remove-PSSnapin [-name] <string[]> [-passThru] [-whatIf] [-confirm] [<CommonParameters>]

 

详细描述

Remove-PSSnapIn cmdlet从当前控制台中移除Windows PowerShell管理单元. 你只能使用此命令移除那些你添加到Windows PowerShell中的管理单元, 你无法移除那些和Windows PowerShell一起被安装的管理单元. 当一个管理单元snap-in被移除后, 此管理单元依然处于加载状态, 但是在控制台上此管理单元支持的cmdlet和提供程序将不能被使用. 命令的影响只对当前控制台有效, 除非你使用Export-Console保存控制台配置.

 

参数

 

-name <string[]>

指定从当前控制台文件中移除的PSSnapIn的为一名称. 参数名称 ("-Name")为可选项.

 

强制参数?	true
参数位置?	1
默认值
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

 

-passThru <SwitchParameter>

输出此命令创建的对象到管道中. 默认情况下, 此命令不会将对象输出到管道.

 

强制参数?	false
参数位置?	named
默认值	False
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-whatIf

描述执行此命令将会发生的现象, 不会真正执行此命令.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-confirm

执行命令前提示你进行确认.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

 

输入类型

PSSnapInInfo.Name

 

返回类型

PSSnapInInfo object

 

注意

 

更多信息, 输入"Get-Help Remove-PSSnapIn -detailed". 需要技术信息, 输入"Get-Help Remove-PSSnapIn -full".

 

在从控制台移除管理单元时, Remove-PSSnapIn不会对Windows PowerShell的版本进行检查. 如果某个管理单元无法被删除, 命令将会失败并输出警告信息.

 

要保存当前控制台的配置(包括你添加和移除的管理单元), 使用Export-Console. 要查找当前控制台名称, 使用变量$console, 此变量将会在每次您启动Windows PowerShell 时, 自动更新当前控制台的名称.

 

如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".

 

你可以使用Remove-PSSnapin内建别名"rsnp". 需要更多信息, 查看About_Alias.

 

例1

 

C:/PS>remove-pssnapinn -name Microsoft.Exchange

 

此命令将会从当前控制台中移除Micrsoft.Exchange的管理单元. 当命令执行完毕, 此管理单元在当前控制台中支持的cmdlet和提供程序将不能被使用.

 

例2

 

C:/PS>get-PSSnapIn smp* | remove-PSSnapIn

 

C:/PS>Export-console ConsoleSansSMP.psc1

 

这些命令从当前控制台中移除那些以"Smp"开头的Windows PowerShell管理单元, 然后保存当前控制台配置.

 

第一个命令使用Get-PsSnapin cmdlet获取表示管理单元的对象. 管道运算符(|)将结果发送给Remove-PsSnapin cmdlet, 此命令从控制台移除管道中的对象. 在当前空台中, 此管理单元支持的提供程序和cmdlet将不能再被使用.

 

当你将对象通过管道传递给Remove-PsSnapin时, 对象上的name属性将会绑定到参数Name, 此命令接受那些来自管道中具有Name属性的对象.

 

第二个命令使用Export-Console将新的控制台配置存储到ConsoleSansSMP.psc1文件. 如果你在Windows PowerShell中使用此控制台配置文件, 你从控制台中移除的Windows PowerShell SMP管理单元将不会被载入.

 

相关链接

Add-PSSnapIn

Get-PSSnapIn

Export-Console