Enter-PSSession

Syntaxis

ComputerName (Standaard)

Enter-PSSession
    [-ComputerName] <String>
    [[-Credential] <PSCredential>]
    [-EnableNetworkAccess]
    [-ConfigurationName <String>]
    [-Port <Int32>]
    [-UseSSL]
    [-ApplicationName <String>]
    [-SessionOption <PSSessionOption>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

SSHHost

Enter-PSSession
    [-HostName] <String>
    [-Options <Hashtable>]
    [-Port <Int32>]
    [-UserName <String>]
    [-KeyFilePath <String>]
    [-Subsystem <String>]
    [-ConnectingTimeout <Int32>]
    [-SSHTransport]
    [<CommonParameters>]

Session

Enter-PSSession
    [[-Session] <PSSession>]
    [<CommonParameters>]

Uri

Enter-PSSession
    [[-ConnectionUri] <Uri>]
    [[-Credential] <PSCredential>]
    [-EnableNetworkAccess]
    [-ConfigurationName <String>]
    [-AllowRedirection]
    [-SessionOption <PSSessionOption>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

InstanceId

Enter-PSSession
    [-InstanceId <Guid>]
    [<CommonParameters>]

Id

Enter-PSSession
    [[-Id] <Int32>]
    [<CommonParameters>]

Name

Enter-PSSession
    [-Name <String>]
    [<CommonParameters>]

VMId

Enter-PSSession
    [-VMId] <Guid>
    [-Credential] <PSCredential>
    [-ConfigurationName <String>]
    [<CommonParameters>]

VMName

Enter-PSSession
    [-VMName] <String>
    [-Credential] <PSCredential>
    [-ConfigurationName <String>]
    [<CommonParameters>]

ContainerId

Enter-PSSession
    [-ContainerId] <String>
    [-ConfigurationName <String>]
    [-RunAsAdministrator]
    [<CommonParameters>]

Description

Voorbeelden

Voorbeeld 1: Een interactieve sessie starten

PS> Enter-PSSession
[localhost]: PS>

Voorbeeld 2: Werken met een interactieve sessie

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.txt

Voorbeeld 3: de sessieparameter gebruiken

PS> $s = New-PSSession -ComputerName Server01
PS> Enter-PSSession -Session $s
[Server01]: PS>

Voorbeeld 4: Een interactieve sessie starten en de poort- en referentieparameters opgeven

PS> Enter-PSSession -ComputerName Server01 -Port 90 -Credential Domain01\User01
[Server01]: PS>

Voorbeeld 5: Een interactieve sessie stoppen

PS> Enter-PSSession -ComputerName Server01
[Server01]: PS> Exit-PSSession
PS>

Voorbeeld 6: Een interactieve sessie starten met behulp van SSH

PS> Enter-PSSession -HostName UserA@LinuxServer01

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_rsa

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 $options

Parameters

-AllowRedirection

Hiermee wordt omleiding van deze verbinding naar een alternatieve URI (Uniform Resource Identifier) toegestaan. Omleiding is standaard niet toegestaan.

Wanneer u de parameter ConnectionURI 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 waarde van de MaximumConnectionRedirectionCount sessieoptie te wijzigen. Gebruik de parameter MaximumRedirection van de cmdlet New-PSSessionOption of stel de eigenschap MaximumConnectionRedirectionCount in van de $PSSessionOption voorkeursvariabele. De standaardwaarde is 5.

Parametereigenschappen

Parametersets

-ApplicationName

Specificeert het toepassingsnaamsegment van de verbindings-URI. Gebruik deze parameter om de naam van de toepassing op te geven wanneer u de parameter ConnectionURI niet gebruikt in de opdracht.

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_Variablesvoor meer informatie.

De WinRM--service gebruikt de naam van de toepassing om een listener te selecteren om de verbindingsaanvraag te verwerken. De waarde van deze parameter moet overeenkomen met de waarde van de eigenschap URLPrefix van een listener op de externe computer.

Parametereigenschappen

Parametersets

-Authentication

Hiermee geeft u het mechanisme op dat wordt gebruikt om de referenties van de gebruiker te verifiëren. De acceptabele waarden voor deze parameter zijn:

• Verstek
• Eenvoudig
• Credssp
• Samenvatting
• Kerberos
• Onderhandelen
• OnderhandelenMetImplicieteReferentie

De standaardwaarde is Standaard.

CredSSP-verificatie is alleen beschikbaar in Windows Vista, Windows Server 2008 en latere versies van het Windows-besturingssysteem.

Zie AuthenticationMechanism Enumvoor meer informatie over de waarden van deze parameter.

Parametereigenschappen

Parametersets

-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 opdracht Get-Item of Get-ChildItem in het PowerShell-certificaat: station.

Parametereigenschappen

Parametersets

-ComputerName

Hiermee geeft u een computernaam. Met deze cmdlet wordt een interactieve sessie gestart met de opgegeven externe computer. Voer slechts één computernaam in. De standaardwaarde is 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 parameter Credential 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_Troubleshootingvoor instructies voor het toevoegen van een computernaam aan de lijst TrustedHosts.

Parametereigenschappen

Parametersets

-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_Variablesvoor meer informatie.

Parametereigenschappen

Parametersets

-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

Parametereigenschappen

Parametersets

-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 ConnectionURI-opgeeft, kunt u de parameters UseSSL, ComputerName, Porten ApplicationName gebruiken om de ConnectionURI--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 AllowRedirection parameter in de opdracht gebruikt.

Parametereigenschappen

Parametersets

-ContainerId

Hiermee geeft u de id van een container.

Parametereigenschappen

Parametersets

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. De standaardwaarde is 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 een SecureString.

Parametereigenschappen

Parametersets

-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 loopbacksessie 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 parameter Authentication, waarmee de sessiereferenties worden gedelegeerd aan andere computers.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

-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 HostName 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.

Parametereigenschappen

Parametersets

-Id

Hiermee geeft u de id van een bestaande sessie. Enter-PSSession gebruikt de opgegeven sessie voor de interactieve sessie.

Gebruik de cmdlet Get-PSSession om de id van een sessie te vinden.

Parametereigenschappen

Parametersets

-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 cmdlet Get-PSSession om de exemplaar-id van een sessie te vinden. U kunt ook de parameters Sessie, Naamof Id parameters gebruiken om een bestaande sessie op te geven. U kunt ook de parameter ComputerName gebruiken om een tijdelijke sessie te starten.

Parametereigenschappen

Parametersets

-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.

Parametereigenschappen

Parametersets

-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 Session, InstanceIdof 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 wilt instellen voor een sessie, gebruikt u de parameter Name van de New-PSSession-cmdlet.

Parametereigenschappen

Parametersets

-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 opdracht ssh.

Alle waarden die expliciet door parameters worden doorgegeven, hebben voorrang op waarden die zijn doorgegeven in de Opties hashtabel. Als u bijvoorbeeld de parameter Poort gebruikt, worden alle Port sleutel-waardepaar dat is doorgegeven in de Opties hashtabel overschreven.

Parametereigenschappen

Parametersets

-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:

1. winrm delete winrm/config/listener?Address=*+Transport=HTTP
2. winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}

Gebruik de parameter Port niet, tenzij 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.

Parametereigenschappen

Parametersets

-RunAsAdministrator

Geeft aan dat de PSSession- als beheerder wordt uitgevoerd.

Parametereigenschappen

Parametersets

-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, InstanceIdof 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 PSSessionbevat, mislukt de opdracht.

Wanneer u Exit-PSSession of het trefwoord exit gebruikt, wordt de interactieve sessie beëindigd, maar blijft de PSSession die u hebt gemaakt geopend en beschikbaar voor gebruik.

Parametereigenschappen

Parametersets

-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 New-PSSessionOptionvoor een beschrijving van de sessieopties, inclusief de standaardwaarden. Zie $PSSessionOptionvoor meer informatie over de voorkeursvariabele. Zie about_Session_Configurationsvoor meer informatie over sessieconfiguraties.

Parametereigenschappen

Parametersets

-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.

Parametereigenschappen

Parametersets

-Subsystem

Hiermee geeft u het SSH-subsysteem 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.

Parametereigenschappen

Parametersets

-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 hoe 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, wordt uou niet om een wachtwoord gevraagd. U moet een pad naar een SSH-sleutelbestand opgeven. Als het gebruikerssleutelbestand zich op een bekende SSH-locatie bevindt, is de parameter KeyFilePath niet nodig. Gebruikersverificatie vindt automatisch plaats op basis van de gebruikersnaam. Zie de SSH-documentatie over gebruikersverificatie op basis van sleutels voor meer informatie.

Als de parameter UserName niet is opgegeven, wordt de huidige aangemelde gebruikersnaam gebruikt.

Deze parameter is geïntroduceerd in PowerShell 6.0.

Parametereigenschappen

Parametersets

-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. SSL wordt standaard niet gebruikt.

WS-Management versleutelt alle PowerShell-inhoud die via het netwerk wordt verzonden. De parameter UseSSL 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 voor de opdracht wordt gebruikt, mislukt de opdracht.

Parametereigenschappen

Parametersets

-VMId

Hiermee geeft u de id van een virtuele machine.

Parametereigenschappen

Parametersets

-VMName

Hiermee geeft u de naam van een virtuele machine.

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

String

PSSession

Uitvoerwaarden

None

Notities

Verwante koppelingen

• Exit-PSSession
• Get-PSSession
• Invoke-opdracht
• New-PSSession
• Verwijder-PSSessie
• Connect-PSSession
• Verbreek-PSSessie
• Receive-PSSession
• about_PSSessions
• over_Afstandsbediening