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

Description

此 Cmdlet 只能在 Windows 平臺上使用。

該 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。

參數屬性

類型:

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
別名:參見

參數集

(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 是一個全球唯一識別碼(GUID),可唯一識別 CIM 會話。 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 平臺。