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。
參數屬性
| 類型: | |
| 預設值: | 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 平臺。