Remove-CimSession
Entfernt eine oder mehrere CIM-Sitzungen.
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
Das Cmdlet Remove-CimSession entfernt ein oder mehrere CIM-Sitzungsobjekte aus der lokalen PowerShell-Sitzung.
Beispiele
Beispiel 1: Entfernen aller CIM-Sitzungen
Get-CimSession | Remove-CimSession
Mit diesem Befehl werden alle verfügbaren CIM-Sitzungen auf dem lokalen Computer mithilfe des Cmdlets Get-CimSession abgerufen und dann mithilfe der Remove-CimSessionentfernt.
Beispiel 2: Entfernen einer bestimmten CIM-Sitzung
Remove-CimSession -Id 5
Mit diesem Befehl wird die CIM-Sitzung entfernt, die den ID-Wert 5 hat.
Beispiel 3: Anzeigen der Liste der ZU entfernenden CIM-Sitzungen mithilfe des WhatIf-Parameters
Remove-CimSession -Name a* -WhatIf
Dieser Befehl verwendet den allgemeinen Parameter WhatIf, um anzugeben, dass die Entfernung nicht ausgeführt werden soll, sondern nur ausgeben, was passiert, wenn dies geschehen würde.
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: | CimSession[] |
| 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 den Namen des Computers an, mit dem CIM-Sitzungen verbunden werden sollen. Platzhalterzeichen sind zulässig.
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. Es ist einfacher zu merken und einzugeben als InstanceId, aber es ist nur innerhalb der aktuellen PowerShell-Sitzung eindeutig.
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 eindeutig, auch 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.