Remove-CimSession
拿掉一或多個 CIM 工作階段。
Syntax
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 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。
Type: | CimSession[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
指定電腦名稱的陣列。 拿掉連接到指定電腦的工作階段。 您可以在 FQDN) 或 NetBIOS 名稱 (指定完整功能變數名稱。
Type: | String[] |
Aliases: | CN, ServerName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Confirm
在執行 Cmdlet 前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
指定要移除的 CIM 會話標識碼。 指定以逗號分隔的一或多個標識符,或使用範圍運算符 (..
) 指定標識符的範圍。 標識碼是整數,可唯一識別目前PowerShell會話中的 CIM 會話。
如需範圍運算子的詳細資訊,請參閱 about_Operators。
Type: | UInt32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceId
指定要移除之 CIM 會話的實例識別碼。 InstanceId 是全域唯一標識符 (GUID) ,可唯一識別 CIM 會話。 InstanceId 是唯一的,即使您在 PowerShell 中執行多個作業階段也是如此。
InstanceId 會儲存在代表 CIM 會話之 物件的 InstanceId 屬性中。
Type: | Guid[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
指定要移除之 CIM 工作階段的易記名稱。 您可以搭配此參數使用通配符。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
None
此 Cmdlet 不接受任何輸入物件。
輸出
此 Cmdlet 會傳回包含 CIM 工作階段資訊的物件。