共用方式為

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

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

範例

範例 1：移除所有 CIM 會話

Get-CimSession | Remove-CimSession

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

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

Remove-CimSession -Id 5

此命令會移除識別碼值為 5 的 CIM 工作階段。

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

Remove-CimSession -Name a* -WhatIf

此命令會使用 common 參數 WhatIf 來指定不應該完成移除，但只會輸出完成時會發生的情況。

參數

-CimSession

指定要關閉之 CIM 工作階段的工作階段物件。

輸入包含 CIM 會話的變數，或建立或取得 CIM 工作階段的命令，例如 New-CimSession 或 Get-CimSession Cmdlet。 如需詳細資訊，請參閱 about_CimSessions。

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

-ComputerName

指定要連接 CIM 工作階段的電腦名稱。 允許通配符。

類型:String[]
別名:CN, ServerName
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:True

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Id

指定要移除的 CIM 會話標識碼。 指定以逗號分隔的一或多個標識符，或使用範圍運算符 （..） 來指定標識符的範圍。

標識碼是整數，可唯一識別目前PowerShell會話中的 CIM 會話。 比 InstanceId 更容易記住和輸入，但只在目前的 PowerShell 工作階段中是唯一的。

如需範圍運算子的詳細資訊，請參閱 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 工作階段資訊的物件。