Freigeben über

Remove-PSSession

  • Referenz
Modul:
Microsoft.PowerShell.Core

Schließt mindestens eine PowerShell-Sitzung (PSSessions).

Syntax

Remove-PSSession
      [-Id] <Int32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSSession
      [-Session] <PSSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSSession
      -ContainerId <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSSession
      -VMId <Guid[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSSession
      -VMName <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSSession
      -InstanceId <Guid[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSSession
      -Name <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSSession
      [-ComputerName] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Remove-PSSession Cmdlet schließt PowerShell-Sitzungen (PSSessions) in der aktuellen Sitzung. Sie stoppt alle Befehle, die in den PSSessions ausgeführt werden, beendet die PSSession und gibt die Ressourcen frei, die von der PSSession verwendet wurden. Wenn die PSSession mit einem Remotecomputer verbunden ist, schließt dieses Cmdlet auch die Verbindung zwischen den lokalen und Remotecomputern.

Um eine PSSession zu entfernen, geben Sie den Namen, computerName, die ID oder die InstanceID der Sitzung ein.

Wenn Sie die PSSession in einer Variablen gespeichert haben, bleibt das Sitzungsobjekt in der Variablen, aber der Zustand der PSSession ist geschlossen.

Beispiele

Beispiel 1: Entfernen von Sitzungen nach ID

Remove-PSSession -Id 1, 2

Mit diesem Befehl werden die PSSessions entfernt, die IDs 1 und 2.

Beispiel 2: Entfernen aller Sitzungen in der aktuellen Sitzung

Get-PSSession | Remove-PSSession
Remove-PSSession -Session (Get-PSSession)
$s = Get-PSSession
Remove-PSSession -Session $s

Diese Befehle entfernen alle PSSessions in der aktuellen Sitzung. Obwohl die drei Befehlsformate anders aussehen, haben sie die gleiche Wirkung.

Beispiel 3: Sitzungen nach Namen schließen

$r = Get-PSSession -ComputerName Serv*
$r | Remove-PSSession

Diese Befehle schließen die PSSessions, die mit Computern verbunden sind, die Namen enthalten, die mit Serv.

Beispiel 4: Schließen von Sitzungen, die mit einem Port verbunden sind

Get-PSSession | where {$_.port -eq 90} | Remove-PSSession

Dieser Befehl schließt die PSSessions, die mit Port 90 verbunden sind. Sie können dieses Befehlsformat verwenden, um PSSessions nach anderen Eigenschaften als ComputerName, Name, InstanceID und ID zu identifizieren.

Beispiel 5: Schließen einer Sitzung nach Instanz-ID

Get-PSSession | Format-Table ComputerName, InstanceID  -AutoSize

ComputerName InstanceId
------------ ----------------
Server01     875d231b-2788-4f36-9f67-2e50d63bb82a
localhost    c065ffa0-02c4-406e-84a3-dacb0d677868
Server02     4699cdbc-61d5-4e0d-b916-84f82ebede1f
Server03     4e5a3245-4c63-43e4-88d0-a7798bfc2414
TX-TEST-01   fc4e9dfa-f246-452d-9fa3-1adbdd64ae85

Remove-PSSession -InstanceID fc4e9dfa-f246-452d-9fa3-1adbdd64ae85

Diese Befehle zeigen, wie Sie eine PSSession basierend auf ihrer Instanz-ID oder RemoteRunspaceID schließen.

Der erste Befehl verwendet das Get-PSSession Cmdlet, um die PSSessions in der aktuellen Sitzung abzurufen. Es verwendet einen Pipelineoperator (|), um die PSSessions an das Format-Table Cmdlet zu senden, das ihre ComputerName - und InstanceID-Eigenschaften in einer Tabelle formatiert. Der Parameter "AutoSize " komprimiert die Spalten für die Anzeige.

Aus der resultierenden Anzeige können Sie die zu schließende PSSession identifizieren und die InstanceID dieser PSSession in den zweiten Befehl kopieren und einfügen.

Der zweite Befehl verwendet das Remove-PSSession Cmdlet, um die PSSession mit der angegebenen Instanz-ID zu entfernen.

Beispiel 6: Erstellen einer Funktion, die alle Sitzungen in der aktuellen Sitzung löscht

Function EndPSS { Get-PSSession | Remove-PSSession }

Diese Funktion schließt jede PSSession in der aktuellen Sitzung. Nachdem Sie diese Funktion zu Ihrem PowerShell-Profil hinzugefügt haben, geben Sie zum Löschen aller Sitzungen folgendes ein EndPSS.

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. Dieses Cmdlet schließt die PSSessions , die mit den angegebenen Computern verbunden sind. Platzhalterzeichen sind zulässig.

Geben Sie den NetBIOS-Namen, eine IP-Adresse oder den vollqualifizierten Domänennamen mindestens eines Computers ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen oder localhosteinen Punkt (.) ein.

Typ:String[]
Aliase:Cn
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

-ContainerId

Gibt ein Array von IDs von Containern an. Mit diesem Cmdlet werden Sitzungen für jeden der angegebenen Container entfernt. Verwenden Sie den docker ps Befehl, um eine Liste der Container-IDs abzurufen. Weitere Informationen finden Sie in der Hilfe zum Docker ps-Befehl .

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

-Id

Gibt ein Array von IDs von Sitzungen an. Dieses Cmdlet schließt die PSSessions mit den angegebenen IDs. Geben Sie eine oder mehrere IDs ein, getrennt durch Kommas, oder verwenden Sie den Bereichsoperator (..), um einen Bereich von IDs anzugeben.

Eine ID ist eine ganze Zahl, die die PSSession in der aktuellen Sitzung eindeutig identifiziert. Es ist einfacher zu merken und einzugeben als die InstanceId, aber sie ist nur in der aktuellen Sitzung eindeutig. Um die ID einer PSSession zu finden, führen Sie das Get-PSSession Cmdlet ohne Parameter aus.

Typ:Int32[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-InstanceId

Gibt ein Array von Instanz-IDs an. Dieses Cmdlet schließt die PSSessions mit den angegebenen Instanz-IDs.

Die Instanz-ID ist eine GUID, die eine PSSession in der aktuellen Sitzung eindeutig identifiziert. Die Instanz-ID ist eindeutig, auch wenn mehrere Sitzungen auf einem einzelnen Computer ausgeführt werden.

Die Instanz-ID wird in der InstanceID-Eigenschaft des Objekts gespeichert, das eine PSSession darstellt. Geben Sie ein, Get-PSSession | Format-Table Name, ComputerName, InstanceIdum die InstanceID der PSSessions in der aktuellen Sitzung zu finden.

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

-Name

Gibt ein Array von Anzeigenamen von Sitzungen an. Dieses Cmdlet schließt die PSSessions mit den angegebenen Anzeigenamen. Platzhalterzeichen sind zulässig.

Da der Anzeigename einer PSSession möglicherweise nicht eindeutig ist, sollten Sie bei Verwendung des Namensparameters auch den Parameter WhatIf oder Confirm im Remove-PSSession Befehl verwenden.

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

-Session

Gibt die Sitzungsobjekte der zu schließenden PSSessions an. Geben Sie eine Variable ein, die die PSSessions oder einen Befehl enthält, der die PSSessions erstellt oder abruft, z. B. einen New-PSSession oder Get-PSSession einen Befehl. Sie können auch ein oder mehrere Sitzungsobjekte an Remove-PSSession.

Typ:PSSession[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMId

Gibt ein Array der ID von virtuellen Computern an. Dieses Cmdlet startet eine interaktive Sitzung mit jedem der angegebenen virtuellen Computer. Verwenden Sie den folgenden Befehl, um die virtuellen Computer anzuzeigen, die Ihnen zur Verfügung stehen:

Get-VM | Select-Object -Property Name, ID

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

-VMName

Gibt ein Array von Namen von virtuellen Computern an. Dieses Cmdlet startet eine interaktive Sitzung mit jedem der angegebenen virtuellen Computer. Verwenden Sie das Get-VM Cmdlet, um die virtuellen Computer anzuzeigen, die Ihnen zur Verfügung stehen.

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

-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

PSSession

Sie können ein Sitzungsobjekt an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

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

  • Alle Plattformen:

    • rsn

  • Der Id-Parameter ist obligatorisch. Um alle PSSessions in der aktuellen Sitzung zu löschen, geben Sie Get-PSSession | Remove-PSSession.

  • Eine PSSession verwendet eine dauerhafte Verbindung mit einem Remotecomputer. Erstellen Sie eine PSSession , um eine Reihe von Befehlen auszuführen, die Daten freigeben. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_PSSessions.

  • PSSessions sind spezifisch für die aktuelle Sitzung. Wenn Sie eine Sitzung beenden, werden die psSessions , die Sie in dieser Sitzung erstellt haben, forcibly geschlossen.