Freigeben über

Remove-CimSession

  • Referenz
Modul:
CimCmdlets

Entfernt mindestens eine CIM-Sitzung.

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>]

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das Remove-CimSession Cmdlet 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 des Remove-CimSessionCmdlets entfernt.

Get-CimSession | Remove-CimSession

Beispiel 2: Entfernen einer bestimmten CIM-Sitzung

In diesem Beispiel wird die CIM-Sitzung entfernt, die den ID-Wert 5 hat.

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 ausgeben, was passiert, wenn dies geschehen würde.

Remove-CimSession -Name a* -WhatIf

Parameter

-CimSession

Gibt die Sitzungsobjekte der CIM-Sitzungen an, die geschlossen werden sollen.

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.

Typ:CimSession[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:String[]
Aliase:CN, ServerName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 zum Bereichsoperator finden Sie unter about_Operators.

Typ:UInt32[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:Guid[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Anzeigenamen der zu entfernenden CIM-Sitzung an. Sie können mit diesem Parameter Wildcardzeichen verwenden.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

Object

Dieses Cmdlet gibt ein Objekt zurück, das CIM-Sitzungsinformationen enthält.

Hinweise

PowerShell enthält die folgenden Aliase für Remove-CimSession:

  • Windows:
    • rcms

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.