Remove-CimSession
删除一个或多个 CIM 会话。
语法
CimSessionSet (默认值)
Remove-CimSession
[-CimSession] <CimSession[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ComputerNameSet
Remove-CimSession
[-ComputerName] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SessionIdSet
Remove-CimSession
[-Id] <UInt32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InstanceIdSet
Remove-CimSession
-InstanceId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NameSet
Remove-CimSession
-Name <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Remove-CimSession cmdlet 从本地 PowerShell 会话中删除一个或多个 CIM 会话对象。
示例
示例 1:删除所有 CIM 会话
Get-CimSession | Remove-CimSession
此命令使用 Get-CimSession cmdlet 检索本地计算机上所有可用的 CIM 会话,然后使用 Remove-CimSession将其删除。
示例 2:删除特定的 CIM 会话
Remove-CimSession -Id 5
此命令删除 ID 值为 5 的 CIM 会话。
示例 3:显示使用 WhatIf 参数删除的 CIM 会话列表
Remove-CimSession -Name a* -WhatIf
此命令使用通用参数 WhatIf 指定不应删除,但仅输出在完成删除时会发生的情况。
参数
-CimSession
指定要关闭的 CIM 会话的会话对象。
输入包含 CIM 会话的变量,或创建或获取 CIM 会话的命令,例如 New-CimSession 或 Get-CimSession cmdlet。
有关详细信息,请参阅 about_CimSessions。
参数属性
| 类型: | CimSession[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CimSessionSet
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-ComputerName
指定要连接到 CIM 会话的计算机的名称。 允许使用通配符。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
| 别名: | 中国区, 服务器名称 |
参数集
ComputerNameSet
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前,提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Id
指定要删除的 CIM 会话的 ID。 指定用逗号分隔的一个或多个 ID,或使用范围运算符 (..) 指定一系列 ID。
ID 是一个整数,用于唯一标识当前 PowerShell 会话中的 CIM 会话。 它比 InstanceId 更容易记住和键入,但它仅在当前 PowerShell 会话中是唯一的。
有关范围运算符的详细信息,请参阅 about_Operators。
参数属性
| 类型: | UInt32[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
SessionIdSet
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-InstanceId
指定要删除的 CIM 会话的实例 ID。
InstanceId 是一个全局唯一标识符(GUID),用于唯一标识 CIM 会话。 InstanceId 是唯一的,即使在 PowerShell 中运行多个会话时也是如此。
InstanceId 存储在表示 CIM 会话的对象 InstanceId 属性中。
参数属性
| 类型: | Guid[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
InstanceIdSet
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-Name
指定要删除的 CIM 会话的友好名称。 可以将通配符与此参数一起使用。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
NameSet
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | 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。
输入
None
此 cmdlet 不接受任何输入对象。
输出
Object
此 cmdlet 返回包含 CIM 会话信息的对象。