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 Cmdlet 會從本機 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 會話清單
此範例會使用 common 參數 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 |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Id
指定要移除的 CIM 會話標識碼。 指定以逗號分隔的一或多個標識符，或使用範圍運算符 （..） 來指定標識符的範圍。
識別碼 是整數，可唯一識別目前 PowerShell 工作階段中的 CIM 會話。
如需範圍運算子的詳細資訊，請參閱 about_Operators。
參數屬性
| 類型: | UInt32[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
SessionIdSet
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-InstanceId
指定要移除之 CIM 會話的實例識別碼。 InstanceId 是可唯一識別 CIM 會話的全域唯一標識碼（GUID）。 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 工作階段資訊的物件。