共用方式為

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

Description

此 Cmdlet 僅適用於 Windows 平臺。

Cmdlet Remove-CimSession 會從本機 PowerShell 工作階段中移除一或多個 CIM 工作階段物件。

範例

範例 1：移除所有 CIM 會話

此範例會使用 Get-CimSession Cmdlet 擷取本機電腦上所有可用的 CIM 會話，然後使用 移除它們 Remove-CimSession。

Get-CimSession | Remove-CimSession

範例 2：移除特定的 CIM 會話

此範例會移除標識碼值為 5 的 CIM 工作階段。

Remove-CimSession -Id 5

範例 3：使用 WhatIf 參數顯示要移除的 CIM 會話清單

這個範例會使用 Common 參數 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 會話標識碼。 指定以逗號分隔的一或多個標識符，或使用範圍運算符 （..） 來指定識別碼的範圍。 標識碼是整數，可唯一識別目前PowerShell會話中的 CIM 會話。

如需範圍運算子的詳細資訊，請參閱 about_Operators。

類型:UInt32[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-InstanceId

指定要移除之 CIM 會話的實例識別碼。 InstanceId 是全域唯一標識碼 （GUID），可唯一識別 CIM 會話。 InstanceId 是唯一的，即使您在 PowerShell 中執行多個作業階段也是如此。

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 平臺。