通过

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 平台上可用。

cmdlet Remove-CimSession 从本地 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。

Type:CimSession[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

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

Type:String[]
Aliases:CN, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

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

Type:UInt32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstanceId

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

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

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定要删除的 CIM 会话的友好名称。 可以将通配符与此参数一起使用。

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

None

此 cmdlet 不接受任何输入对象。

输出

Object

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