Remove-CimSession
Entfernt mindestens eine CIM-Sitzung.
Syntax
CimSessionSet (Standard)
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>]
Beschreibung
Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.
Das Cmdlet Remove-CimSession entfernt ein oder mehrere CIM-Sitzungsobjekte aus der lokalen PowerShell-Sitzung.
Beispiele
Beispiel 1: Entfernen aller CIM-Sitzungen
In diesem Beispiel werden alle verfügbaren CIM-Sitzungen auf dem lokalen Computer mithilfe des Cmdlets Get-CimSession abgerufen und anschließend mithilfe der Remove-CimSessionentfernt.
Get-CimSession | Remove-CimSession
Beispiel 2: Entfernen einer bestimmten CIM-Sitzung
In diesem Beispiel wird die CIM-Sitzung entfernt, die einen ID- Wert von 5 aufweist.
Remove-CimSession -Id 5
Beispiel 3: Anzeigen der Liste der ZU entfernenden CIM-Sitzungen mithilfe des WhatIf-Parameters
In diesem Beispiel wird der allgemeine Parameter WhatIf verwendet, um anzugeben, dass die Entfernung nicht durchgeführt werden soll, sondern nur, was passiert, wenn dies geschehen würde.
Remove-CimSession -Name a* -WhatIf
Parameter
-CimSession
Gibt die Sitzungsobjekte der zu schließenden CIM-Sitzung an.
Geben Sie eine Variable ein, die die CIM-Sitzung enthält, oder einen Befehl, der die CIM-Sitzung erstellt oder abruft, z. B. die New-CimSession- oder Get-CimSession-Cmdlets.
Weitere Informationen finden Sie unter about_CimSessions.
Parametereigenschaften
| Typ: | |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
CimSessionSet
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ComputerName
Gibt ein Array von Namen von Computern an. Entfernt die Sitzungen, die eine Verbindung mit den angegebenen Computern herstellen. Sie können einen vollqualifizierten Domänennamen (FQDN) oder einen NetBIOS-Namen angeben.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
| Aliase: | China, Servername |
Parametersätze
ComputerNameSet
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Id
Gibt die ID der zu entfernenden CIM-Sitzung an. Geben Sie eine oder mehrere IDs an, die durch Kommas getrennt sind, oder verwenden Sie den Bereichsoperator (..), um einen Bereich von IDs anzugeben. Eine ID ist eine ganze Zahl, die die CIM-Sitzung in der aktuellen PowerShell-Sitzung eindeutig identifiziert.
Weitere Informationen über den Bereichsoperator finden Sie unter about_Operators.
Parametereigenschaften
| Typ: | UInt32[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
SessionIdSet
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-InstanceId
Gibt die Instanz-ID der zu entfernenden CIM-Sitzung an. InstanceId- ist ein GUID (Globally Unique Identifier), der eine CIM-Sitzung eindeutig identifiziert. Die InstanceId ist auch dann eindeutig, wenn mehrere Sitzungen in PowerShell ausgeführt werden.
Die InstanceId wird in der InstanceId-Eigenschaft des Objekts gespeichert, das eine CIM-Sitzung darstellt.
Parametereigenschaften
| Typ: | Guid[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InstanceIdSet
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den Anzeigenamen der CIM-Sitzung an, die entfernt werden soll. Sie können mit diesem Parameter Wildcardzeichen verwenden.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
NameSet
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
None
Dieses Cmdlet akzeptiert keine Eingabeobjekte.
Ausgaben
Object
Dieses Cmdlet gibt ein Objekt zurück, das CIM-Sitzungsinformationen enthält.