Freigeben über

Remove-CimSession

Modul:
CimCmdlets Module

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:

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

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:

  • Fenster:
    • rcms

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