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