Remove-PSSnapin
从当前会话中删除 Windows PowerShell 管理单元。
语法
Default (默认值)
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 |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Name
指定要从当前会话中删除的 Windows PowerShell 管理单元的名称。
允许使用通配符字符(*)。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-PassThru
返回一个表示管理单元的对象。 默认情况下,此 cmdlet 不生成任何输出。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输入
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。