如下说明是翻译
: 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