Remove-CimSession
Odebere jednu nebo více relací CIM.
Syntax
CimSessionSet (Výchozí)
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
Tato rutina je dostupná jenom na platformě Windows.
Cmdlet Remove-CimSession odebere jeden nebo více objektů relace CIM z místní relace PowerShellu.
Příklady
Příklad 1: Odeberte všechny relace CIM
Tento příklad načte všechny dostupné relace CIM na místním počítači pomocí rutiny cmdlet Get-CimSession a pak je odstraní pomocí Remove-CimSession.
Get-CimSession | Remove-CimSession
Příklad 2: Odebrání konkrétní relace CIM
Tento příklad odebere relaci CIM, která má hodnotu id 5.
Remove-CimSession -Id 5
Příklad 3: Zobrazení seznamu relací CIM, které se mají odebrat pomocí parametru WhatIf
Tento příklad používá společný parametr WhatIf k určení, že odebrání by se nemělo provést, ale pouze zobrazit, co by se stalo, kdyby bylo provedeno.
Remove-CimSession -Name a* -WhatIf
Parametry
-CimSession
Určuje objekty relace CIM, které mají být uzavřeny.
Zadejte proměnnou, která obsahuje relaci CIM, nebo příkaz, který relaci CIM vytvoří nebo získá, například pomocí cmdletů New-CimSession nebo Get-CimSession.
Další informace naleznete v části about_CimSessions.
Vlastnosti parametru
| Typ: | |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
CimSessionSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-ComputerName
Určuje pole názvů počítačů. Odebere relace připojené k konkrétně zadaným počítačům. Můžete zadat plně kvalifikovaný název domény (FQDN) nebo název rozhraní NetBIOS.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
| Aliasy: | Čína, Název serveru |
Sady parametrů
ComputerNameSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Id
Určuje ID relace CIM, která se má odebrat. Zadejte jedno nebo více ID oddělených čárkami nebo pomocí operátoru rozsahu (..) zadejte rozsah ID. ID je celé číslo, které jednoznačně identifikuje relaci CIM v aktuální seanci PowerShell.
Další informace o operátoru rozsahu naleznete v tématu about_Operators.
Vlastnosti parametru
| Typ: | UInt32[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
SessionIdSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-InstanceId
Udává ID instance pro relaci CIM, kterou chcete odebrat. InstanceId je globálně jedinečný identifikátor (GUID), který jednoznačně identifikuje relaci CIM. Identifikátor instance je jedinečný, i když máte v PowerShellu spuštěných více relací.
InstanceId je uložen ve vlastnosti InstanceId objektu, který představuje relaci CIM.
Vlastnosti parametru
| Typ: | Guid[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InstanceIdSet
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje uživatelský název relace CIM, která se má odebrat. S tímto parametrem můžete použít zástupné znaky.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
NameSet
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
None
Do tohoto cmdletu nemůžete předávat objekty.
Výstupy
Object
Tento cmdlet vrátí objekt, který obsahuje informace o relaci CIM.
Poznámky
PowerShell obsahuje následující aliasy pro Remove-CimSession:
- Windows:
rcms
Tento cmdlet je dostupný pouze na platformách Windows.