Get-PSSession

Ruft die Windows PowerShell-Sitzungen (PSSessions) in der aktuellen Sitzung ab.

Syntax

Get-PSSession [[-ComputerName] <string[]>] [<CommonParameters>]

Get-PSSession [-Id] <Int32[]> [<CommonParameters>]

Get-PSSession [-InstanceId <Guid[]>] [<CommonParameters>]

Get-PSSession [-Name <string[]>] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Get-PSSession" werden die Windows PowerShell-Sitzungen (PSSessions) abgerufen, die in der aktuellen Sitzung erstellt wurden.

Wenn keine Parameter angegeben werden, werden von Get-PSSession alle PSSessions abgerufen, die in der aktuellen Sitzung erstellt wurden. Mit den Parametern von Get-PSSession können Sie die Sitzungen für bestimmte Computer abrufen, oder Sie können Sitzungen anhand von Name, ID oder Instanz-ID identifizieren.

Weitere Informationen zu den Windows PowerShell-Sitzungen finden Sie unter "about_PSSessions".

Parameter

-ComputerName <string[]>

Ruft nur die PSSessions ab, die mit den angegebenen Computern verbunden sind. Platzhalter sind zulässig.

Geben Sie den NetBIOS-Namen, eine IP-Adresse oder den vollqualifizierten Domänennamen eines oder mehrerer Computer ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen, "localhost" oder einen Punkt (.) ein.

-Id <Int32[]>

Ruft nur die PSSessions mit den angegebenen Instanz-IDs ab. Geben Sie eine oder mehrere IDs (durch Kommas getrennt) ein, oder geben Sie einen ID-Bereich mit dem Bereichsoperator (..) an.

Eine ID ist eine ganze Zahl, die die PSSession in der aktuellen Sitzung eindeutig identifiziert. Sie lässt sich leichter merken und eingeben als die InstanceId, ist jedoch nur in der aktuellen Sitzung eindeutig. Um die ID einer PSSession zu suchen, geben Sie Get-PSSession ohne Parameter ein.

-InstanceId <Guid[]>

Ruft nur die PSSessions mit den angegebenen Instanz-IDs ab.

Die Instanz-ID ist eine GUID, mit der eine PSSession auf dem lokalen Computer oder auf dem Remotecomputer eindeutig identifiziert wird. Die InstanceID ist auch dann eindeutig, wenn mehrere Sitzungen in Windows PowerShell ausgeführt werden.

Die InstanceID wird in der InstanceID-Eigenschaft des Objekts gespeichert, das eine PSSession darstellt. Geben Sie "get-pssession | Format-Table Name, ComputerName, InstanceId" ein, um die InstanceID der PSSessions in der aktuellen Sitzung zu suchen.

-Name <string[]>

Ruft nur die PSSessions mit den angegebenen Anzeigenamen ab. Platzhalter sind zulässig.

Geben Sie get-pssession ohne Parameter ein, um die Namen der PSSessions in der aktuellen Sitzung zu suchen.

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Hinweise

Mit Get-PSSession werden die PSSessions abgerufen, die in der aktuellen Sitzung erstellt wurden. Die Sitzung, die beim Öffnen von Windows PowerShell erstellt wird, und die PSSessions, die in anderen Sitzungen oder auf anderen Computern erstellt wurden, werden nicht abgerufen. Dies gilt auch, wenn eine Verbindung mit dem lokalen Computer hergestellt wird.

Beispiel 1

C:\PS>get-pssession

Beschreibung
-----------
Mit diesem Befehl werden alle PSSessions abgerufen, die in der aktuellen Sitzung erstellt wurden. 

PSSessions, die in anderen Sitzungen oder auf anderen Computern erstellt wurden, werden nicht abgerufen. Dies gilt auch, wenn eine Verbindung mit dem lokalen Computer hergestellt wird.

Beispiel 2

C:\PS>$s = get-pssession -computername Server02

Beschreibung
-----------
Mit diesem Befehl werden die PSSessions abgerufen, die mit dem Computer "Server02" verbunden sind, und in der Variablen "$p" gespeichert.

Beispiel 3

C:\PS>new-pssession -computername Server01, Server02, Server03

C:\PS> $s1, $s2, $s3 = get-pssession

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie die Ergebnisse eines Get-PSSession-Befehls in mehreren Variablen gespeichert werden. 

Im ersten Befehl werden mit dem Cmdlet "New-PSSession" PSSessions auf drei Remotecomputern erstellt.

Im zweiten Befehl werden die drei Sitzungen mit dem Cmdlet "Get-PSSession" abgerufen. Anschließend wird jede PSSession in einer separaten Variablen gespeichert.

Wenn ein Array von Variablen von Windows PowerShell einem Array von Objekten zugewiesen wird, wird das erste Objekt der ersten Variablen zugewiesen, das zweite Objekt der zweiten Variablen usw. Wenn mehr Objekte als Variablen vorhanden sind, werden alle verbleibenden Objekte der letzten Variablen im Array zugewiesen. Wenn mehr Variablen als Objekte vorhanden sind, werden die zusätzlichen Variablen nicht verwendet.

Beispiel 4

C:\PS>get-pssession | format-table -property computername, InstanceID

C:\PS> $s = get-pssession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f

C:\PS> remove-pssession -session $s

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie eine PSSession anhand der Instanz-ID abgerufen wird, und wie die PSSession anschließend gelöscht wird.

Mit dem ersten Befehl werden alle PSSessions auf dem lokalen Computer abgerufen. Die PSSessions werden an das Cmdlet "Format-Table" gesendet, das die ComputerName-Eigenschaft und die InstanzID-Eigenschaft für die jeweilige PSSession anzeigt.

Im zweiten Befehl wird mit dem Cmdlet "Get-PSSession" eine bestimmte PSSession abgerufen und in der Variablen "$s" gespeichert. Die PSSession wird vom Befehl anhand des InstanceID-Parameters identifiziert.

Der dritte Befehl verwendet das Cmdlet "Remove-PSSession", um die PSSession in der Variablen "$s" zu löschen.

Beispiel 5

C:\PS>get-pssession -computername Serv*

Beschreibung
-----------
Mit diesem Befehl werden alle PSSessions abgerufen, für die eine Verbindung mit einem Computer besteht, dessen Name mit "Serv" beginnt.

Beispiel 6

C:\PS>get-pssession -name Test*, Ux*

Beschreibung
-----------
Mit diesem Befehl werden PSSessions abgerufen, deren Name mit "Test" oder "Ux" beginnt.

Beispiel 7

C:\PS>get-pssession 2

Beschreibung
-----------
Mit diesem Befehl wird die PSSession mit der ID 2 abgerufen.

Siehe auch

Konzepte

about_PSSessions
about_remote
New-PSSession
Remove-PSSession
Enter-PSSession
Exit-PSSession
Invoke-Command