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
[-HostName] <String>
[-Port <Int32>]
[-UserName <String>]
[-KeyFilePath <String>]
[-SSHTransport]
[<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 Befehle, die Sie auf dem Remotecomputer eingeben, genauso wie direkt auf dem Remotecomputer eingegeben. Sie können sich zu einem Zeitpunkt jeweils nur in einer interaktiven Sitzung befinden.
Normalerweise verwenden Sie den ComputerName-Parameter, um den Namen des Remotecomputers anzugeben.
Sie können jedoch auch eine Sitzung verwenden, die Sie erstellen, indem Sie das Cmdlet für die New-PSSession interaktive Sitzung verwenden. Sie können jedoch die Disconnect-PSSessionConnect-PSSession, oder Cmdlets nicht verwenden, um eine Verbindung mit einer interaktiven Sitzung herzustellen oder Receive-PSSession erneut herzustellen.
Ab PowerShell 6.0 können Sie Secure Shell (SSH) verwenden, um eine Verbindung mit einem Remotecomputer herzustellen, wenn SSH auf dem lokalen Computer verfügbar ist und der Remotecomputer mit einem PowerShell SSH-Endpunkt konfiguriert ist. Der Vorteil einer SSH-basierten PowerShell-Remotesitzung besteht darin, dass es auf mehreren Plattformen funktioniert (Windows, Linux, macOS). Bei SSH-basiertem Remoting verwenden Sie den Parameter "HostName ", um den Remotecomputer und relevante Verbindungsinformationen anzugeben. Weitere Informationen zum Einrichten von PowerShell SSH-Remoting finden Sie unter PowerShell Remoting Over SSH.
Um die interaktive Sitzung zu beenden und von dem Remotecomputer zu trennen, verwenden Sie das Exit-PSSession Cmdlet oder den Typ exit.
Beispiele
Beispiel 1: Starten einer interaktiven Sitzung
PS> Enter-PSSession
[localhost]: PS>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 startet, ändert sich die Eingabeaufforderung und enthält den Computernamen.
Der zweite Befehl ruft den PowerShell-Prozess ab und leitet die Ausgabe in die Datei „Process.txt“ um. Der Befehl wird an den Remotecomputer gesendet, 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 Datei „Process.txt“ 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>
[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 Sitzungsparameters
PS> $s = New-PSSession -ComputerName Server01
PS> Enter-PSSession -Session $s
[Server01]: PS>Diese Befehle verwenden den Sitzungsparameter Enter-PSSession , um die interaktive Sitzung in einer vorhandenen PowerShell-Sitzung (PSSession) auszuführen.
Beispiel 4: Starten einer interaktiven Sitzung und Angeben der Port- und Anmeldeinformationenparameter
PS> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS>Dieser Befehl startet eine interaktive Sitzung mit dem Computer „Server01“. Es verwendet den Portparameter , um den Port und den Anmeldeinformationenparameter 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 Cmdlet, um die Exit-PSSession Sitzung zu beenden. Sie können auch das Exit-Schlüsselwort verwenden, um die interaktive Sitzung zu beenden. Exit-PSSession und Exit haben den gleichen Effekt.
Beispiel 6: Starten einer interaktiven Sitzung mithilfe von SSH
PS> Enter-PSSession -HostName UserA@LinuxServer01In diesem Beispiel wird gezeigt, wie Sie eine interaktive Sitzung mit Secure Shell (SSH) starten. Wenn SSH auf dem Remotecomputer so konfiguriert ist, dass Sie zu Kennwörtern aufgefordert werden, erhalten Sie eine Kennwortaufforderung. Andernfalls müssen Sie SSH-Schlüsselbasierte Benutzerauthentifizierung verwenden.
Beispiel 7: Starten einer interaktiven Sitzung mithilfe von SSH und angeben des Port- und Benutzerauthentifizierungsschlüssels
PS> Enter-PSSession -HostName UserA@LinuxServer02:22 -KeyFilePath c:\<path>\userAKey_rsaIn diesem Beispiel wird gezeigt, wie Sie eine interaktive Sitzung mit SSH starten. Er verwendet den Portparameter , um den zu verwendenden Port und den KeyFilePath-Parameter anzugeben, um einen RSA-Schlüssel anzugeben, der zum Authentifizieren des Benutzers auf dem Remotecomputer verwendet wird.
Parameter
-AllowRedirection
Ermöglicht die Umleitung dieser Verbindung an einen alternativen URI (Uniform Resource Identifier). Standardmäßig ist die Umleitung nicht zulässig.
Bei Verwendung des ConnectionURI-Parameters kann das Remoteziel eine Anweisung zum Umleiten an einen anderen URI zurückgeben. Standardmäßig leitet PowerShell keine Verbindungen um, aber Sie können diesen Parameter verwenden, um die Verbindung umleiten zu können.
Sie können auch einschränken, wie oft die Verbindung umgeleitet wird, indem Sie den MaximumConnectionRedirectionCount-Optionswert der Sitzung ändern. Verwenden Sie den Parameter "MaximumRedirection" des Cmdlets oder legen Sie die MaximumConnectionRedirectionCount-Eigenschaft der $PSSessionOptionNew-PSSessionOption Einstellungsvariable fest. Der Standardwert ist 5.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationName
Gibt das Anwendungsnamenssegment des Verbindungs-URI an. Mit diesem Parameter können Sie den Anwendungsnamen angeben, wenn Sie den ConnectionURI-Parameter im Befehl nicht 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 für den Dienst der Verbindungsanforderung auszuwählen. Der Wert dieses Parameters sollte mit dem Wert der URLPrefix-Eigenschaft eines Listeners auf dem Remotecomputer übereinstimmen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Authentication
Gibt den Mechanismus an, der zum Authentifizieren der Anmeldeinformationen des Benutzers verwendet wird. Zulässige Werte für diesen Parameter:
- Standard
- Standard
- Credssp
- Digest
- Kerberos
- Aushandeln
- NegotiateWithImplicitCredential
Der Standardwert ist Default.
CredSSP-Authentifizierung ist nur in Windows Vista, Windows Server 2008 und späteren Versionen des Windows-Betriebssystems verfügbar.
Weitere Informationen zu den Werten dieses Parameters finden Sie unter AuthenticationMechanism Enum.
Vorsicht: Credential Security Support Provider (CredSSP)-Authentifizierung, in der die Anmeldeinformationen des Benutzers an einen Remotecomputer übergeben werden, der authentifiziert werden soll, ist für Befehle konzipiert, die die Authentifizierung auf mehreren Ressourcen erfordern, z. B. auf einen Remotenetzwerkfreigabe zugreifen. 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.
| Type: | AuthenticationMechanism |
| Accepted values: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 Get-ItemGet-ChildItem Befehl oder den Befehl im PowerShell Cert: Laufwerk.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 ComputerName-Parameters zu verwenden, muss der Befehl den Parameter "Anmeldeinformationen " 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 in about_Remote_Troubleshooting unter "Hinzufügen eines Computers zur vertrauenswürdigen Hostliste".
Hinweis: In Windows Vista und späteren Versionen des Windows-Betriebssystems müssen Sie PowerShell mit der Option "Als Administrator ausführen" starten, um den lokalen Computer im Wert des Parameters " ComputerName " einzuschließen.
| Type: | String |
| Aliases: | Cn |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 vorgestellt: http://schemas.microsoft.com/powershell
Bei Verwendung mit SSH gibt dies das Subsystem an, das im sshd_config definierten Ziel verwendet werden soll. Der Standardwert für SSH ist das powershell Subsystem.
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 $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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 zur Angabe der ConnectionURI-Werte verwenden.
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 AllowRedirection-Parameter im Befehl.
| Type: | Uri |
| Aliases: | URI, CU |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ContainerId
Gibt die ID eines Containers an.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 "Domäne01\User01", oder geben Sie ein vom Cmdlet generiertes Get-CredentialPSCredential-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 SecureString-Datenschutz finden Sie unter Wie sicher ist SecureString?.
| Type: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EnableNetworkAccess
Gibt an, dass dieses Cmdlet ein interaktives Sicherheitstoken zu Loopbacksitzungen hinzufügt. 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, müssen Sie den ComputerName-Parameter auslassen oder seinen Wert auf festlegen. (punkt), localhost oder der Name des lokalen Computers.
Standardmäßig werden Loopbacksitzungen mithilfe eines Netzwerktokens erstellt, die möglicherweise keine ausreichende Berechtigung zum Authentifizieren bei Remotecomputern bieten.
Der EnableNetworkAccess-Parameter ist nur bei 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 auch Remotezugriff in einer Loopbacksitzung erlauben, indem Sie den CredSSP-Wert des Authentication-Parameters verwenden, der die Anmeldeinformationen für die Sitzung an andere Computer delegiert.
Dieser Parameter wurde in Windows PowerShell 3.0 eingeführt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostName
Gibt einen Computernamen für eine secure Shell (SSH) basierte Verbindung an. Dies ähnelt dem ComputerName-Parameter , außer dass die Verbindung mit dem Remotecomputer mit SSH statt Windows WinRM hergestellt wird. Dieser Parameter unterstützt die Angabe des Benutzernamens und/oder des Portes als Teil des Parameterwerts des Hostnamens mithilfe des Formulars user@hostname:port. Der als Teil des Hostnamens angegebene Benutzername und/oder Port hat Vorrang vor den -UserName-Port und parametern, sofern angegeben. Dadurch können mehrere Computernamen an diesen Parameter übergeben werden, bei denen einige bestimmte Benutzernamen und/oder Ports haben, während andere den Benutzernamen und/oder den Port aus den -UserName und -Port den Parametern verwenden.
Dieser Parameter wurde in PowerShell 6.0 eingeführt.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Id
Gibt die ID einer vorhandenen Sitzung an. Enter-PSSession verwendet die angegebene Sitzung für die interaktive Sitzung.
Um die ID einer Sitzung zu finden, verwenden Sie das Get-PSSession Cmdlet.
| Type: | Int32 |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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. Um die Instanz-ID einer Sitzung zu finden, verwenden Sie das Get-PSSession Cmdlet. Sie können auch die Parameter "Sitzung", "Name" oder " ID " verwenden, um eine vorhandene Sitzung anzugeben. Sie können auch den ComputerName-Parameter verwenden, um eine temporäre Sitzung zu starten.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-KeyFilePath
Gibt einen Schlüsseldateipfad an, der von Secure Shell (SSH) zum Authentifizieren eines Benutzers auf einem Remotecomputer verwendet wird.
SSH ermöglicht die Benutzerauthentifizierung über private/öffentliche Schlüssel als Alternative zur grundlegenden Kennwortauthentifizierung. Wenn der Remotecomputer für die Schlüsselauthentifizierung konfiguriert ist, kann dieser Parameter verwendet werden, um den Schlüssel bereitzustellen, der den Benutzer identifiziert.
Dieser Parameter wurde in PowerShell 6.0 eingeführt.
| Type: | String |
| Aliases: | IdentityFilePath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 "Sitzung", " InstanzID" 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Port
Gibt den Netzwerkport auf dem Remotecomputer an, der für diesen Befehl verwendet wird.
In PowerShell 6.0 wurde dieser Parameter im HostName-Parametersatz inlcudiert, der Secure Shell -Verbindungen (SSH) unterstützt.
WinRM (ComputerName-Parametersatz)
Zum Herstellen einer Verbindung mit einem Remotecomputer muss der Remotecomputer den für die Verbindung verwendeten Port abhören. Die Standardports sind 5985, was der WinRM-Port für HTTP und 5986 ist, der winRM-Port für HTTPS ist.
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 nur, wenn es unbedingt notwendig ist. 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.
SSH (HostName-Parametersatz)
Um eine Verbindung mit einem Remotecomputer herzustellen, muss der Remotecomputer mit dem SSH-Dienst (SSHD) konfiguriert werden und auf dem Port hören, den die Verbindung verwendet. Der Standardport für SSH ist 22.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsAdministrator
Gibt an, dass die PSSession als Administrator ausgeführt wird.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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. ein New-PSSession oder Get-PSSession einen Befehl. Sie können auch ein Sitzungsobjekt an Enter-PSSession. Sie können nur eine PSSession mit diesem Parameter übermitteln. Wenn Sie eine Variable eingeben, die mehrere PSSession enthält, schlägt der Befehl fehl.
Wenn Sie das EXIT-Schlüsselwort verwenden oder das EXIT-Schlüsselwort verwendenExit-PSSession, endet die interaktive Sitzung, aber die von Ihnen erstellte PSSession bleibt offen und für die Verwendung verfügbar.
| Type: | PSSession |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 die Schlüssel Sitzungsoptionsnamen sind und die Werte Sitzungsoptionswerte sind.
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. Allerdings haben sie nicht Vorrang vor Höchstwerten, Kontingenten oder Grenzwerten, die in der Sitzungskonfiguration festgelegt sind.
Eine Beschreibung der Sitzungsoptionen, einschließlich der Standardwerte, finden Sie unter New-PSSessionOption.
Informationen zur $PSSessionOption Einstellungsvariable finden Sie unter about_Preference_Variables. Weitere Informationen zu Sitzungskonfigurationen finden Sie unter about_Session_Configurations.
| Type: | PSSessionOption |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SSHTransport
Gibt an, dass die Remoteverbindung mithilfe von Secure Shell (SSH) hergestellt wird.
Standardmäßig verwendet PowerShell Windows WinRM, um eine Verbindung mit einem Remotecomputer herzustellen. Dieser Switch erzwingt PowerShell, den HostName-Parameter für die Einrichtung einer SSH-basierten Remoteverbindung zu verwenden.
Dieser Parameter wurde in PowerShell 6.0 eingeführt.
| Type: | SwitchParameter |
| Accepted values: | true |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subsystem
Gibt das SSH-Subsystem an, das für die neue PSSession verwendet wird.
Dies gibt das Subsystem an, das für das Ziel verwendet werden soll, wie in sshd_config definiert. Das Subsystem startet eine bestimmte Version von PowerShell mit vordefinierten Parametern. Wenn das angegebene Subsystem nicht auf dem Remotecomputer vorhanden ist, schlägt der Befehl fehl.
Wenn dieser Parameter nicht verwendet wird, ist der Standardwert das Powershell-Subsystem.
| Type: | String |
| Position: | Named |
| Default value: | powershell |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UserName
Gibt den Benutzernamen für das Konto an, das zum Erstellen einer Sitzung auf dem Remotecomputer verwendet wird. Die Benutzerauthentifizierungsmethode hängt davon ab, wie Secure Shell (SSH) auf dem Remotecomputer konfiguriert ist.
Wenn SSH für die grundlegende Kennwortauthentifizierung konfiguriert ist, werden Sie zur Eingabe des Benutzerkennworts aufgefordert.
Wenn SSH für die schlüsselbasierte Benutzerauthentifizierung konfiguriert ist, kann über den KeyFilePath-Parameter ein Schlüsseldateipfad bereitgestellt werden, und es tritt keine Kennwortaufforderung auf. Beachten Sie, dass, wenn sich die Clientbenutzerschlüsseldatei an einem bekannten SSH-Speicherort befindet, der KeyFilePath-Parameter für die schlüsselbasierte Authentifizierung nicht benötigt wird, und die Benutzerauthentifizierung wird automatisch basierend auf dem Benutzernamen ausgeführt. Weitere Informationen finden Sie in der SSH-Dokumentation zur schlüsselbasierten Benutzerauthentifizierung.
Dies ist kein erforderlicher Parameter. Wenn kein UserName-Parameter angegeben wird, wird der aktuelle Anmeldename für die Verbindung verwendet.
Dieser Parameter wurde in PowerShell 6.0 eingeführt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 PowerShell-Inhalte, die über das Netzwerk übertragen werden. Der UseSSL-Parameter ist ein zusätzlicher Schutz, der die Daten über eine HTTPS-Verbindung anstelle einer 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMId
Gibt die ID eines virtuellen Computers an.
| Type: | Guid |
| Aliases: | VMGuid |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMName
Gibt den Namen eines virtuellen Computers an.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Eingaben
System.String, System.Management.Automation.Runspaces.PSSession
Sie können einen Computernamen, als Zeichenfolge oder ein Sitzungsobjekt an dieses Cmdlet weiterleiten.
Ausgaben
None
Das Cmdlet gibt keine Ausgabe zurück.
Hinweise
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.
Wenn Sie das Benutzerprofil auf dem Remotecomputer verwenden Enter-PSSession, wird das Benutzerprofil 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. Um die lokale Benutzeroberflächenkultur zu finden, verwenden Sie die $UICulture automatische Variable.
Enter-PSSessionerfordert die , Out-Defaultund Exit-PSSession CmdletsGet-Command. Wenn diese Cmdlets nicht in der Sitzungskonfiguration auf dem Remotecomputer enthalten sind, schlägt der Enter-PSSession Befehl fehl.
Im Gegensatz Invoke-Commanddazu, welche Befehle analysiert und interpretiert werden, bevor sie an den Remotecomputer gesendet werden, Enter-PSSession sendet die Befehle direkt an den Remotecomputer ohne Interpretation.
Wenn die sitzung, die Sie eingeben möchten, eine Befehlsverarbeitung beschäftigt ist, kann es eine Verzögerung geben, bevor PowerShell auf den Enter-PSSession Befehl reagiert. Sobald die Sitzung verfügbar ist, sind Sie verbunden. Drücken Sie STRG+C, um den Enter-PSSession Befehl abzubrechen.
Der Parametersatz "HostName " wurde ab PowerShell 6.0 enthalten. Es wurde hinzugefügt, um PowerShell-Remoting basierend auf Secure Shell (SSH) bereitzustellen. Sowohl SSH als auch PowerShell werden auf mehreren Plattformen (Windows, Linux, macOS) und PowerShell-Remoting über diese Plattformen unterstützt, auf denen PowerShell und SSH installiert und konfiguriert sind. Dies unterscheidet sich von der vorherigen Windows-Nur-Remoting, die auf WinRM basiert und viele der winRM-spezifischen Features und Einschränkungen gelten nicht. WinRM-basierte Kontingente, Sitzungsoptionen, benutzerdefinierte Endpunktkonfiguration und Verbindungsfeatures werden derzeit nicht unterstützt. Weitere Informationen zum Einrichten von PowerShell SSH-Remoting finden Sie unter PowerShell Remoting Over SSH.
Vor PowerShell 7.1 unterstützte das Remoting über SSH keine Remotesitzungen über einen zweiten Hop. Diese Funktion war auf Sitzungen beschränkt, die WinRM verwendeten. PowerShell 7.1 ermöglicht, dass Enter-PSSession und Enter-PSHostProcess in jeder interaktiven Remotesitzung funktionieren.