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.

Type:CimSession[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 Do Standard namen (FQDN) oder einen NetBIOS-Namen angeben.

Type:String[]
Aliases:CN, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UInt32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt den Anzeigenamen der zu entfernenden CIM-Sitzung an. Mit diesem Parameter können Sie wild Karte Zeichen verwenden.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.