Remove-CimSession

参考

模块:: CimCmdlets

移除一个或多个 CIM 会话。

语法

Remove-CimSession
      [-CimSession] <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CimSession
      [-ComputerName] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CimSession
      [-Id] <UInt32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CimSession
      -InstanceId <Guid[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CimSession
      -Name <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

此 cmdlet 仅在 Windows 平台上可用。

Remove-CimSession cmdlet 从本地 PowerShell 会话中移除一个或多个 CIM 会话对象。

示例

示例 1：移除所有 CIM 会话

此示例使用 Get-CimSession cmdlet 检索本地计算机上的所有可用 CIM 会话，然后使用 Remove-CimSession 将其移除。

Get-CimSession | Remove-CimSession

示例 2：移除特定的 CIM 会话

此示例移除 Id 值为 5 的 CIM 会话。

Remove-CimSession -Id 5

示例 3：显示要使用 WhatIf 参数移除的 CIM 会话列表

此示例使用通用参数 WhatIf 指定不应执行移除操作，而只应输出执行移除操作后会发生的情况。

Remove-CimSession -Name a* -WhatIf

参数

-CimSession

指定要关闭的 CIM 会话的会话对象。

输入一个包含 CIM 会话的变量，或输入一个用于创建或获取 CIM 会话的命令，例如 New-CimSession 或 Get-CimSession cmdlet。有关详细信息，请参阅 about_CimSessions。

类型:	CimSession[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ComputerName

指定计算机的名称数组。移除连接到指定计算机的会话。可以指定完全限定的域名 (FQDN)，也可以指定 NetBIOS 名称。

类型:	String[]
别名:	CN, ServerName
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	True

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Id

指定要删除的 CIM 会话的 ID。指定一个或多个 ID，用逗号分隔，或使用范围运算符 (..) 指定一系列 ID。 Id 是一个整数，用于在当前 PowerShell 会话中唯一标识 CIM 会话。

有关范围运算符的详细信息，请参阅 about_Operators。

类型:	UInt32[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-InstanceId

指定要删除的 CIM 会话的实例 ID。 InstanceId 是唯一标识 CIM 会话的全局唯一标识符 (GUID)。即使在 PowerShell 中运行了多个会话，InstanceId 也是唯一的。

InstanceId 存储在表示 CIM 会话的对象的 InstanceId 属性中。

类型:	Guid[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

指定要移除的 CIM 会话的易记名称。可以在此参数中使用通配符。

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	True

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

不能通过管道将对象传递给此 cmdlet。

输出

Object

此 cmdlet 返回一个包含 CIM 会话信息的对象。

备注

PowerShell 包含以下 Remove-CimSession 别名：

Windows：
- rcms

此 cmdlet 仅在 Windows 平台上可用。

通过