Enter-PSSession
Startet eine interaktive Sitzung mit einem Remotecomputer.
Syntax
Enter-PSSession
[-ComputerName] <String>
[-EnableNetworkAccess]
[-Credential <PSCredential>]
[-ConfigurationName <String>]
[-Port <Int32>]
[-UseSSL]
[-ApplicationName <String>]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]Enter-PSSession
[[-Session] <PSSession>]
[<CommonParameters>]Enter-PSSession
[[-ConnectionUri] <Uri>]
[-EnableNetworkAccess]
[-Credential <PSCredential>]
[-ConfigurationName <String>]
[-AllowRedirection]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]Enter-PSSession
[-InstanceId <Guid>]
[<CommonParameters>]Enter-PSSession
[[-Id] <Int32>]
[<CommonParameters>]Enter-PSSession
[-Name <String>]
[<CommonParameters>]Enter-PSSession
[-VMId] <Guid>
-Credential <PSCredential>
[-ConfigurationName <String>]
[<CommonParameters>]Enter-PSSession
[-VMName] <String>
-Credential <PSCredential>
[-ConfigurationName <String>]
[<CommonParameters>]Enter-PSSession
[-ContainerId] <String>
[-ConfigurationName <String>]
[-RunAsAdministrator]
[<CommonParameters>]Beschreibung
Das Enter-PSSession Cmdlet startet eine interaktive Sitzung mit einem einzelnen Remotecomputer. Während der Sitzung werden die von Ihnen eingegebenen Befehle auf dem Remotecomputer genauso ausgeführt, als ob Sie direkt auf dem Remotecomputer eingaben. Sie können sich zu einem Zeitpunkt jeweils nur in einer interaktiven Sitzung befinden.
In der Regel verwenden Sie den Parameter ComputerName , um den Namen des Remotecomputers anzugeben.
Sie können jedoch auch eine Sitzung verwenden, die Sie erstellen, indem Sie das New-PSSession Cmdlet für die interaktive Sitzung verwenden. Sie können die Verbindung Connect-PSSessionmit einer interaktiven Sitzung jedoch nicht mit den Disconnect-PSSessionCmdlets trennen Receive-PSSession oder erneut herstellen.
Um die interaktive Sitzung zu beenden und die Verbindung mit dem Remotecomputer zu trennen, verwenden Sie das Exit-PSSession Cmdlet oder geben Sie ein exit.
Wichtig
Enter-PSSession ist so konzipiert, dass die aktuelle interaktive Sitzung durch eine neue interaktive Remotesitzung ersetzt wird. Sie sollten sie nicht innerhalb einer Funktion oder eines Skripts aufrufen oder sie als Befehl an die powershell.exe ausführbare Datei übergeben.
Beispiele
Beispiel 1: Starten einer interaktiven Sitzung
PS C:\> Enter-PSSession
[localhost]: PS C:\>Dieser Befehl startet eine interaktive Sitzung auf dem lokalen Computer. Die Eingabeaufforderung ändert sich, um anzugeben, dass die Befehle nun in einer anderen Sitzung ausgeführt werden.
Die eingegebenen Befehle werden in der neuen Sitzung ausgeführt, und die Ergebnisse werden als Text an die Standardsitzung zurückgegeben.
Beispiel 2: Arbeiten mit einer interaktiven Sitzung
Der erste Befehl verwendet das Enter-PSSession Cmdlet zum Starten einer interaktiven Sitzung mit Server01, einem Remotecomputer. Wenn die Sitzung gestartet wird, ändert sich die Eingabeaufforderung, um den Computernamen einzuschließen.
Der zweite Befehl ruft den PowerShell-Prozess ab und leitet die Ausgabe an die Process.txt Datei weiter.
Der Befehl wird an den Remotecomputer übermittelt, und die Datei wird auf dem Remotecomputer gespeichert.
Der dritte Befehl verwendet das Exit-Schlüsselwort , um die interaktive Sitzung zu beenden und die Verbindung zu schließen.
Der vierte Befehl bestätigt, dass sich die Process.txt Datei auf dem Remotecomputer befindet. Ein Get-ChildItem Befehl ("dir") auf dem lokalen Computer kann die Datei nicht finden.
PS C:\> Enter-PSSession -ComputerName Server01
[Server01]: PS C:\>
[Server01]: PS C:\> Get-Process PowerShell > C:\ps-test\Process.txt
[Server01]: PS C:\> exit
PS C:\>
PS C:\> dir C:\ps-test\Process.txt
Get-ChildItem : Cannot find path 'C:\ps-test\Process.txt' because it does not exist.
At line:1 char:4
+ dir <<<< c:\ps-test\Process.txtDieser Befehl zeigt die Arbeitsweise in einer interaktiven Sitzung mit einem Remotecomputer.
Beispiel 3: Verwenden des Session-Parameters
PS> $s = New-PSSession -ComputerName Server01
PS> Enter-PSSession -Session $s
[Server01]: PS>Diese Befehle verwenden den Parameter "Session " zum Enter-PSSession Ausführen der interaktiven Sitzung in einer vorhandenen PowerShell-Sitzung (PSSession).
Beispiel 4: Starten einer interaktiven Sitzung und Angeben der Parameter "Port" und "Anmeldeinformationen"
PS> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS>Dieser Befehl startet eine interaktive Sitzung mit dem Computer „Server01“. Er verwendet den Port-Parameter , um den Port und den Parameter "Credential " anzugeben, um das Konto eines Benutzers anzugeben, der über die Berechtigung zum Herstellen einer Verbindung mit dem Remotecomputer verfügt.
Beispiel 5: Beenden einer interaktiven Sitzung
PS> Enter-PSSession -ComputerName Server01
[Server01]: PS> Exit-PSSession
PS>In diesem Beispiel wird veranschaulicht, wie eine interaktive Sitzung gestartet und beendet wird. Der erste Befehl verwendet das Enter-PSSession Cmdlet, um eine interaktive Sitzung mit dem Server01-Computer zu starten.
Der zweite Befehl verwendet das Exit-PSSession Cmdlet zum Beenden der Sitzung. Sie können auch das Exit-Schlüsselwort verwenden, um die interaktive Sitzung zu beenden. Exit-PSSession und Exit haben denselben Effekt.
Parameter
-AllowRedirection
Ermöglicht die Umleitung dieser Verbindung an einen alternativen URI (Uniform Resource Identifier). Standardmäßig ist die Umleitung nicht zulässig.
Wenn Sie den Parameter ConnectionURI verwenden, kann das Remoteziel eine Anweisung zurückgeben, um zu einem anderen URI umzuleiten. Standardmäßig leitet PowerShell keine Verbindungen um, Sie können diesen Parameter jedoch verwenden, um die Verbindung umzuleiten.
Sie können auch einschränken, wie oft die Verbindung umgeleitet wird, indem Sie den Wert der Option "MaximumConnectionRedirectionCount " ändern. Verwenden Sie den Parameter MaximumRedirection des New-PSSessionOption Cmdlets, oder legen Sie die MaximumConnectionRedirectionCount-Eigenschaft der $PSSessionOption Einstellungsvariable fest. Der Standardwert ist 5.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ApplicationName
Gibt das Anwendungsnamenssegment des Verbindungs-URI an. Verwenden Sie diesen Parameter, um den Anwendungsnamen anzugeben, wenn Sie den ConnectionURI-Parameter nicht im Befehl verwenden.
Der Standardwert ist der Wert der $PSSessionApplicationName Einstellungsvariable 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 verwendet den Anwendungsnamen, um einen Listener zum Dienst der Verbindungsanforderung auszuwählen. Der Wert dieses Parameters sollte mit dem Wert der URLPrefix-Eigenschaft eines Listeners auf dem Remotecomputer übereinstimmen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Authentication
Gibt den Mechanismus an, der zum Authentifizieren der Anmeldeinformationen des Benutzers verwendet wird. Zulässige Werte für diesen Parameter:
- Standard
- Grundlegend
- Credssp
- Digest
- Kerberos
- Aushandeln
- NegotiateWithImplicitCredential
Der Standardwert lautet Default.
CredSSP-Authentifizierung ist nur in Windows Vista, Windows Server 2008 und höheren Versionen des Windows-Betriebssystems verfügbar.
Weitere Informationen zu den Werten dieses Parameters finden Sie unter AuthenticationMechanism Enum.
Achtung
Credential Security Support Provider (CredSSP)-Authentifizierung, bei der die Anmeldeinformationen des Benutzers an einen Remotecomputer übergeben werden, der authentifiziert werden soll, ist für Befehle konzipiert, die eine Authentifizierung für mehrere Ressourcen erfordern, z. B. den 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.
| Typ: | AuthenticationMechanism |
| Zulässige Werte: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CertificateThumbprint
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 clientzertifikatbasierten Authentifizierung verwendet. Sie können nur lokalen Benutzerkonten zugeordnet werden und funktionieren nicht mit Domänenkonten.
Um ein Zertifikat abzurufen, verwenden Sie den Befehl oder Get-ChildItem den Get-Item Befehl im PowerShell-Zertifikat: Laufwerk.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ComputerName
Gibt einen Computernamen an. Dieses Cmdlet startet eine interaktive Sitzung mit dem angegebenen Remotecomputer. Geben Sie nur einen Computernamen ein. Die Standardeinstellung ist der lokale Computer.
Geben Sie den NetBIOS-Namen, die IP-Adresse oder den vollqualifizierten Domänennamen des Computers ein. Sie können auch einen Computernamen an Enter-PSSession.
Um eine IP-Adresse im Wert des ComputersName-Parameters zu verwenden, muss der Befehl den Parameter "Credential " enthalten. Außerdem muss der Computer für den HTTPS-Transport konfiguriert sein, oder die IP-Adresse des Remotecomputers muss in der WinRM TrustedHosts-Liste auf dem lokalen Computer enthalten sein. Anweisungen zum Hinzufügen eines Computernamens zur Liste "TrustedHosts" finden Sie unter "Hinzufügen eines Computers zur vertrauenswürdigen Hostliste" in about_Remote_Troubleshooting.
Hinweis
Um den lokalen Computer im Windows-Betriebssystem in den Wert des Parameters "ComputerName " einzuschließen, müssen Sie PowerShell mit der Option "Als Administrator ausführen" starten.
| Typ: | String |
| Aliase: | Cn |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ConfigurationName
Gibt die Sitzungskonfiguration an, die für die interaktive Sitzung verwendet wird.
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: http://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, schlägt der Befehl fehl.
Der Standardwert ist der Wert der $PSSessionConfigurationName Einstellungsvariable auf dem lokalen Computer. Wenn diese Einstellungsvariable nicht festgelegt ist, ist die Standardeinstellung "Microsoft.PowerShell". Weitere Informationen finden Sie unter about_Preference_Variables.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ConnectionUri
Gibt einen URI an, der den Verbindungsendpunkt für die Sitzung definiert. Der URI muss vollqualifiziert sein. Das Format dieser Zeichenfolge lautet wie folgt:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
Der Standardwert lautet:
http://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 Transport-Segment des URI sind „HTTP“ und „HTTPS“. Wenn Sie einen Verbindungs-URI mit einem Transportsegment angeben, aber keinen Port angeben, wird die Sitzung mithilfe von Standardsports erstellt: 80 für HTTP und 443 für HTTPS. Um die Standardports für PowerShell-Remoting zu verwenden, geben Sie Port 5985 für HTTP oder 5986 für HTTPS an.
Wenn der Zielcomputer die Verbindung zu einem anderen URI umleitet, verhindert PowerShell die Umleitung, es sei denn, Sie verwenden den Parameter AllowRedirection im Befehl.
| Typ: | Uri |
| Aliase: | URI, CU |
| Position: | 1 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ContainerId
Gibt die ID eines Containers an.
| Typ: | String |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Credential
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" oder "Domain01\User01", oder geben Sie ein vom Cmdlet generiertes Get-Credential PSCredential-Objekt ein. Wenn Sie einen Benutzernamen eingeben, werden Sie aufgefordert, das Kennwort einzugeben.
Anmeldeinformationen werden in einem PSCredential-Objekt gespeichert, und das Kennwort wird als SecureString gespeichert.
Hinweis
Weitere Informationen zum Schutz von SecureString finden Sie unter "Wie sicher ist SecureString?".
| Typ: | PSCredential |
| Position: | 1 |
| Standardwert: | Current user |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-EnableNetworkAccess
Gibt an, dass mit diesem Cmdlet ein interaktives Sicherheitstoken zu Loopbacksitzungen hinzugefügt wird. Mit dem interaktiven Token können Sie die Befehle in der Loopbacksitzung ausführen, um Daten von anderen Computern abzurufen. Beispielsweise können Sie einen Befehl in der Sitzung ausführen, mit dem XML-Dateien von einem Remotecomputer auf den lokalen Computer kopiert werden.
Eine Loopbacksitzung ist eine PSSession , die auf demselben Computer stammt und endet. Um eine Loopbacksitzung zu erstellen, lassen Sie den ComputerName-Parameter aus, oder legen Sie dessen Wert auf . (punkt), localhost oder der Name des lokalen Computers.
Standardmäßig werden Loopbacksitzungen mithilfe eines Netzwerktokens erstellt, das möglicherweise nicht über ausreichende Berechtigungen für die Authentifizierung bei Remotecomputern verfügt.
Der Parameter EnableNetworkAccess ist nur in Loopbacksitzungen wirksam. Wenn Sie EnableNetworkAccess verwenden, wenn Sie eine Sitzung auf einem Remotecomputer erstellen, wird der Befehl erfolgreich ausgeführt, der Parameter wird jedoch ignoriert.
Sie können den Remotezugriff auch in einer Loopbacksitzung zulassen, indem Sie den CredSSP-Wert des Authentifizierungsparameters verwenden, der die Sitzungsanmeldeinformationen an andere Computer delegiert.
Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Id
Gibt die ID einer vorhandenen Sitzung an. Enter-PSSession verwendet die angegebene Sitzung für die interaktive Sitzung.
Verwenden Sie das Get-PSSession Cmdlet, um die ID einer Sitzung zu finden.
| Typ: | Int32 |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-InstanceId
Gibt die Instanz-ID einer vorhandenen Sitzung an. Enter-PSSession verwendet die angegebene Sitzung für die interaktive Sitzung.
Die Instanz-ID ist eine GUID. Verwenden Sie das Get-PSSession Cmdlet, um die Instanz-ID einer Sitzung zu finden. Sie können auch die Parameter "Session", "Name" oder "ID " verwenden, um eine vorhandene Sitzung anzugeben. Sie können auch den ComputerName-Parameter verwenden, um eine temporäre Sitzung zu starten.
| Typ: | Guid |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt den Anzeigenamen einer vorhandenen Sitzung an. Enter-PSSession verwendet die angegebene Sitzung für die interaktive Sitzung.
Wenn der angegebene Name mit mehr als einer Sitzung übereinstimmt, führt der Befehl zu einem Fehler. Sie können auch die Parameter "Session", "InstanceID" oder "ID " verwenden, um eine vorhandene Sitzung anzugeben. Sie können auch den ComputerName-Parameter verwenden, um eine temporäre Sitzung zu starten.
Verwenden Sie zum Einrichten eines Anzeigenamens für eine Sitzung den Parameter Name des New-PSSession Cmdlets.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Port
Gibt den Netzwerkport auf dem Remotecomputer an, der für diesen Befehl verwendet 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 ein alternativer Port verwendet werden kann, müssen Sie den WinRM-Listener auf dem Remotecomputer für das Abhören an diesen Port konfigurieren. Verwenden Sie die folgenden Befehle, um den Listener zu konfigurieren:
winrm delete winrm/config/listener?Address=*+Transport=HTTPwinrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}
Verwenden Sie den Port-Parameter nicht, es sei denn, Sie müssen. Die Porteinstellung im Befehl gilt für alle Computer oder Sitzungen, für die der Befehl ausgeführt wird. Eine alternative Porteinstellung kann verhindern, dass der Befehl auf allen Computern ausgeführt wird.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RunAsAdministrator
Gibt an, dass die PSSession als Administrator ausgeführt wird.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Session
Gibt eine PowerShell-Sitzung (PSSession) an, die für die interaktive Sitzung verwendet werden soll. Dieser Parameter akzeptiert ein Sitzungsobjekt. Sie können auch die Parameter Name, InstanceID oder ID verwenden, um eine PSSession anzugeben.
Geben Sie eine Variable ein, die ein Sitzungsobjekt oder einen Befehl enthält, der ein Sitzungsobjekt erstellt oder abruft, z. B. einen New-PSSession Oder Get-PSSession Befehl. Sie können ein Sitzungsobjekt auch an Enter-PSSession. Sie können nur eine PSSession mit diesem Parameter übermitteln. Wenn Sie eine Variable eingeben, die mehr als eine PSSession enthält, schlägt der Befehl fehl.
Wenn Sie das SCHLÜSSELwort EXIT verwenden oder das EXIT-Schlüsselwort verwendenExit-PSSession, endet die interaktive Sitzung, die von Ihnen erstellte PSSession bleibt jedoch geöffnet und für die Verwendung verfügbar.
| Typ: | PSSession |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-SessionOption
Legt erweiterte Optionen für die Sitzung fest. Geben Sie ein SessionOption-Objekt ein, z. B. ein Objekt, das Sie mithilfe des New-PSSessionOption Cmdlets 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, wenn sie festgelegt ist. Andernfalls werden die Standardwerte durch Optionen festgelegt, die in der Sitzungskonfiguration festgelegt sind.
Die Sitzungsoptionswerte haben Vorrang vor Standardwerten für Sitzungen, die in der $PSSessionOption Einstellungsvariable 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 Einstellungsvariablen $PSSessionOption finden Sie unter about_Preference_Variables. Weitere Informationen zu Sitzungskonfigurationen finden Sie unter about_Session_Configurations.
| Typ: | PSSessionOption |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseSSL
Gibt an, dass dieses Cmdlet das SSL-Protokoll (Secure Sockets Layer) verwendet, um eine Verbindung mit dem Remotecomputer herzustellen. Standardmäßig wird SSL nicht verwendet.
WS-Management verschlüsselt alle über das Netzwerk übertragenen PowerShell-Inhalte. Der UseSSL-Parameter ist ein zusätzlicher Schutz, der die Daten über eine HTTPS-Verbindung statt über eine HTTP-Verbindung sendet.
Wenn Sie diesen Parameter verwenden, ssl jedoch nicht für den Port verfügbar ist, der für den Befehl verwendet wird, schlägt der Befehl fehl.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-VMId
Gibt die ID eines virtuellen Computers an.
| Typ: | Guid |
| Aliase: | VMGuid |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-VMName
Gibt den Namen eines virtuellen Computers an.
| Typ: | String |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Sie können einen Computernamen als Zeichenfolge an dieses Cmdlet weiterleiten.
Sie können ein Sitzungsobjekt an dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
Windows PowerShell enthält die folgenden Aliase für Enter-PSSession:
etsn
Um eine Verbindung zu einem Remotecomputer herzustellen, müssen Sie Mitglied der Gruppe „Administratoren“ auf dem Remotecomputer sein. Um eine interaktive Sitzung auf dem lokalen Computer zu starten, müssen Sie PowerShell mit der Option "Als Administrator ausführen" starten.
Bei Verwendung Enter-PSSessionwird Ihr Benutzerprofil auf dem Remotecomputer für die interaktive Sitzung verwendet. Die Befehle im Remotebenutzerprofil, einschließlich Befehle zum Hinzufügen von PowerShell-Modulen und zum Ändern der Eingabeaufforderung, führen Sie aus, bevor die Remoteaufforderung angezeigt wird.
Enter-PSSession verwendet die Benutzeroberflächenkultureinstellung auf dem lokalen Computer für die interaktive Sitzung. Verwenden Sie die $UICulture automatische Variable, um die lokale Benutzeroberflächenkultur zu finden.
Enter-PSSessionerfordert die Cmdlets , Out-Defaultund Exit-PSSession die Get-Command. Wenn diese Cmdlets nicht in der Sitzungskonfiguration auf dem Remotecomputer enthalten sind, schlägt dies Enter-PSSession fehl.
Im Gegensatz dazu Invoke-Command, welche Befehle analysiert und interpretiert werden, bevor sie an den Remotecomputer gesendet werden, Enter-PSSession werden die Befehle ohne Interpretation direkt an den Remotecomputer gesendet.
Wenn die sitzung, die Sie eingeben möchten, mit der Verarbeitung eines Befehls beschäftigt ist, kann es zu einer Verzögerung kommen, bevor PowerShell auf den Enter-PSSession Befehl reagiert. Sie sind verbunden, sobald die Sitzung verfügbar ist. Um den Enter-PSSession Befehl abzubrechen, drücken Sie STRG+C.
