New-PSSession

Syntaxis

ComputerName (Standaard)

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

Uri

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

VMId

New-PSSession
    [-VMId] <Guid[]>
    -Credential <PSCredential>
    [-Name <String[]>]
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [<CommonParameters>]

VMName

New-PSSession
    -Credential <PSCredential>
    -VMName <String[]>
    [-Name <String[]>]
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [<CommonParameters>]

Session

New-PSSession
    [[-Session] <PSSession[]>]
    [-Name <String[]>]
    [-EnableNetworkAccess]
    [-ThrottleLimit <Int32>]
    [<CommonParameters>]

ContainerId

New-PSSession
    -ContainerId <String[]>
    [-Name <String[]>]
    [-ConfigurationName <String>]
    [-RunAsAdministrator]
    [-ThrottleLimit <Int32>]
    [<CommonParameters>]

Description

Voorbeelden

Voorbeeld 1: Een sessie maken op de lokale computer

$s = New-PSSession

Voorbeeld 2: Een sessie maken op een externe computer

$Server01 = New-PSSession -ComputerName Server01

Voorbeeld 3: Sessies maken op meerdere computers

$s1, $s2, $s3 = New-PSSession -ComputerName Server01,Server02,Server03

Voorbeeld 4: Een sessie maken met een opgegeven poort

New-PSSession -ComputerName Server01 -Port 8081 -UseSSL -ConfigurationName E12

Voorbeeld 5: Een sessie maken op basis van een bestaande sessie

New-PSSession -Session $s -Credential Domain01\User01

Voorbeeld 6: Een sessie maken met een globaal bereik in een ander domein

$Global:s = New-PSSession -ComputerName Server1.Domain44.Corpnet.Fabrikam.com -Credential Domain01\Admin01

Voorbeeld 7: Sessies maken voor veel computers

$rs = Get-Content C:\Test\Servers.txt | New-PSSession -ThrottleLimit 50

Voorbeeld 8: Een sessie maken met behulp van een URI

$s = New-PSSession -Uri http://Server01:91/NewSession -Credential Domain01\User01

Voorbeeld 9: Een achtergrondtaak uitvoeren in een set sessies

$s = New-PSSession -ComputerName (Get-Content Servers.txt) -Credential Domain01\Admin01 -ThrottleLimit 16
Invoke-Command -Session $s -ScriptBlock {Get-Process powershell} -AsJob

Voorbeeld 10: Een sessie voor een computer maken met behulp van de URI

New-PSSession -ConnectionURI https://management.exchangelabs.com/Management

Voorbeeld 11: Een sessieoptie maken

$so = New-PSSessionOption -SkipCACheck
New-PSSession -ConnectionUri https://management.exchangelabs.com/Management -SessionOption $so -Credential Server01\Admin01

Parameters

-AllowRedirection

Geeft aan dat deze cmdlet omleiding van deze verbinding met een alternatieve URI (Uniform Resource Identifier) toestaat.

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

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 ConnectionURI parameter in de opdracht niet gebruikt.

De standaardwaarde is de waarde van de $PSSessionApplicationName voorkeursvariabele op de lokale computer. Als deze voorkeursvariabele niet is gedefinieerd, wordt 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 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.

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:

• Default
• Basic
• Credssp
• Digest
• Kerberos
• Negotiate
• NegotiateWithImplicitCredential

De standaardwaarde is Default.

Zie Opsomming AuthenticationMechanismvoor 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-Cert:-station.

Parametereigenschappen

Parametersets

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met deze cmdlet maakt u een permanente verbinding (PSSession) met de opgegeven computer. Als u meerdere computernamen invoert, maakt New-PSSession meerdere PSSession objecten, één voor elke computer. De standaardwaarde is de lokale computer.

Typ de NetBIOS-naam, een IP-adres of een volledig gekwalificeerde domeinnaam van een of meer externe computers. Als u de lokale computer wilt opgeven, typt u de computernaam, localhostof een punt (.). Wanneer de computer zich in een ander domein bevindt dan de gebruiker, is de volledig gekwalificeerde domeinnaam vereist. U kunt ook een computernaam, tussen aanhalingstekens, doorsluisen naar New-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.

Als u de lokale computer wilt opnemen in de waarde van de parameter ComputerName, start u Windows PowerShell met behulp van de optie Als administrator uitvoeren.

Parametereigenschappen

Parametersets

-ConfigurationName

Hiermee geeft u de sessieconfiguratie die wordt gebruikt voor de nieuwe PSSession.

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.

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, wordt de standaardwaarde Microsoft.PowerShell. Zie about_Preference_Variablesvoor meer informatie.

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 parameters 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 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 een matrix van id's van containers. Met deze cmdlet wordt een interactieve sessie gestart met elk van de opgegeven containers. Gebruik de opdracht docker ps om een lijst met container-id's op te halen. Zie de Help voor de opdracht docker ps voor meer informatie.

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 in op punt (.), localhostof de naam van de lokale computer.

Deze cmdlet maakt standaard loopbacksessies 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 externe toegang ook inschakelen in een loopbacksessie met behulp van de CredSSP waarde van de parameter Authentication, waarmee de sessiereferenties worden gedelegeerd aan andere computers.

Als u de computer wilt beschermen tegen schadelijke toegang, kunnen verbroken loopbacksessies met interactieve tokens, die zijn gemaakt met behulp van de parameter EnableNetworkAccess, alleen opnieuw verbinding maken vanaf de computer waarop de sessie is gemaakt. Verbroken sessies waarvoor CredSSP-verificatie wordt gebruikt, kunnen opnieuw worden verbonden vanaf andere computers. Zie Disconnect-PSSessionvoor meer informatie.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Parametereigenschappen

Parametersets

-Name

Hiermee geeft u een beschrijvende naam voor de PSSession.

U kunt de naam gebruiken om te verwijzen naar de PSSession- wanneer u andere cmdlets gebruikt, zoals Get-PSSession en Enter-PSSession. De naam hoeft niet uniek te zijn voor de computer of de huidige sessie.

Parametereigenschappen

Parametersets

-Port

Hiermee geeft u de netwerkpoort op de externe computer die wordt gebruikt voor deze verbinding. 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 andere 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.

Parametereigenschappen

Parametersets

-RunAsAdministrator

Geeft aan dat de PSSession- als beheerder wordt uitgevoerd.

Parametereigenschappen

Parametersets

-Session

Hiermee geeft u een matrix van PSSession objecten die door deze cmdlet worden gebruikt als model voor de nieuwe PSSession-. Met deze parameter maakt u nieuwe PSSession objecten met dezelfde eigenschappen als de opgegeven PSSession objecten.

Voer een variabele in die de PSSession objecten bevat of een opdracht waarmee de PSSession- objecten worden gemaakt of opgehaald, zoals een New-PSSession of Get-PSSession opdracht.

De resulterende PSSession--objecten dezelfde computernaam, toepassingsnaam, verbindings-URI, poort, configuratienaam, beperkingslimiet en SSL-waarde (Secure Sockets Layer) hebben als de originelen, maar ze hebben een andere weergavenaam, id en exemplaar-id (GUID).

Parametereigenschappen

Parametersets

-SessionOption

Hiermee geeft u geavanceerde opties voor de sessie. 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 die de standaardwaarden bevatten. Zie $PSSessionOptionvoor meer informatie over de voorkeursvariabele. Zie about_Session_Configurationsvoor meer informatie over sessieconfiguraties.

Parametereigenschappen

Parametersets

-ThrottleLimit

Hiermee geeft u het maximum aantal gelijktijdige verbindingen op dat tot stand kan worden gebracht om deze opdracht uit te voeren. Als u deze parameter weglaat of een waarde invoert van 0 (nul), wordt de standaardwaarde, 32, gebruikt.

De beperkingslimiet is alleen van toepassing op de huidige opdracht, niet op de sessie of op de computer.

Parametereigenschappen

Parametersets

-UseSSL

Geeft aan dat deze cmdlet het SSL-protocol gebruikt 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 biedt 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.

Parametereigenschappen

Parametersets

-VMId

Hiermee geeft u een matrix van virtuele-machine-id's. Met deze cmdlet wordt een interactieve PowerShell Direct-sessie gestart met elk van de opgegeven virtuele machines. Zie Automatisering en beheer van virtuele machines met behulp van PowerShellvoor meer informatie.

Gebruik Get-VM om de virtuele machines te zien die beschikbaar zijn op uw Hyper-V-host.

Parametereigenschappen

Parametersets

-VMName

Hiermee geeft u een matrix van namen van virtuele machines. Met deze cmdlet wordt een interactieve PowerShell Direct-sessie gestart met elk van de opgegeven virtuele machines. Zie Automatisering en beheer van virtuele machines met behulp van PowerShellvoor meer informatie.

Gebruik Get-VM om de virtuele machines te zien die beschikbaar zijn op uw Hyper-V-host.

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

String

System.URI

PSSession

Uitvoerwaarden

PSSession

Notities

Verwante koppelingen

• Connect-PSSession
• Disconnect-PSSession
• Enter-PSSession
• Exit-PSSession
• Get-PSSession
• Invoke-Command
• Receive-PSSession
• Remove-PSSession