Get-PSSession
Ruft die Windows PowerShell-Sitzungen auf lokalen und Remotecomputern ab.
Syntax
Name (Standard)
Get-PSSession
[-Name <String[]>]
[<CommonParameters>]
ComputerName
Get-PSSession
[-ComputerName] <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ComputerInstanceId
Get-PSSession
[-ComputerName] <String[]>
-InstanceId <Guid[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ConnectionUri
Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ConnectionUriInstanceId
Get-PSSession
[-ConnectionUri] <Uri[]>
-InstanceId <Guid[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
InstanceId
Get-PSSession
[-InstanceId <Guid[]>]
[<CommonParameters>]
Id
Get-PSSession
[-Id] <Int32[]>
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-PSSession ruft die benutzerverwalteten Windows PowerShell-Sitzungen ("PSSessions") auf lokalen und Remotecomputern ab.
Ab Windows PowerShell 3.0 werden Sitzungen auf den Computern am Remoteende jeder Verbindung gespeichert. Sie können die Parameter ComputerName oder ConnectionUri von Get-PSSession- verwenden, um die Sitzungen abzurufen, die eine Verbindung mit dem lokalen Computer oder Remotecomputer herstellen, auch wenn sie nicht in der aktuellen Sitzung erstellt wurden.
Ohne Parameter ruft Get-PSSession alle Sitzungen ab, die in der aktuellen Sitzung erstellt wurden.
Verwenden Sie die Filterparameter, einschließlich Name, ID, InstanceID, State, ApplicationNameund ConfigurationName aus den Sitzungen auszuwählen, die Get-PSSession zurückgeben.
Verwenden Sie die verbleibenden Parameter, um die temporäre Verbindung zu konfigurieren, in der der befehl Get-PSSession ausgeführt wird, wenn Sie die Parameter ComputerName oder ConnectionUri verwenden.
HINWEIS: In Windows PowerShell 2.0 ohne Parameter ruft Get-PSSession alle Sitzungen ab, die in der aktuellen Sitzung erstellt wurden. Der ComputerName Parameter ruft Sitzungen ab, die in der aktuellen Sitzung erstellt wurden, und stellt eine Verbindung mit dem angegebenen Computer her.
Weitere Informationen zu Windows PowerShell-Sitzungen finden Sie unter about_PSSessions.
Beispiele
Beispiel 1
PS> Get-PSSession
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, auch wenn sie eine Verbindung mit diesem Computer herstellen.
Beispiel 2
PS> Get-PSSession -ComputerName localhost
Mit diesem Befehl werden die PSSessions abgerufen, die mit dem lokalen Computer verbunden sind. Um den lokalen Computer anzugeben, geben Sie den Computernamen "localhost" oder einen Punkt (.) ein.
Der Befehl gibt alle Sitzungen auf dem lokalen Computer zurück, auch wenn sie in verschiedenen Sitzungen oder auf verschiedenen Computern erstellt wurden.
Beispiel 3
PS> Get-PSSession -ComputerName Server02
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
2 Session3 Server02 Disconnected ITTasks Busy
1 ScheduledJobs Server02 Opened Microsoft.PowerShell Available
3 Test Server02 Disconnected Microsoft.PowerShell Busy
Mit diesem Befehl werden die PSSessions abgerufen, die mit dem Computer Server02 verbunden sind.
Der Befehl gibt alle Sitzungen auf Server02 zurück, auch wenn sie in verschiedenen Sitzungen oder auf verschiedenen Computern erstellt wurden.
Die Ausgabe zeigt, dass zwei der Sitzungen einen getrennten Zustand und eine Beschäftigt-Verfügbarkeit aufweisen. Sie wurden in verschiedenen Sitzungen erstellt und werden zurzeit verwendet. Das Programm "ScheduledJobs" (Geöffnet und Verfügbar) wurde im aktuellen Programm erstellt.
Beispiel 4
PS> New-PSSession -ComputerName Server01, Server02, Server03
PS> $s1, $s2, $s3 = Get-PSSession
In diesem Beispiel wird gezeigt, wie die Ergebnisse eines Get-PSSession Befehls in mehreren Variablen gespeichert werden.
Im ersten Befehl wird das Cmdlet New-PSSession verwendet, um PSSessions auf drei Remotecomputern zu erstellen.
Im zweiten Befehl wird ein Get-PSSession-Cmdlet verwendet, um die drei PSSessions abzurufen. Anschließend wird jede der PSSessions in einer separaten Variablen gespeichert.
Wenn Windows PowerShell einem Array von Variablen ein Array von Objekten zuweist, wird das erste Objekt der ersten Variablen zugewiesen, das zweite Objekt der zweiten Variablen usw. Wenn mehr Objekte als Variablen vorhanden sind, weist sie der letzten Variablen im Array alle verbleibenden Objekte zu. Wenn mehr Variablen als Objekte vorhanden sind, werden die zusätzlichen Variablen nicht verwendet.
Beispiel 5
PS> Get-PSSession | Format-Table -Property ComputerName, InstanceID
PS> $s = Get-PSSession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f
PS> Remove-PSSession -Session $s
In diesem Beispiel wird gezeigt, wie Sie eine PSSession mithilfe ihrer Instanz-ID abrufen und dann die PSSession löschen.
Mit dem ersten Befehl werden alle PSSessions abgerufen, die in der aktuellen Sitzung erstellt wurden. Es sendet die PSSessions an das Cmdlet Format-Table, das die ComputerName- und InstanceID-Eigenschaften der einzelnen PSSessions anzeigt.
Im zweiten Befehl wird das Cmdlet Get-PSSession verwendet, um eine bestimmte PSSession abzurufen und in der Variablen $s zu speichern. Der Befehl verwendet den Parameter InstanceID, um die PSSession zu identifizieren.
Der dritte Befehl verwendet das Cmdlet Remove-PSSession, um die PSSession in der Variablen $s zu löschen.
Beispiel 6
The first command gets sessions on the Server02 and Server12 remote computers that have names that begin with "BackupJob" and use the ITTasks session configuration.The command uses the **Name** parameter to specify the name pattern and the **ConfigurationName** parameter to specify the session configuration. The value of the **SessionOption** parameter is a hash table that sets the value of the **OperationTimeout** to 240000 milliseconds (4 minutes). This setting gives the command more time to complete.The **ConfigurationName** and **SessionOption** parameters are used to configure the temporary sessions in which the **Get-PSSession** cmdlet runs on each computer.The output shows that the command returns the BackupJob04 session. The session is disconnected and the Availability is None, which indicates that it is not in use.
PS> Get-PSSession -ComputerName Server02, Server12 -Name BackupJob* -ConfigurationName ITTasks -SessionOption @{OperationTimeout=240000}
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
3 BackupJob04 Server02 Disconnected ITTasks None
The second command uses the **Get-PSSession** cmdlet to get to the BackupJob04 session and the Connect-PSSession cmdlet to connect to the session. The command saves the session in the $s variable.
PS> $s = Get-PSSession -ComputerName Server02 -Name BackupJob04 -ConfigurationName ITTasks | Connect-PSSession
The third command gets the session in the $s variable. The output shows that the **Connect-PSSession** command was successful. The session is in the **Opened** state and is available for use.
PS> $s
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
5 BackupJob04 Server02 Opened ITTasks Available
Die Befehle in diesem Beispiel finden eine Sitzung mit einem bestimmten Namensformat und verwenden eine bestimmte Sitzungskonfiguration und stellen dann eine Verbindung mit der Sitzung her. Sie können einen Befehl wie diesen verwenden, um eine Sitzung zu finden, in der ein Kollege eine Aufgabe gestartet und eine Verbindung herstellt, um die Aufgabe abzuschließen.
Beispiel 7
PS> Get-PSSession -ID 2
Mit diesem Befehl wird die PSSession mit der ID 2 abgerufen. Da der Wert der ID-Eigenschaft nur in der aktuellen Sitzung eindeutig ist, ist der ID-Parameter nur für lokale Befehle gültig.
Parameter
-AllowRedirection
Ermöglicht die Umleitung dieser Verbindung zu einem alternativen URI (Uniform Resource Identifier). Standardmäßig werden Verbindungen von Windows PowerShell nicht umgeleitet.
Dieser Parameter konfiguriert die temporäre Verbindung, die erstellt wird, um einen Get-PSSession Befehl mit dem parameter ConnectionUri auszuführen.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ConnectionUri
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUriInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ApplicationName
Stellt nur eine Verbindung zu Sitzungen her, die die angegebene Anwendung verwenden.
Geben Sie das Anwendungsnamensegment des Verbindungs-URI ein.
Beispielsweise lautet der Anwendungsname im folgenden Verbindungs-URI WSMan: https://localhost:5985/WSMAN.
Der Anwendungsname einer Sitzung wird in der Runspace.ConnectionInfo.AppName Eigenschaft der Sitzung gespeichert.
Der Wert dieses Parameters wird zum Auswählen und Filtern von Sitzungen verwendet. Die Anwendung, die von der Sitzung verwendet wird, wird nicht geändert.
Parametereigenschaften
| Typ: | String |
| Standardwert: | All sessions |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerName
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
ComputerInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Authentication
Gibt den Mechanismus an, der zum Authentifizieren von Anmeldeinformationen für die Sitzung verwendet wird, in der der befehl Get-PSSession ausgeführt wird.
Dieser Parameter konfiguriert die temporäre Verbindung, die erstellt wird, um einen Get-PSSession--Befehl mit dem Parameter ComputerName oder ConnectionUri auszuführen.
Gültige Werte sind Default, Basic, Credssp, Digest, Kerberos, Negotiate und NegotiateWithImplicitCredential. Der Standardwert ist Default.
Weitere Informationen zu den Werten dieses Parameters finden Sie unter AuthenticationMechanism Enumeration in der MSDN Library.
ACHTUNG: Die Authentifizierung des Credential Security Support Provider (CredSSP), bei der die Anmeldeinformationen des Benutzers an einen Remotecomputer übergeben werden, der authentifiziert werden soll, ist für Befehle vorgesehen, die eine Authentifizierung für mehrere Ressourcen erfordern, z. B. den Zugriff auf eine Remotenetzwerkfreigabe. Dieser Mechanismus erhöht das Sicherheitsrisiko des Remotevorgangs. Wenn der Remotecomputer kompromittiert ist, können die an ihn übergebenen Anmeldeinformationen zum Steuern der Netzwerksitzung verwendet werden.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | AuthenticationMechanism |
| Standardwert: | Default |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerName
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ComputerInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUri
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUriInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CertificateThumbprint
Gibt das zertifikat für den digitalen öffentlichen Schlüssel (X509) eines Benutzerkontos an, das über die Berechtigung zum Erstellen der Sitzung verfügt, in der der befehl Get-PSSession ausgeführt wird. Geben Sie den Zertifikatfingerabdruck des Zertifikats ein.
Dieser Parameter konfiguriert die temporäre Verbindung, die erstellt wird, um einen Get-PSSession--Befehl mit dem Parameter ComputerName oder ConnectionUri auszuführen.
Zertifikate werden in der zertifikatbasierten Clientauthentifizierung verwendet. Sie können nur lokalen Benutzerkonten zugeordnet werden; sie funktionieren nicht mit Domänenkonten.
Verwenden Sie zum Abrufen eines Zertifikatfingerabdrucks den Befehl Get-Item oder Get-ChildItem auf dem Windows PowerShell-Laufwerk Zertifikat:.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerName
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ComputerInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUri
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUriInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ComputerName
Ruft die Sitzungen ab, die eine Verbindung mit den angegebenen Computern herstellen. Platzhalter sind nicht zulässig. Es gibt keinen Standardwert.
Ab Windows PowerShell 3.0 werden PSSessions auf den Computern am Remoteende jeder Verbindung gespeichert. Zum Abrufen der Sitzungen auf den angegebenen Computern erstellt Windows PowerShell eine temporäre Verbindung mit jedem Computer und führt den Befehl Get-PSSession aus.
Geben Sie den NetBIOS-Namen, eine IP-Adresse oder einen vollqualifizierten Domänennamen eines oder mehrerer Computer ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen "localhost" oder einen Punkt (.) ein.
Hinweis: Mit diesem Parameter werden Sitzungen nur von Computern abgerufen, auf denen Windows PowerShell 3.0 oder höher ausgeführt wird. In früheren Versionen werden keine Sitzungen gespeichert.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Cn |
Parametersätze
ComputerName
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
ComputerInstanceId
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ConfigurationName
Ruft nur Sitzungen ab, die die angegebene Sitzungskonfiguration verwenden.
Geben Sie einen Konfigurationsnamen oder den vollqualifizierten Ressourcen-URI für eine Sitzungskonfiguration ein.
Wenn Sie nur den Konfigurationsnamen angeben, wird der folgende Schema-URI vorangestellt: https://schemas.microsoft.com/powershell.
Der Konfigurationsname einer Sitzung wird in der ConfigurationName Eigenschaft der Sitzung gespeichert.
Der Wert dieses Parameters wird zum Auswählen und Filtern von Sitzungen verwendet. Die Sitzungskonfiguration, die von der Sitzung verwendet wird, wird nicht geändert.
Weitere Informationen zu Sitzungskonfigurationen finden Sie unter about_Session_Configurations.
Parametereigenschaften
| Typ: | String |
| Standardwert: | All sessions |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerName
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
ComputerInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUri
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUriInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ConnectionUri
Gibt einen URI (Uniform Resource Identifier) an, der den Verbindungsendpunkt für die temporäre Sitzung definiert, in der der Befehl Get-PSSession ausgeführt wird. Der URI muss vollständig qualifiziert sein.
Dieser Parameter konfiguriert die temporäre Verbindung, die erstellt wird, um einen Get-PSSession Befehl mit dem parameter ConnectionUri auszuführen.
Das Format dieser Zeichenfolge lautet:
<Transport>://<ComputerName>:<Port>/<ApplicationName>Der Standardwert ist https://localhost:5985/WSMAN.
Wenn Sie keinen ConnectionUri angeben, können Sie die Parameter UseSSL,ComputerName, Port und ApplicationName verwenden, um die ConnectionURI-Werte anzugeben. Gültige Werte für das Transportsegment des URI sind HTTP und HTTPS. Wenn Sie einen Verbindungs-URI mit einem Transportsegment angeben, aber keinen Port angeben, wird die Sitzung mit Standardsports erstellt: 80 für HTTP und 443 für HTTPS. Um die Standardports für Windows PowerShell-Remoting zu verwenden, geben Sie Port 5985 für HTTP oder 5986 für HTTPS an.
Wenn der Zielcomputer die Verbindung an einen anderen URI umleitet, verhindert Windows PowerShell die Umleitung, es sei denn, Sie verwenden den Parameter AllowRedirection im Befehl.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Hinweis: Mit diesem Parameter werden Sitzungen nur von Computern abgerufen, auf denen Windows PowerShell 3.0 oder höher ausgeführt wird. In früheren Versionen werden keine Sitzungen gespeichert.
Parametereigenschaften
| Typ: | Uri[] |
| Standardwert: | https://localhost:5985/WSMAN |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | URI (Uniform Resource Identifier), CU |
Parametersätze
ConnectionUri
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUriInstanceId
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Führt den Befehl mit den Berechtigungen des angegebenen Benutzers aus. Geben Sie ein Benutzerkonto an, das über die Berechtigung zum Herstellen einer Verbindung mit dem Remotecomputer verfügt, und führen Sie einen Get-PSSession Befehl aus. Die Standardeinstellung ist der aktuelle Benutzer. Geben Sie einen Benutzernamen ein, z. B. "User01", "Domain01\User01" oder "User@Domain.com", oder geben Sie ein PSCredential-Objekt ein, z. B. ein Objekt, das vom Cmdlet Get-Credential zurückgegeben wird. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.
Dieser Parameter konfiguriert die temporäre Verbindung, die erstellt wird, um einen Get-PSSession- Befehl mit dem parameter ComputerName oder ConnectionUri auszuführen.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | Current user |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerName
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ComputerInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUri
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUriInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Id
Ruft nur die Sitzungen mit den angegebenen IDs ab. Geben Sie eine oder mehrere IDs ein (durch Kommas getrennt), oder verwenden Sie den Bereichsoperator (..), um einen ID-Bereich anzugeben. Sie können den ID-Parameter nicht mit dem ComputerName-Parameter verwenden.
Eine ID ist eine ganze Zahl, die die benutzerverwalteten Sitzungen (PSSessions) in der aktuellen Sitzung eindeutig identifiziert. Sie ist einfacher zu merken und einzugeben als die InstanceId, aber sie ist nur innerhalb der aktuellen Sitzung eindeutig. Die ID einer Sitzung wird in der ID-Eigenschaft der Sitzung gespeichert.
Parametereigenschaften
| Typ: | Int32[] |
| Standardwert: | All sessions |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Id
| Position: | 1 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-InstanceId
Ruft nur die Sitzungen mit den angegebenen Instanz-IDs ab.
Die Instanz-ID ist eine GUID, die eine Sitzung auf einem lokalen oder Remotecomputer eindeutig identifiziert. Die InstanceID ist eindeutig, auch wenn mehrere Sitzungen in Windows PowerShell ausgeführt werden.
Die Instanz-ID einer Sitzung wird in der InstanceID Eigenschaft der Sitzung gespeichert.
Parametereigenschaften
| Typ: | Guid[] |
| Standardwert: | All sessions |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerInstanceId
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUriInstanceId
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
InstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Ruft nur die Sitzungen mit den angegebenen Anzeigenamen ab. Wildcards sind zulässig.
Der Anzeigename einer Sitzung wird in der eigenschaft Name Sitzung gespeichert.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | All sessions |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Name
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
ComputerName
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUri
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Port
Gibt den angegebenen Netzwerkport an, der für die temporäre Verbindung verwendet wird, in der der befehl Get-PSSession ausgeführt wird. Zum Herstellen einer Verbindung mit einem Remotecomputer muss der Remotecomputer den für die Verbindung verwendeten Port abhören. Die Standardports sind 5985 (der WinRM-Port für HTTP) und 5986 (der WinRM-Port für HTTPS).
Bevor Sie einen alternativen Port verwenden, müssen Sie den WinRM-Listener auf dem Remotecomputer so konfigurieren, dass er an diesem Port lauscht. Geben Sie zum Konfigurieren des Listeners die folgenden beiden Befehle an der Windows PowerShell-Eingabeaufforderung ein:
Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse
New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port <Portnummer>
Dieser Parameter konfiguriert die temporäre Verbindung, die erstellt wird, um einen Get-PSSession- Befehl mit dem parameter ComputerName oder ConnectionUri auszuführen.
Verwenden Sie nicht den Parameter Port, es sei denn, Sie müssen. Der im Befehl festgelegte Port gilt für alle Computer oder Sitzungen, auf denen der Befehl ausgeführt wird. Eine alternative Porteinstellung kann verhindern, dass der Befehl auf allen Computern ausgeführt wird. Verwendet den angegebenen Port zum Ausführen des Befehls Get-PSSession .
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | 5985, 5986 |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerName
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ComputerInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SessionOption
Legt erweiterte Optionen für die Sitzung fest. Geben Sie ein SessionOption--Objekt ein, z. B. ein Objekt, das Sie mithilfe des Cmdlets New-PSSessionOption erstellen, oder eine Hashtabelle, in der es sich bei den Schlüsseln um Sitzungsoptionsnamen und die Werte um Sitzungsoptionswerte handelt.
Die Standardwerte für die Optionen werden durch den Wert der $PSSessionOption Einstellungsvariablen bestimmt, sofern diese gesetzt ist. Andernfalls werden die Standardwerte durch Optionen festgelegt, die in der Sitzungskonfiguration festgelegt sind.
Die Werte der Sitzungsoptionen haben Vorrang vor den Standardwerten für Sitzungen, die in der Einstellungsvariablen $PSSessionOption und in der Sitzungskonfiguration festgelegt sind. Sie haben jedoch keine Vorrang vor maximalen Werten, Kontingenten oder Grenzwerten, die in der Sitzungskonfiguration festgelegt sind.
Eine Beschreibung der Sitzungsoptionen, einschließlich der Standardwerte, finden Sie unter New-PSSessionOption. Informationen zur Einstellungsvariable $PSSessionOption finden Sie unter about_Preference_Variables. Weitere Informationen zu Sitzungskonfigurationen finden Sie unter about_Session_Configurations.
Parametereigenschaften
| Typ: | PSSessionOption |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerName
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ComputerInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUri
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUriInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-State
Ruft nur Sitzungen im angegebenen Zustand ab. Gültige Werte sind: Alle, Geöffnet, Getrennt, Geschlossen und Defekt. Der Standardwert lautet "All".
Der Sitzungsstatuswert ist relativ zu den aktuellen Sitzungen. Sitzungen, die nicht in den aktuellen Sitzungen erstellt wurden und nicht mit der aktuellen Sitzung verbunden sind, haben den Status Getrennt , auch wenn sie mit einer anderen Sitzung verbunden sind.
Der Status einer Sitzung wird in der eigenschaft State der Sitzung gespeichert.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | SessionFilterState |
| Standardwert: | All |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerName
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ComputerInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUri
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUriInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ThrottleLimit
Gibt die maximale Anzahl gleichzeitiger Verbindungen an, die zum Ausführen des befehls Get-PSSession eingerichtet werden können. Wenn Sie diesen Parameter weglassen oder einen Wert von 0 (Null) eingeben, wird der Standardwert 32 verwendet. Der Drosselungsgrenzwert gilt nur für den aktuellen Befehl, nicht für die Sitzung oder den Computer.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | 32 |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerName
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ComputerInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUri
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ConnectionUriInstanceId
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UseSSL
Verwendet das SSL-Protokoll (Secure Sockets Layer), um die Verbindung herzustellen, in der der Befehl Get-PSSession ausgeführt wird. Standardmäßig wird SSL nicht verwendet. Wenn Sie diesen Parameter verwenden, ABER SSL für den für den Befehl verwendeten Port nicht verfügbar ist, schlägt der Befehl fehl.
Dieser Parameter konfiguriert die temporäre Verbindung, die erstellt wird, um einen Get-PSSession Befehl mit dem Parameter ComputerName auszuführen.
Dieser Parameter wird in Windows PowerShell 3.0 eingeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerName
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
ComputerInstanceId
| 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
Eingaben können nicht an dieses Cmdlet weitergereicht werden.
Ausgaben
PSSession
Hinweise
Get-PSSession ruft benutzerverwaltete Sitzungen "PSSessions" ab, z. B. solche, die mit den Cmdlets New-PSSession, Enter-PSSession und Invoke-Command erstellt werden. Die vom System verwaltete Sitzung, die beim Starten von Windows PowerShell erstellt wird, wird nicht abgerufen.
Ab Windows PowerShell 3.0 werden PSSessions auf dem Computer gespeichert, der sich am "serverseitigen" oder empfangenden Ende einer Verbindung befindet. Zum Abrufen der Sitzungen, die auf dem lokalen Computer oder einem Remotecomputer gespeichert sind, richtet Windows PowerShell eine temporäre Sitzung für den angegebenen Computer ein und führt Abfragebefehle in der Sitzung aus.
Um Sitzungen abzurufen, die eine Verbindung mit einem Remotecomputer herstellen, verwenden Sie die parameter ComputerName oder ConnectionUri parameter, um den Remotecomputer anzugeben. Um die Sitzungen zu filtern, die Get-PSSession abrufen, verwenden Sie die Parameter Name, ID, InstanceIDund State Parameter. Verwenden Sie die verbleibenden Parameter, um die temporäre Sitzung zu konfigurieren, die von Get-PSSession verwendet wird.
Wenn Sie die Parameter ComputerName oder ConnectionUri verwenden, ruft Get-PSSession nur Sitzungen von Computern ab, auf denen Windows PowerShell 3.0 und höhere Versionen von Windows PowerShell ausgeführt werden.
Der Wert der State-Eigenschaft einer PSSession ist relativ zur aktuellen Sitzung. Daher bedeutet der Wert Disconnected , dass die PSSession nicht mit der aktuellen Sitzung verbunden ist. Dies bedeutet jedoch nicht, dass die PSSession von allen Sitzungen getrennt wird. Möglicherweise ist sie mit einer anderen Sitzung verbunden. Um zu bestimmen, ob Sie aus der aktuellen Sitzung eine Verbindung mit der PSSession herstellen oder diese wiederherstellen können, verwenden Sie die Eigenschaft Verfügbarkeit .
Ein Availability Wert von None gibt an, dass Sie eine Verbindung mit der Sitzung herstellen können. Der Wert Busy gibt an, dass Sie keine Verbindung mit der PSSession herstellen können, da sie mit einer anderen Sitzung verbunden ist.
Weitere Informationen zu den Werten der State-Eigenschaft von Sitzungen finden Sie unter RunspaceState-Enumeration in der MSDN-Bibliothek.
Weitere Informationen zu den Werten der Availability-Eigenschaft von Sitzungen finden Sie unter RunspaceAvailability-Enumeration in der MSDN Library.