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>]

说明

此 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-CimSessionGet-CimSession cmdlet。 有关详细信息,请参阅 about_CimSessions

参数属性

类型:

CimSession[]

默认值:None
支持通配符:False
不显示:False

参数集

CimSessionSet
Position:0
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ComputerName

指定一个包含计算机名称的数组。 删除连接到指定计算机的会话。 可以指定完全限定的域名(FQDN)或 NetBIOS 名称。

参数属性

类型:

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 会话。

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

参数属性

类型:

UInt32[]

默认值:None
支持通配符:False
不显示:False

参数集

SessionIdSet
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-InstanceId

指定要删除的 CIM 会话的实例 ID。 InstanceId 是唯一标识 CIM 会话的全局唯一标识符(GUID)。 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 会话信息的对象。

备注

PowerShell 包含以下与 Remove-CimSession相关的别名:

  • 窗户:
    • rcms

此 cmdlet 仅在 Windows 平台上可用。