New-PSSession

Erstellt eine dauerhafte Verbindung mit einem lokalen Computer oder einem Remotecomputer.

Syntax

New-PSSession [[-ComputerName] <string[]>] [-ApplicationName <string>] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-Name <string[]>] [-Port <int>] [-SessionOption <PSSessionOption>] [-UseSSL] [-ThrottleLimit <int>] [<CommonParameters>]

New-PSSession [[-Session] <PSSession[]>] [-Name <string[]>] [-ThrottleLimit <int>] [<CommonParameters>]

New-PSSession [-ConnectionURI] <Uri[]> [-AllowRedirection] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-Name <string[]>] [-SessionOption <PSSessionOption>] [-ThrottleLimit <int>] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "New-PSSession" wird eine Windows PowerShell-Sitzung (PSSession) auf einem lokalen Computer oder einem Remotecomputer erstellt. Wenn Sie eine PSSession erstellen, wird von Windows PowerShell eine dauerhafte Verbindung mit dem Remotecomputer hergestellt.

Mit einer PSSession können Sie mehrere Befehle mit gemeinsamen Daten ausführen, beispielsweise eine Funktion oder der Wert einer Variablen. Verwenden Sie das Cmdlet "Invoke-Command", um Befehle in einer PSSession auszuführen. Um mit einer PSSession direkt mit einem Remotecomputer zu interagieren, verwenden Sie das Cmdlet "Enter-PSSession". Weitere Informationen finden Sie unter "about_PSSessions".

Sie können Befehle auf einem Remotecomputer ausführen, ohne mit dem ComputerName-Parameter von Enter-PSSession oder Invoke-Command eine PSSession zu erstellen. Wenn Sie den ComputerName-Parameter verwenden, wird eine temporäre Verbindung von Windows PowerShell erstellt, die für die interaktive Sitzung oder für einen einzelnen Befehl verwendet und anschließend geschlossen wird.

Parameter

-AllowRedirection

Ermöglicht die Umleitung dieser Verbindung an einen alternativen URI (Uniform Resource Identifier).

Wenn Sie den ConnectionURI-Parameter verwenden, kann das Remoteziel eine Anweisung für die Umleitung an einen anderen URI zurückgeben. Standardmäßig erfolgt mit Windows PowerShell keine Umleitung von Verbindungen, Sie können jedoch mit dem AllowRedirection-Parameter die Umleitung von Verbindungen zulassen.

Sie können auch einschränken, wie oft die Verbindung umgeleitet wird, indem Sie die MaximumConnectionRedirectionCount-Eigenschaft der Einstellungsvariablen "$PSSessionOption" oder die MaximumConnectionRedirectionCount-Eigenschaft des Werts des SessionOption-Parameters festlegen.

Der Standardwert ist 5. Weitere Informationen finden Sie in der Beschreibung des SessionOption-Parameters unter New-PSSessionOption.

-ApplicationName <string>

Gibt das Segment für den Anwendungsnamen im Verbindungs-URI an. Verwenden Sie diesen Parameter zum Angeben des Anwendungsnamens, wenn Sie nicht den ConnectionURI-Parameter im Befehl verwenden.

Der Standardwert ist der Wert der Einstellungsvariablen "$PSSessionApplicationName" auf dem lokalen Computer. Wenn diese Einstellungsvariable nicht definiert ist, ist der Standardwert "WSMAN". Dieser Wert ist für die meisten Verwendungsarten geeignet. Weitere Informationen finden Sie unter "about_Preference_Variables".

Der WinRM-Dienst wählt mit dem Anwendungsnamen einen Listener für die Verbindungsanforderung aus. Der Wert dieses Parameters sollte mit dem Wert der URLPrefix-Eigenschaft eines Listeners auf dem Remotecomputer übereinstimmen.

-Authentication <AuthenticationMechanism>

Gibt den Mechanismus an, der zum Authentifizieren der Anmeldeinformationen des Benutzers verwendet wird. Gültige Werte sind "Default", "Basic", "Credssp", "Digest", "Kerberos", "Negotiate" und "NegotiateWithImplicitCredential". Der Standardwert ist "Default".

Die CredSSP-Authentifizierung ist nur in Windows Vista, Windows Server 2008 und höheren Versionen von Windows verfügbar.

Weitere Informationen zu den Werten dieses Parameters finden Sie in der Beschreibung der System.Management.Automation.Runspaces.AuthenticationMechanism-Enumeration in der MSDN Library (Microsoft Developer Network) unter "https://go.microsoft.com/fwlink/?LinkID=144382" (möglicherweise auf Englisch).

Vorsicht: Die CredSSP (Credential Security Service Provider)-Authentifizierung, bei der die Anmeldeinformationen des Benutzers zur Authentifizierung an einen Remotecomputer übergeben werden, ist für Befehle konzipiert, die die Authentifizierung mehr als einer Ressource erfordern, z. B. beim Zugriff auf eine Remotenetzwerkfreigabe. Dieser Mechanismus erhöht das Sicherheitsrisiko des Remotevorgangs. Wenn die Sicherheit des Remotecomputers gefährdet ist, können die an ihn übergebenen Anmeldeinformationen zum Steuern der Netzwerksitzung verwendet werden.

-CertificateThumbprint <string>

Gibt das digitale Zertifikat für öffentliche Schlüssel (X509) eines Benutzerkontos an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Geben Sie den Zertifikatfingerabdruck des Zertifikats ein.

Zertifikate werden bei der zertifikatbasierten Clientauthentifizierung verwendet. Sie können nur lokalen Benutzerkonten zugeordnet werden. Für Domänenkonten können sie nicht verwendet werden.

Um einen Zertifikatfingerabdruck abzurufen, verwenden Sie für das Windows PowerShell-Laufwerk "Cert:" den Befehl "Get-Item" oder "Get-ChildItem".

-ComputerName <string[]>

Erstellt eine dauerhafte Verbindung (PSSession) mit dem angegebenen Computer. Wenn Sie mehrere Computernamen eingeben, wird von New-PSSession jeweils eine PSSession für jeden Computer erstellt. Der Standardwert ist der lokale Computer.

Geben Sie den NetBIOS-Namen, eine IP-Adresse oder den vollqualifizierten Domänennamen mindestens eines Remotecomputers ein. Um den lokalen Computer anzugeben, geben Sie den Computernamen, "localhost" oder einen Punkt (.) ein. Wenn sich der Computer in einer anderen Domäne als der Benutzer befindet, ist der vollqualifizierte Domänenname erforderlich. Sie können auch einen Computernamen (in Anführungszeichen) über die Pipeline an New-PSSession übergeben.

Wenn eine IP-Adresse im Wert des ComputerName-Parameters verwendet werden soll, muss der Befehl den Credential-Parameter einschließen. Außerdem muss der Computer für HTTPS-Transport konfiguriert werden, oder die IP-Adresse des Remotecomputers muss in die WinRM TrustedHosts-Liste auf dem lokalen Computer aufgenommen werden. Anweisungen zum Hinzufügen eines Computernamens zur TrustedHosts-Liste finden Sie unter "Hinzufügen eines Computers zur Liste der vertrauenswürdigen Hosts" in "about_Remote_Troubleshooting".

Hinweis: Um unter Windows Vista und höheren Versionen von Windows den lokalen Computer in den Wert des ComputerName-Parameters einzuschließen, müssen Sie Windows PowerShell mit der Option "Als Administrator ausführen" starten.

-ConfigurationName <string>

Gibt die Sitzungskonfiguration an, die für die neue PSSession verwendet wird.

Geben Sie einen Konfigurationsnamen oder den vollqualifizierten Ressourcen-URI (Uniform Resource Identifier) einer Sitzungskonfiguration ein. Wenn Sie nur den Konfigurationsnamen angeben, wird der folgende Schema-URI vorangestellt: https://schemas.microsoft.com/powershell.

Die Sitzungskonfiguration für eine Sitzung befindet sich auf dem Remotecomputer. Wenn die angegebene Sitzungskonfiguration auf dem Remotecomputer nicht vorhanden ist, führt der Befehl zu einem Fehler.

Der Standardwert ist der Wert der Einstellungsvariablen "$PSSessionConfigurationName" auf dem lokalen Computer. Wenn diese Einstellungsvariable nicht festgelegt ist, ist die Standardeinstellung "Microsoft.PowerShell". Weitere Informationen finden Sie unter "about_Preference_Variables".

-ConnectionURI <Uri[]>

Gibt einen URI (Uniform Resource Identifier) an, der den Verbindungsendpunkt definiert. Der URI muss vollqualifiziert sein.

Das Format dieser Zeichenfolge lautet wie folgt:

<Transport>://<ComputerName>: <Port>/<ApplicationName>

Der Standardwert lautet wie folgt:

https://localhost:80/WSMAN

Gültige Werte für den Abschnitt "Transport" des URIs sind "HTTP" und "HTTPS". Wenn Sie "ConnectionURI" nicht angeben, können Sie die URI-Werte mit den Parametern "UseSSL", "ComputerName", "Port" und "ApplicationName" angeben.

Wenn der Zielcomputer die Verbindung an einen anderen URI umleitet, verhindert Windows PowerShell die Umleitung, es sei denn, Sie verwenden im Befehl den AllowRedirection-Parameter.

-Credential <PSCredential>

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert 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 vom Cmdlet "Get-Credential" zurückgegebenes Objekt.

Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.

-Name <string[]>

Gibt einen Anzeigenamen für die PSSession an.

Wenn Sie andere Cmdlets wie Get-PSSession und Enter-PSSession verwenden, können Sie anhand des Namens auf die PSSession verweisen. Der Name muss für den Computer oder für die aktuelle Sitzung nicht eindeutig sein.

-Port <int>

Gibt den Netzwerkport an dem für diesen Befehl verwendeten Remotecomputer an. Der Standardport ist Port 80 (der HTTP-Port).

Vor der Verwendung eines alternativen Ports müssen Sie den WinRM-Listener auf dem Remotecomputer für die Überwachung dieses Ports konfigurieren. Verwenden Sie die folgenden Befehle, um den Listener zu konfigurieren:

1. winrm delete winrm/config/listener?Address=*+Transport=HTTP

2. winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port=&quot;&lt;port-number&gt;&quot;}

Verwenden Sie den Port-Parameter nur, wenn dies erforderlich ist. Die im Befehl festgelegte Porteinstellung gilt für alle Computer und Sitzungen, für die der Befehl ausgeführt wird. Mit einer alternativen Porteinstellung kann verhindert werden, dass der Befehl auf allen Computern ausgeführt wird.

-Session <PSSession[]>

Verwendet die angegebene PSSession als Modell für die neue PSSession. Dieser Parameter erstellt neue PSSessions mit den gleichen Eigenschaften wie die angegebenen PSSessions.

Geben Sie eine Variable ein, die die PSSessions enthält, oder einen Befehl, mit dem die PSSessions erstellt oder abgerufen werden, z. B. den Befehl "New-PSSession" oder den Befehl "Get-PSSession".

Die resultierenden PSSessions weisen den gleichen Computernamen, Anwendungsnamen, Verbindungs-URI, Port, Konfigurationsnamen, eine identische Drosselungsgrenze und einen identischen SSL (Secure Sockets Layer)-Wert wie die ursprünglichen PSSessions auf, verfügen jedoch über andere Anzeigenamen, IDs und Instanz-IDs (GUID).

-SessionOption <PSSessionOption>

Legt erweiterte Optionen für die Sitzung fest. Geben Sie ein SessionOption-Objekt ein, das Sie mit dem Cmdlet "New-PSSessionOption" erstellen.

Die Standardwerte für die Optionen werden durch den Wert der Einstellungsvariablen "$PSSessionOption" bestimmt, wenn diese festgelegt wurde. Andernfalls verwendet die Sitzung die Systemstandardwerte.

Eine Beschreibung der Sitzungsoptionen, einschließlich der Standardwerte, finden Sie unter New-PSSessionOption. Weitere Informationen über die Einstellungsvariable "$PSSessionOption" finden Sie unter "about_Preference_Variables".

-ThrottleLimit <int>

Gibt die maximale Anzahl von gleichzeitigen Verbindungen an, die zum Ausführen dieses Befehls hergestellt werden können. Wenn Sie diesen Parameter weglassen oder den Wert 0 (null) eingeben, wird der Standardwert 32 verwendet.

Die Drosselungsgrenze gilt nur für den aktuellen Befehl und nicht für die Sitzung oder den Computer.

-UseSSL

Verwendet das SSL (Secure Sockets Layer)-Protokoll, um eine Verbindung mit dem Remotecomputer herzustellen. Standardmäßig wird SSL nicht verwendet.

WS-Management verschlüsselt alle über das Netzwerk gesendeten Windows PowerShell-Inhalte. UseSSL ist ein zusätzlicher Schutz, bei dem die Daten über eine HTTPS- anstatt über eine HTTP-Verbindung gesendet werden.

Wenn Sie diesen Parameter verwenden und SSL an dem für den Befehl verwendeten Port nicht verfügbar ist, schlägt der Befehl fehl.

<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

Dieses Cmdlet verwendet die Windows PowerShell-Remoteinfrastruktur. Um dieses Cmdlet zu verwenden müssen der lokale Computer und alle Remotecomputer für Windows PowerShell-Remoting konfiguriert werden. Weitere Informationen finden Sie unter "about_Remote_Requirements".

Um unter Windows Vista und höheren Versionen von Windows eine PSSession auf dem lokalen Computer zu erstellen, müssen Sie Windows PowerShell mit der Option "Als Administrator ausführen" starten.

Verwenden Sie nach Abschluss der PSSession das Cmdlet "Remove-PSSession", um die PSSession zu löschen und die Ressourcen freizugeben.

Beispiel 1

C:\PS>$s = new-pssession

Beschreibung
-----------
Mit diesem Befehl wird eine neue PSSession auf dem lokalen Computer erstellt und in der Variablen "$s" gespeichert.

Mit dieser PSSession können Sie nun Befehle auf dem lokalen Computer ausführen.

Beispiel 2

C:\PS>$Server01 = new-pssession -ComputerName Server01

Beschreibung
-----------
Mit diesem Befehl wird eine neue PSSession auf dem Computer "Server01" erstellt und in der Variablen "$Server01" gespeichert. 

Wenn Sie mehrere PSSessions erstellen, weisen Sie diese Variablen mit aussagekräftigem Namen zu. Dies hilft Ihnen, die PSSessions in nachfolgenden Befehlen zu verwalten.

Beispiel 3

C:\PS>$s1, $s2, $s3 = new-session -computername server1,server2,server3

Beschreibung
-----------
Mit diesem Befehl werden drei neue PSSessions erstellt, eine auf jedem Computer, der mit dem ComputerName-Parameter angegeben wurde. 

Im Befehl werden die neuen PSSessions mit dem Zuweisungsoperator (=) einem Array von Variablen zugewiesen: $s1, $s2, $s3. Die PSSession "Server01" wird "$s1", die PSSession "Server02" wird "$s2", und die PSSession "Server03" wird "$s3" zugewiesen.

Wenn Sie mehrere Objekte einem Array von Variablen zuweisen, werden die einzelnen Objekte von Windows PowerShell jeweils einer Variablen im Array zugewiesen. Wenn mehr Objekte als Variablen vorhanden sind, werden alle verbleibenden Objekte der letzten Variablen zugewiesen. Wenn es mehr Variablen als Objekte gibt, sind die verbleibenden Variablen leer (NULL).

Beispiel 4

C:\PS>new-pssession -computername Server01 -port 8081 -useSSL -ConfigurationName E12

Beschreibung
-----------
Mit diesem Befehl wird eine neue PSSession auf dem Computer "Server01" erstellt, und die Verbindung wird mit dem Serverport 8081 und dem SSL-Protokoll hergestellt. In der neuen PSSession wird die alternative Sitzungskonfiguration "E12" verwendet.

Vor dem Festlegen des Ports müssen Sie den WinRM-Listener auf dem Remotecomputer für die Überwachung von Port 8081 konfigurieren. Weitere Informationen finden Sie in der Beschreibung des Port-Parameters.

Beispiel 5

C:\PS>new-pssession -session $s -credential domain01\user01

Beschreibung
-----------
Mit diesem Befehl wird eine neue PSSession mit den gleichen Eigenschaften wie eine vorhandene PSSession erstellt. Sie können dieses Befehlsformat verwenden, wenn die Ressourcen einer vorhandenen PSSession erschöpft sind und eine neue PSSession für einen teilweisen Lastenausgleich benötigt wird.

Der Befehl gibt mit dem Session-Parameter von New-PSSession die PSSession an, die in der Variablen "$s" gespeichert wurde. Der Befehl wird mit den Anmeldeinformationen des Benutzers "Domain1\Admin01" vervollständigt.

Beispiel 6

C:\PS>$global:s = new-pssession -computername server1.domain44.corpnet.fabrikam.com -credential domain01\admin01

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie eine PSSession mit einem globalen Bereich auf einem Computer in einer anderen Domäne erstellt wird.

Standardmäßig werden PSSessions in der Befehlszeile mit einem lokalem Bereich erstellt, und PSSessions im Skript werden mit einem Skriptbereich erstellt. 

Erstellen Sie eine neue PSSession und speichern Sie diese in einer Variablen, die in einen globalen Bereich umgewandelt wird, um eine PSSession mit globalem Bereich zu erstellen. In diesem Fall wird die Variable "$s" in einen globalen Bereich umgewandelt.

Im Befehl werden die Remotecomputer mit dem ComputerName-Parameter angegeben. Da sich der Computer in einer anderen Domäne als das Benutzerkonto befindet, wird der vollständige Name des Computers mit den Anmeldeinformationen des Benutzers angegeben.

Beispiel 7

C:\PS>$rs = get-content c:\test\servers.txt | new-PSsession -throttleLimit 50

Beschreibung
-----------
Mit diesem Befehl wird auf allen 200 Computern, die in der Datei "Servers.txt" aufgeführt sind, eine PSSession erstellt, und die resultierenden PSSessions werden in der Variablen "$rs" gespeichert. Die PSSessions haben eine Drosselungsgrenze von 50.

Sie können dieses Befehlsformat verwenden, wenn die Namen von Computern in einer Datenbank, einem Arbeitsblatt, einer Textdatei oder einem anderem Format gespeichert werden, das in Text konvertiert werden kann.

Beispiel 8

C:\PS>$s = new-PSSession -URI http://Server01:91/NewSession -credential domain01\user01

Beschreibung
-----------
In diesem Befehl wird auf dem Computer "Server01" eine PSSession erstellt und in der Variablen "$s" gespeichert. Das Transportprotokoll, der Remotecomputer, der Port und eine alternative Sitzungskonfiguration werden mit dem URI-Parameter angegeben. Außerdem wird mit dem Credential-Parameters ein Benutzerkonto mit der Berechtigung angegeben, eine Sitzung auf dem Remotecomputer zu erstellen.

Beispiel 9

C:\PS>$s = new-PSSession -computername (import-csv servers.csv) -credential domain01\admin01 -throttlelimit 16

C:\PS> invoke-command -session $s -scriptblock {get-process powershell} -AsJob

Beschreibung
-----------
Mit diesen Befehlen wird ein Satz von PSSessions erstellt, und in jeder PSSession wird anschließend ein Hintergrundauftrag ausgeführt. 

Mit dem ersten Befehl wird eine neue PSSession auf allen Computern erstellt, die in der Datei "Servers.csv" aufgeführt sind. Die PSSession wird dabei mit dem Cmdlet "New-PSSession" erstellt. Der Wert des ComputerName-Parameters ist ein Befehl, der mit dem Cmdlet "Import-Csv" die Datei "Servers.csv" importiert und ihren Inhalt liest. 

Im Befehl werden die PSSessions mit der Berechtigung eines Domänenadministrators und dem ThrottleLimit-Parameter mit dem Credential-Parameter erstellt, um den Befehl auf 16 gleichzeitige Verbindungen zu beschränken. Der Befehl speichert die PSSessions in der Variablen "$s".
   
Im zweiten Befehl wird mit dem AsJob-Parameter von Invoke-Command ein Hintergrundauftrag gestartet, mit dem der Befehl "Get-Process PowerShell" in den einzelnen PSSessions in "$s" ausgeführt wird. 

Weitere Informationen über Hintergrundaufträge finden Sie unter "about_Jobs" und "about_Remote_Jobs".

Beispiel 10

C:\PS>new-PSSession -ConnectionURI https://management.exchangelabs.com/Management

Beschreibung
-----------
Mit diesem Befehl wird eine neue PSSession erstellt, in der eine Verbindung mit einem Computer hergestellt wird, der von einem URI anstelle eines Computernamens angegeben wird.

Beispiel 11

C:\PS>$so = New-WSManSessionOption -SkipCACheck

PS C:\> new-pssession -ConnectionUri https://management.exchangelabs.com/Management -SessionOption $so -credential server01\admin01

Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie ein SessionOption-Parameter erstellt und verwendet wird. 

Im ersten Befehl wird mit dem Cmdlet "New-WSManSessionOption" eine Sitzungsoption erstellt. Das resultierende SessionOption-Objekt wird im $so-Parameter gespeichert.

Mit dem zweiten Befehl wird die Option in einer neuen Sitzung verwendet. Im Befehl wird eine neue Sitzung mit dem Cmdlet "New-PSSession" erstellt. Der Wert des SessionOption-Parameters entspricht dem SessionOption-Objekt in der Variablen "$so".

Siehe auch

Konzepte

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