Enter-PSSession
Start een interactieve sessie met een externe computer.
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>
[-Options <Hashtable>]
[-Port <Int32>]
[-UserName <String>]
[-KeyFilePath <String>]
[-Subsystem <String>]
[-ConnectingTimeout <Int32>]
[-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>]Description
De Enter-PSSession cmdlet start een interactieve sessie met één externe computer.
Tijdens de sessie worden de opdrachten die u typt, uitgevoerd op de externe computer, net zoals wanneer u rechtstreeks op de externe computer typt. U kunt slechts één interactieve sessie tegelijk hebben.
Normaal gesproken gebruikt u de parameter ComputerName om de naam van de externe computer op te geven.
U kunt echter ook een sessie gebruiken die u maakt met behulp van de New-PSSession cmdlet voor de interactieve sessie. U kunt de , Connect-PSSessionof Receive-PSSession cmdlets echter niet gebruiken om de Disconnect-PSSessionverbinding met een interactieve sessie te verbreken of opnieuw verbinding te maken.
Vanaf PowerShell 6.0 kunt u Secure Shell (SSH) gebruiken om verbinding te maken met een externe computer, als SSH beschikbaar is op de lokale computer en de externe computer is geconfigureerd met een PowerShell SSH-eindpunt. Het voordeel van een externe PowerShell-sessie op basis van SSH is dat deze werkt op meerdere platforms (Windows, Linux, macOS). Voor externe communicatie op basis van SSH gebruikt u de parameter HostName die is ingesteld om de externe computer en relevante verbindingsgegevens op te geven. Zie externe communicatie van PowerShell via SSH voor meer informatie over het instellen van externe communicatie van PowerShell via SSH.
Als u de interactieve sessie wilt beëindigen en de verbinding met de externe computer wilt verbreken, gebruikt u de Exit-PSSession cmdlet of typt exitu.
Voorbeelden
Voorbeeld 1: Een interactieve sessie starten
PS> Enter-PSSession
[localhost]: PS>Met deze opdracht start u een interactieve sessie op de lokale computer. De opdrachtprompt verandert om aan te geven dat u nu opdrachten uitvoert in een andere sessie.
De opdrachten die u invoert, worden uitgevoerd in de nieuwe sessie en de resultaten worden als tekst geretourneerd naar de standaardsessie.
Voorbeeld 2: Werken met een interactieve sessie
De eerste opdracht gebruikt de Enter-PSSession cmdlet om een interactieve sessie te starten met Server01, een externe computer. Wanneer de sessie wordt gestart, verandert de opdrachtprompt om de computernaam op te nemen.
Met de tweede opdracht wordt het PowerShell-proces opgeslagen en wordt de uitvoer omgeleid naar het Process.txt bestand.
De opdracht wordt verzonden naar de externe computer en het bestand wordt opgeslagen op de externe computer.
De derde opdracht maakt gebruik van het trefwoord Afsluiten om de interactieve sessie te beëindigen en de verbinding te sluiten.
Met de vierde opdracht wordt bevestigd dat het Process.txt bestand zich op de externe computer bevindt. Een Get-ChildItem (dir)-opdracht op de lokale computer kan het bestand niet vinden.
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.txtDeze opdracht laat zien hoe u in een interactieve sessie met een externe computer kunt werken.
Voorbeeld 3: de sessieparameter gebruiken
PS> $s = New-PSSession -ComputerName Server01
PS> Enter-PSSession -Session $s
[Server01]: PS>Deze opdrachten gebruiken de sessieparameter om Enter-PSSession de interactieve sessie uit te voeren in een bestaande PowerShell-sessie (PSSession).
Voorbeeld 4: Een interactieve sessie starten en de poort- en referentieparameters opgeven
PS> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS>Met deze opdracht start u een interactieve sessie met de Server01-computer. Hierbij wordt de poortparameter gebruikt om de poort en de referentieparameter op te geven om het account op te geven van een gebruiker die gemachtigd is om verbinding te maken met de externe computer.
Voorbeeld 5: Een interactieve sessie stoppen
PS> Enter-PSSession -ComputerName Server01
[Server01]: PS> Exit-PSSession
PS>In dit voorbeeld ziet u hoe u een interactieve sessie start en stopt. De eerste opdracht gebruikt de Enter-PSSession cmdlet om een interactieve sessie met de Server01-computer te starten.
De tweede opdracht gebruikt de Exit-PSSession cmdlet om de sessie te beëindigen. U kunt ook het trefwoord Afsluiten gebruiken om de interactieve sessie te beëindigen. Exit-PSSession en Exit hebben hetzelfde effect.
Voorbeeld 6: Een interactieve sessie starten met behulp van SSH
PS> Enter-PSSession -HostName UserA@LinuxServer01In dit voorbeeld ziet u hoe u een interactieve sessie start met behulp van Secure Shell (SSH). Als SSH is geconfigureerd op de externe computer om wachtwoorden te gebruiken, wordt u gevraagd een wachtwoord in te voeren. Anders moet u verificatie op basis van sleutels gebruiken.
Voorbeeld 7: Een interactieve sessie starten met behulp van SSH met een poort- en gebruikersverificatiesleutel
PS> Enter-PSSession -HostName UserA@LinuxServer02:22 -KeyFilePath c:\sshkeys\userAKey_rsaIn dit voorbeeld ziet u hoe u een interactieve sessie start met behulp van SSH. De gebruikersnaam en het SSH-poortnummer worden opgegeven als onderdelen van de waarde van de parameter HostName . De parameter KeyFilePath geeft de locatie op van een RSA-sleutel die wordt gebruikt om de gebruiker op de externe computer te verifiëren.
Voorbeeld 8: Een interactieve sessie starten met behulp van SSH-opties
$options = @{
Port=22
User = 'UserA'
Host = 'LinuxServer02'
}
Enter-PSSession -KeyFilePath c:\sshkeys\userAKey_rsa -Options $optionsIn dit voorbeeld ziet u hoe u een interactieve sessie start met behulp van SSH. De parameter Opties gebruikt een hashtabel met waarden die als opties worden doorgegeven aan de onderliggende ssh opdracht waarmee de verbinding met het externe systeem tot stand is gebracht.
Parameters
-AllowRedirection
Hiermee wordt omleiding van deze verbinding naar een alternatieve URI (Uniform Resource Identifier) toegestaan. Standaard is omleiding niet toegestaan.
Wanneer u de parameter Verbinding maken ionURI gebruikt, kan de externe bestemming een instructie retourneren om om te leiden naar een andere URI. PowerShell leidt standaard geen verbindingen om, maar u kunt deze parameter gebruiken om de verbinding om te leiden.
U kunt ook het aantal keren beperken dat de verbinding wordt omgeleid door de optiewaarde Maximum Verbinding maken ionRedirectionCount-sessie te wijzigen. Gebruik de parameter MaximumRedirection van de New-PSSessionOption cmdlet of stel de eigenschap Maximum Verbinding maken ionRedirectionCount van de $PSSessionOption voorkeursvariabele in. De standaardwaarde is 5.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationName
Hiermee geeft u het naamsegment van de toepassing van de verbindings-URI. Gebruik deze parameter om de naam van de toepassing op te geven wanneer u de parameter Verbinding maken ionURI niet in de opdracht gebruikt.
De standaardwaarde is de waarde van de $PSSessionApplicationName voorkeursvariabele op de lokale computer. Als deze voorkeursvariabele niet is gedefinieerd, is de standaardwaarde WSMAN. Deze waarde is geschikt voor de meeste toepassingen. Zie about_Preference_Variables voor meer informatie.
De WinRM-service gebruikt de naam van de toepassing om een listener te selecteren voor de service van de verbindingsaanvraag. De waarde van deze parameter moet overeenkomen met de waarde van de eigenschap URLPrefix van een listener op de externe computer.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Authentication
Hiermee geeft u het mechanisme op dat wordt gebruikt om de referenties van de gebruiker te verifiëren. De aanvaardbare waarden voor deze parameter zijn:
- Standaardinstelling
- Basis
- Credssp
- Digest
- Kerberos
- Onderhandelen
- NegotiateWithImplicitCredential
De standaardwaarde is Standaard.
CredSSP-verificatie is alleen beschikbaar in Windows Vista, Windows Server 2008 en latere versies van het Windows-besturingssysteem.
Zie AuthenticationMechanism Enum voor meer informatie over de waarden van deze parameter.
Let op
CredSSP-verificatie (Credential Security Support Provider), waarbij de referenties van de gebruiker worden doorgegeven aan een externe computer die moet worden geverifieerd, is ontworpen voor opdrachten waarvoor verificatie is vereist voor meer dan één resource, zoals toegang tot een externe netwerkshare. Dit mechanisme verhoogt het beveiligingsrisico van de externe bewerking. Als de externe computer is aangetast, kunnen de referenties die aan de computer worden doorgegeven, worden gebruikt om de netwerksessie te beheren.
| 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
Hiermee geeft u het certificaat van de digitale openbare sleutel (X509) van een gebruikersaccount dat gemachtigd is om deze actie uit te voeren. Voer de vingerafdruk van het certificaat in.
Certificaten worden gebruikt in verificatie op basis van clientcertificaten. Ze kunnen alleen worden toegewezen aan lokale gebruikersaccounts; ze werken niet met domeinaccounts.
Als u een certificaat wilt ophalen, gebruikt u de Get-Item of Get-ChildItem opdracht in het PowerShell-certificaat: station.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Hiermee geeft u een computernaam. Met deze cmdlet wordt een interactieve sessie gestart met de opgegeven externe computer. Voer slechts één computernaam in. Standaard is dit de lokale computer.
Typ de NetBIOS-naam, het IP-adres of de volledig gekwalificeerde domeinnaam van de computer. U kunt ook een computernaam doorsluisen naar Enter-PSSession.
Als u een IP-adres wilt gebruiken in de waarde van de parameter ComputerName , moet de opdracht de referentieparameter bevatten. De computer moet ook worden geconfigureerd voor HTTPS-transport of het IP-adres van de externe computer moet worden opgenomen in de winRM TrustedHosts-lijst op de lokale computer. Zie 'How to Add a Computer to the Trusted Host List' (Een computer toevoegen aan de lijst met vertrouwde hosts) in about_Remote_Troubleshooting voor instructies voor het toevoegen van een computernaam aan de lijst TrustedHosts.
Notitie
Als u op het Windows-besturingssysteem de lokale computer wilt opnemen in de waarde van de parameter ComputerName , moet u PowerShell starten met de optie Uitvoeren als administrator.
| Type: | String |
| Aliases: | Cn |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ConfigurationName
Hiermee geeft u de sessieconfiguratie op die wordt gebruikt voor de interactieve sessie.
Voer een configuratienaam of de volledig gekwalificeerde resource-URI in voor een sessieconfiguratie. Als u alleen de configuratienaam opgeeft, wordt de volgende schema-URI voorafgegaan: http://schemas.microsoft.com/powershell
Wanneer het wordt gebruikt met SSH, geeft dit het subsysteem op dat moet worden gebruikt voor het doel zoals gedefinieerd in sshd_config. De standaardwaarde voor SSH is het powershell subsysteem.
De sessieconfiguratie voor een sessie bevindt zich op de externe computer. Als de opgegeven sessieconfiguratie niet bestaat op de externe computer, mislukt de opdracht.
De standaardwaarde is de waarde van de $PSSessionConfigurationName voorkeursvariabele op de lokale computer. Als deze voorkeursvariabele niet is ingesteld, is microsoft.PowerShell de standaardinstelling. Zie about_Preference_Variables voor meer informatie.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ConnectingTimeout
Hiermee geeft u de hoeveelheid tijd in milliseconden op die is toegestaan voor de eerste SSH-verbinding. Als de verbinding niet binnen de opgegeven tijd is voltooid, wordt er een fout geretourneerd.
Deze parameter is geïntroduceerd in PowerShell 7.2
| Type: | Int32 |
| Position: | Named |
| Default value: | unlimited |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionUri
Hiermee geeft u een URI op waarmee het verbindingseindpunt voor de sessie wordt gedefinieerd. De URI moet volledig gekwalificeerd zijn. De notatie van deze tekenreeks is als volgt:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
De standaardwaarde is als volgt:
http://localhost:5985/WSMAN
Als u geen Verbinding maken ionURI opgeeft, kunt u de parameters UseSSL, ComputerName, Port en ApplicationName gebruiken om de Verbinding maken URI-waarden op te geven.
Geldige waarden voor het transportsegment van de URI zijn HTTP en HTTPS. Als u een verbindings-URI met een transportsegment opgeeft, maar geen poort opgeeft, wordt de sessie gemaakt met behulp van standaardenpoorten: 80 voor HTTP en 443 voor HTTPS. Als u de standaardpoorten voor externe communicatie met PowerShell wilt gebruiken, geeft u poort 5985 op voor HTTP of 5986 voor HTTPS.
Als de doelcomputer de verbinding omleidt naar een andere URI, voorkomt PowerShell de omleiding, tenzij u de parameter AllowRedirection in de opdracht gebruikt.
| Type: | Uri |
| Aliases: | URI, CU |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ContainerId
Hiermee geeft u de id van een container.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Credential
Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. Standaard is dit de huidige gebruiker.
Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in dat is gegenereerd door de Get-Credential cmdlet. Als u een gebruikersnaam typt, wordt u gevraagd het wachtwoord in te voeren.
Referenties worden opgeslagen in een PSCredential-object en het wachtwoord wordt opgeslagen als SecureString.
Notitie
Zie Hoe veilig is SecureString SecureString?voor meer informatie over SecureString-gegevensbeveiliging.
| Type: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EnableNetworkAccess
Geeft aan dat deze cmdlet een interactief beveiligingstoken toevoegt aan loopbacksessies. Met het interactieve token kunt u opdrachten uitvoeren in de loopbacksessie waarmee gegevens van andere computers worden opgehaald. U kunt bijvoorbeeld een opdracht uitvoeren in de sessie waarmee XML-bestanden van een externe computer naar de lokale computer worden gekopieerd.
Een loopbacksessie is een PSSession die afkomstig is en eindigt op dezelfde computer. Als u een loopback-sessie wilt maken, laat u de parameter ComputerName weg of stelt u de waarde ervan in op . (dot), localhost of de naam van de lokale computer.
Loopbacksessies worden standaard gemaakt met behulp van een netwerktoken, wat mogelijk onvoldoende machtigingen biedt voor verificatie bij externe computers.
De parameter EnableNetworkAccess is alleen van kracht in loopbacksessies. Als u EnableNetworkAccess gebruikt wanneer u een sessie op een externe computer maakt, slaagt de opdracht, maar wordt de parameter genegeerd.
U kunt ook externe toegang in een loopbacksessie toestaan met behulp van de CredSSP-waarde van de verificatieparameter , waarmee de sessiereferenties worden gedelegeerd aan andere computers.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostName
Hiermee geeft u een computernaam op voor een SSH-verbinding (Secure Shell). Dit is vergelijkbaar met de parameter ComputerName , behalve dat de verbinding met de externe computer wordt gemaakt met behulp van SSH in plaats van Windows WinRM. Deze parameter ondersteunt het opgeven van de gebruikersnaam en/of poort als onderdeel van de parameterwaarde van de hostnaam met behulp van het formulier user@hostname:port. De gebruikersnaam en/of poort die zijn opgegeven als onderdeel van de hostnaam hebben voorrang op de -UserName en -Port parameters, indien opgegeven. Hierdoor kunnen meerdere computernamen worden doorgegeven aan deze parameter waarbij sommige specifieke gebruikersnamen en/of poorten hebben, terwijl anderen de gebruikersnaam en/of poort van de -UserName en -Port parameters gebruiken.
Deze parameter is geïntroduceerd in PowerShell 6.0.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Id
Hiermee geeft u de id van een bestaande sessie. Enter-PSSession gebruikt de opgegeven sessie voor de interactieve sessie.
Gebruik de Get-PSSession cmdlet om de id van een sessie te vinden.
| Type: | Int32 |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InstanceId
Hiermee geeft u de exemplaar-id van een bestaande sessie. Enter-PSSession gebruikt de opgegeven sessie voor de interactieve sessie.
De exemplaar-id is een GUID. Gebruik de Get-PSSession cmdlet om de exemplaar-id van een sessie te vinden. U kunt ook de parameters Sessie, Naam of ID gebruiken om een bestaande sessie op te geven. U kunt ook de parameter ComputerName gebruiken om een tijdelijke sessie te starten.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-KeyFilePath
Hiermee geeft u een sleutelbestandspad op dat wordt gebruikt door Secure Shell (SSH) om een gebruiker op een externe computer te verifiëren.
Met SSH kan gebruikersverificatie worden uitgevoerd via persoonlijke/openbare sleutels als alternatief voor basiswachtwoordverificatie. Als de externe computer is geconfigureerd voor sleutelverificatie, kan deze parameter worden gebruikt om de sleutel op te geven die de gebruiker identificeert.
Deze parameter is geïntroduceerd in PowerShell 6.0.
| Type: | String |
| Aliases: | IdentityFilePath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Hiermee geeft u de beschrijvende naam van een bestaande sessie. Enter-PSSession gebruikt de opgegeven sessie voor de interactieve sessie.
Als de naam die u opgeeft overeenkomt met meer dan één sessie, mislukt de opdracht. U kunt ook de parameters Sessie, InstanceID of ID gebruiken om een bestaande sessie op te geven. U kunt ook de parameter ComputerName gebruiken om een tijdelijke sessie te starten.
Als u een beschrijvende naam voor een sessie wilt instellen, gebruikt u de parameter Name van de New-PSSession cmdlet.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Options
Hiermee geeft u een hashtabel op van SSH-opties die worden gebruikt bij het maken van verbinding met een externe SSH-sessie. De mogelijke opties zijn waarden die worden ondersteund door de Unix-versie van de ssh-opdracht .
Alle waarden die expliciet door parameters worden doorgegeven, hebben voorrang op waarden die zijn doorgegeven in de hashtabel Opties . Als u bijvoorbeeld de poortparameter gebruikt, worden alle Port sleutel-waardeparen overschreven die zijn doorgegeven in de hashtabel Opties .
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Port
Hiermee geeft u de netwerkpoort op de externe computer die wordt gebruikt voor deze opdracht.
In PowerShell 6.0 is deze parameter opgenomen in de hostnaamparameterset die SSH-verbindingen (Secure Shell) ondersteunt.
WinRM (computernaamparameterset)
Als u verbinding wilt maken met een externe computer, moet de externe computer luisteren op de poort die door de verbinding wordt gebruikt. De standaardpoorten zijn 5985, de WinRM-poort voor HTTP en 5986, de WinRM-poort voor HTTPS.
Voordat u een alternatieve poort gebruikt, moet u de WinRM-listener op de externe computer configureren om naar die poort te luisteren. Gebruik de volgende opdrachten om de listener te configureren:
winrm delete winrm/config/listener?Address=*+Transport=HTTPwinrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}
Gebruik de poortparameter alleen als u dit moet doen. De poortinstelling in de opdracht is van toepassing op alle computers of sessies waarop de opdracht wordt uitgevoerd. Een alternatieve poortinstelling kan verhinderen dat de opdracht wordt uitgevoerd op alle computers.
SSH (hostnaamparameterset)
Als u verbinding wilt maken met een externe computer, moet de externe computer worden geconfigureerd met de SSH-service (SSHD) en moet deze luisteren op de poort die door de verbinding wordt gebruikt. De standaardpoort voor SSH is 22.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsAdministrator
Geeft aan dat de PSSession als beheerder wordt uitgevoerd.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Session
Hiermee geeft u een PowerShell-sessie (PSSession) op die moet worden gebruikt voor de interactieve sessie. Deze parameter gebruikt een sessieobject. U kunt ook de parameters Name, InstanceID of ID gebruiken om een PSSession op te geven.
Voer een variabele in die een sessieobject of een opdracht bevat waarmee een sessieobject wordt gemaakt of opgehaald, zoals een New-PSSession of Get-PSSession opdracht. U kunt ook een sessieobject doorsluisen naar Enter-PSSession. U kunt slechts één PSSession verzenden met behulp van deze parameter. Als u een variabele invoert die meer dan één PSSession bevat, mislukt de opdracht.
Wanneer u of het trefwoord AFSLUITEN gebruiktExit-PSSession, wordt de interactieve sessie beëindigd, maar blijft de PSSession die u hebt gemaakt geopend en beschikbaar voor gebruik.
| Type: | PSSession |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SessionOption
Hiermee stelt u geavanceerde opties voor de sessie in. Voer een SessionOption-object in, zoals een object dat u maakt met behulp van de New-PSSessionOption cmdlet of een hash-tabel waarin de sleutels namen van sessieopties zijn en de waarden sessieoptiewaarden zijn.
De standaardwaarden voor de opties worden bepaald door de waarde van de $PSSessionOption voorkeursvariabele, als deze is ingesteld. Anders worden de standaardwaarden ingesteld op basis van opties die zijn ingesteld in de sessieconfiguratie.
De waarden voor sessieopties hebben voorrang op standaardwaarden voor sessies die zijn ingesteld in de $PSSessionOption voorkeursvariabele en in de sessieconfiguratie. Ze hebben echter geen voorrang op maximumwaarden, quota of limieten die zijn ingesteld in de sessieconfiguratie.
Zie voor een beschrijving van de sessieopties, inclusief de standaardwaarden.New-PSSessionOption
Zie about_Preference_Variables voor meer informatie over de $PSSessionOption voorkeursvariabele. Zie about_Session_Configurations (Engelstalig) voor meer informatie over sessieconfiguraties.
| Type: | PSSessionOption |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SSHTransport
Geeft aan dat de externe verbinding tot stand is gebracht met behulp van Secure Shell (SSH).
PowerShell maakt standaard gebruik van Windows WinRM om verbinding te maken met een externe computer. Deze schakeloptie dwingt PowerShell om de hostnaamparameterset te gebruiken voor het tot stand brengen van een externe verbinding op basis van SSH.
Deze parameter is geïntroduceerd in PowerShell 6.0.
| Type: | SwitchParameter |
| Accepted values: | true |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subsystem
Hiermee geeft u het SSH-subsysteem dat wordt gebruikt voor de nieuwe PSSession.
Hiermee geeft u het subsysteem op dat moet worden gebruikt voor het doel zoals gedefinieerd in sshd_config. Het subsysteem start een specifieke versie van PowerShell met vooraf gedefinieerde parameters. Als het opgegeven subsysteem niet bestaat op de externe computer, mislukt de opdracht.
Als deze parameter niet wordt gebruikt, is de standaardwaarde het powershell-subsysteem.
| Type: | String |
| Position: | Named |
| Default value: | Powershell |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UserName
Hiermee geeft u de gebruikersnaam voor het account dat wordt gebruikt voor het maken van een sessie op de externe computer. De verificatiemethode voor gebruikers is afhankelijk van de manier waarop Secure Shell (SSH) is geconfigureerd op de externe computer.
Als SSH is geconfigureerd voor basiswachtwoordverificatie, wordt u gevraagd om het gebruikerswachtwoord.
Als SSH is geconfigureerd voor gebruikersverificatie op basis van sleutels, kan er een sleutelbestandspad worden opgegeven via de parameter KeyFilePath en wordt er geen wachtwoordprompt weergegeven. Houd er rekening mee dat als het clientgebruikerssleutelbestand zich op een bekende SSH-locatie bevindt, de parameter KeyFilePath niet nodig is voor verificatie op basis van sleutels en dat gebruikersverificatie automatisch plaatsvindt op basis van de gebruikersnaam. Zie de SSH-documentatie over gebruikersverificatie op basis van sleutels voor meer informatie.
Dit is geen vereiste parameter. Als er geen username-parameter is opgegeven, wordt de huidige gebruikersnaam gebruikt voor de verbinding.
Deze parameter is geïntroduceerd in PowerShell 6.0.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseSSL
Geeft aan dat deze cmdlet gebruikmaakt van het SSL-protocol (Secure Sockets Layer) om een verbinding met de externe computer tot stand te brengen. Standaard wordt SSL niet gebruikt.
WS-Management versleutelt alle PowerShell-inhoud die via het netwerk wordt verzonden. De UseSSL-parameter is een extra beveiliging waarmee de gegevens via een HTTPS-verbinding worden verzonden in plaats van een HTTP-verbinding.
Als u deze parameter gebruikt, maar SSL niet beschikbaar is op de poort die wordt gebruikt voor de opdracht, mislukt de opdracht.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMId
Hiermee geeft u de id van een virtuele machine.
| Type: | Guid |
| Aliases: | VMGuid |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMName
Hiermee geeft u de naam van een virtuele machine.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Invoerwaarden
U kunt een computernaam doorsluisen als een tekenreeks naar deze cmdlet.
U kunt een sessieobject doorsluisen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert geen uitvoer.
Notities
PowerShell bevat de volgende aliassen voor Enter-PSSession:
- Alle platforms:
etsn
Als u verbinding wilt maken met een externe computer, moet u lid zijn van de groep Beheer istrators op de externe computer. Als u een interactieve sessie op de lokale computer wilt starten, moet u PowerShell starten met de optie Als administrator uitvoeren .
Wanneer u gebruikt Enter-PSSession, wordt uw gebruikersprofiel op de externe computer gebruikt voor de interactieve sessie. De opdrachten in het profiel voor externe gebruikers, inclusief opdrachten om PowerShell-modules toe te voegen en de opdrachtprompt te wijzigen, moet u uitvoeren voordat de externe prompt wordt weergegeven.
Enter-PSSession gebruikt de cultuurinstelling van de gebruikersinterface op de lokale computer voor de interactieve sessie. Gebruik de automatische variabele om de $UICulture lokale UI-cultuur te vinden.
Enter-PSSession vereist de Get-Command, Out-Defaulten Exit-PSSession cmdlets. Als deze cmdlets niet zijn opgenomen in de sessieconfiguratie op de externe computer, mislukken de Enter-PSSession opdrachten.
In tegenstelling tot Invoke-Command, die de opdrachten parseert en interpreteert voordat deze naar de externe computer worden verzonden, Enter-PSSession verzendt u de opdrachten rechtstreeks naar de externe computer zonder interpretatie.
Als de sessie die u wilt invoeren bezig is met het verwerken van een opdracht, kan er een vertraging optreden voordat PowerShell op de Enter-PSSession opdracht reageert. U bent verbonden zodra de sessie beschikbaar is. Als u de Enter-PSSession opdracht wilt annuleren, drukt u op Ctrl+C.
De hostnaamparameterset is opgenomen vanaf PowerShell 6.0. Het is toegevoegd om externe communicatie van PowerShell te bieden op basis van Secure Shell (SSH). SSH en PowerShell worden ondersteund op meerdere platforms (Windows, Linux, macOS) en externe communicatie van PowerShell via deze platforms waarop PowerShell en SSH zijn geïnstalleerd en geconfigureerd. Dit is gescheiden van de vorige windows alleen externe communicatie die is gebaseerd op WinRM en veel van de WinRM-specifieke functies en beperkingen zijn niet van toepassing. Op WinRM gebaseerde quota, sessieopties, aangepaste eindpuntconfiguratie en functies voor verbinding verbreken/opnieuw verbinden worden momenteel niet ondersteund. Zie externe communicatie van PowerShell via SSH voor meer informatie over het instellen van externe communicatie van PowerShell via SSH.
Voorafgaand aan PowerShell 7.1 biedt externe communicatie via SSH geen ondersteuning voor externe sessies van de tweede hop. Deze mogelijkheid is beperkt tot sessies met Behulp van WinRM. Met PowerShell 7.1 kunt Enter-PSSession u Enter-PSHostProcess werken vanuit een interactieve externe sessie.
Het ssh uitvoerbare bestand haalt configuratiegegevens op uit de volgende bronnen in de volgende volgorde:
- opdrachtregelopties
- configuratiebestand van gebruiker (~/.ssh/config)
- configuratiebestand voor het hele systeem (/etc/ssh/ssh_config)
De volgende cmdlet-parameters worden toegewezen aan ssh parameters en opties:
| Cmdlet-parameter | ssh-parameter | equivalente ssh -o-optie |
|---|---|---|
-KeyFilePath |
-i <KeyFilePath> |
-o IdentityFile=<KeyFilePath> |
-UserName |
-l <UserName> |
-o User=<UserName> |
-Port |
-p <Port> |
-o Port=<Port> |
-ComputerName -Subsystem |
-s <ComputerName> <Subsystem> |
-o Host=<ComputerName> |
Alle waarden die expliciet door parameters worden doorgegeven, hebben voorrang op waarden die zijn doorgegeven in de hashtabel Opties . Zie ssh_config(5) voor meer informatie over ssh_config bestanden.
Verwante koppelingen
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor