Delen via

New-PSSession

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee maakt u een permanente verbinding met een lokale of externe computer.

Syntaxis

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

Description

De cmdlet New-PSSession maakt een Windows PowerShell-sessie (PSSession) op een lokale of externe computer. Wanneer u een PSSession-maakt, maakt Windows PowerShell een permanente verbinding met de externe computer.

Gebruik een PSSession- om meerdere opdrachten uit te voeren waarmee gegevens worden gedeeld, zoals een functie of de waarde van een variabele. Als u opdrachten wilt uitvoeren in een PSSession-, gebruikt u de cmdlet Invoke-Command. Als u de PSSession- wilt gebruiken om rechtstreeks met een externe computer te communiceren, gebruikt u de cmdlet Enter-PSSession. Zie about_PSSessions (https://go.microsoft.com/fwlink/?LinkID=135181) voor meer informatie.

U kunt opdrachten uitvoeren op een externe computer zonder een PSSession- te maken met behulp van de parameters ComputerName van Enter-PSSession of Invoke-Command. Wanneer u de parameter ComputerName gebruikt, maakt Windows PowerShell een tijdelijke verbinding die wordt gebruikt voor de opdracht en vervolgens wordt gesloten.

Voorbeelden

Voorbeeld 1: Een sessie maken op de lokale computer

PS C:\> $s = New-PSSession

Met deze opdracht maakt u een nieuwe PSSession- op de lokale computer en slaat u de PSSession- op in de variabele $s.

U kunt deze PSSession- nu gebruiken om opdrachten uit te voeren op de lokale computer.

Voorbeeld 2: Een sessie maken op een externe computer

PS C:\> $Server01 = New-PSSession -ComputerName Server01

Met deze opdracht maakt u een nieuwe PSSession- op de Server01-computer en slaat u deze op in de variabele $Server 01.

Wanneer u meerdere PSSession--objecten maakt, wijst u deze toe aan variabelen met nuttige namen. Dit helpt u bij het beheren van de PSSession objecten in volgende opdrachten.

Voorbeeld 3: Sessies maken op meerdere computers

PS C:\> $s1, $s2, $s3 = New-PSSession -ComputerName Server01,Server02,Server03

Met deze opdracht maakt u drie PSSession objecten, één op elk van de computers die zijn opgegeven door de ComputerName parameter.

De opdracht gebruikt de toewijzingsoperator (=) om de nieuwe PSSession-objecten toe te wijzen aan variabelen: $s 1, $s 2, $s 3. De server01-PSSession- wordt toegewezen aan $s 1, de Server02 PSSession aan $s 2 en de PSSession- van Server03 aan $s 3.

Wanneer u meerdere objecten toewijst aan een reeks variabelen, wijst Windows PowerShell elk object respectievelijk toe aan een variabele in de reeks. Als er meer objecten zijn dan variabelen, worden alle resterende objecten toegewezen aan de laatste variabele. Als er meer variabelen zijn dan objecten, zijn de resterende variabelen leeg (null).

Voorbeeld 4: Een sessie maken met een opgegeven poort

PS C:\> New-PSSession -ComputerName Server01 -Port 8081 -UseSSL -ConfigurationName E12

Met deze opdracht maakt u een nieuwe PSSession- op de Server01-computer die verbinding maakt met serverpoort 8081 en het SSL-protocol gebruikt. De nieuwe PSSession maakt gebruik van een alternatieve sessieconfiguratie met de naam E12.

Voordat u de poort instelt, moet u de WinRM-listener op de externe computer configureren om te luisteren op poort 8081. Zie de beschrijving van de parameter Port voor meer informatie.

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

PS C:\> New-PSSession -Session $s -Credential Domain01\User01

Met deze opdracht maakt u een PSSession- met dezelfde eigenschappen als een bestaande PSSession-. U kunt deze opdrachtindeling gebruiken wanneer de resources van een bestaande PSSession- uitgeput zijn en een nieuwe PSSession- nodig is om een deel van de vraag te offloaden.

De opdracht gebruikt de parameter Session van New-PSSession- om de PSSession op te geven opgeslagen in de $s variabele. Hierbij worden de referenties van de gebruiker Domain1\Admin01 gebruikt om de opdracht te voltooien.

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

PS C:\> $global:s = New-PSSession -ComputerName Server1.Domain44.Corpnet.Fabrikam.com -Credential Domain01\Admin01

In dit voorbeeld ziet u hoe u een PSSession- maakt met een globaal bereik op een computer in een ander domein.

Standaard worden PSSession- objecten die op de opdrachtregel zijn gemaakt, gemaakt met lokaal bereik en PSSession objecten die in een script zijn gemaakt, een scriptbereik hebben.

Als u een PSSession- met globaal bereik wilt maken, maakt u een nieuwe PSSession- en slaat u de PSSession- op in een variabele die wordt omgezet in een globaal bereik. In dit geval wordt de $s variabele naar een globaal bereik gecast.

De opdracht gebruikt de parameter ComputerName om de externe computer op te geven. Omdat de computer zich in een ander domein bevindt dan het gebruikersaccount, wordt de volledige naam van de computer opgegeven samen met de referenties van de gebruiker.

Voorbeeld 7: Sessies maken voor veel computers

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

Met deze opdracht maakt u een PSSession- op elk van de 200 computers die worden vermeld in het Servers.txt-bestand en wordt de resulterende PSSession- opgeslagen in de $rs variabele. De PSSession objecten hebben een beperkingslimiet van 50.

U kunt deze opdrachtindeling gebruiken wanneer de namen van computers worden opgeslagen in een database, spreadsheet, tekstbestand of een andere tekst converteerbare indeling.

Voorbeeld 8: Een sessie maken met behulp van een URI

PS C:\> $s = New-PSSession -URI http://Server01:91/NewSession -Credential Domain01\User01

Met deze opdracht maakt u een PSSession- op de Server01-computer en slaat deze op in de $s variabele. Hierbij wordt de URI- parameter gebruikt om het transportprotocol, de externe computer, de poort en een alternatieve sessieconfiguratie op te geven. Ook wordt de parameter Credential gebruikt om een gebruikersaccount op te geven dat is gemachtigd om een sessie op de externe computer te maken.

Voorbeeld 9: Een achtergrondtaak uitvoeren in een set sessies

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

Met deze opdrachten maakt u een set PSSession--objecten en voert u vervolgens een achtergrondtaak uit in elk van de PSSession--objecten.

Met de eerste opdracht maakt u een nieuwe PSSession- op elke computer die in het Servers.txt-bestand wordt vermeld. Het maakt gebruik van de cmdlet New-PSSession om de PSSession-te maken. De waarde van de parameter ComputerName is een opdracht die gebruikmaakt van de Get-Content cmdlet om de lijst met computernamen op te halen die het Servers.txt bestand.

De opdracht gebruikt de parameter Credential om de PSSession--objecten te maken die de machtiging van een domeinbeheerder hebben. Hierbij wordt de parameter ThrottleLimit gebruikt om de opdracht te beperken tot 16 gelijktijdige verbindingen. De opdracht slaat de PSSession objecten op in de $s variabele.

De tweede opdracht gebruikt de parameter AsJob van de cmdlet Invoke-Command om een achtergrondtaak te starten waarmee een Get-Process PowerShell opdracht wordt uitgevoerd in elk van de PSSession--objecten in $s.

Zie about_Jobs en about_Remote_Jobsvoor meer informatie over Windows PowerShell-achtergrondtaken.

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

PS C:\> New-PSSession -ConnectionURI https://management.exchangelabs.com/Management

Met deze opdracht maakt u een PSSession objecten die verbinding maken met een computer die is opgegeven door een URI in plaats van een computernaam.

Voorbeeld 11: Een sessieoptie maken

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

In dit voorbeeld ziet u hoe u een sessieoptieobject maakt en de parameter SessionOption gebruikt.

De eerste opdracht maakt gebruik van de New-PSSessionOption cmdlet om een sessieoptie te maken. Het resulterende SessionOption--object wordt opgeslagen in de variabele $so.

De tweede opdracht maakt gebruik van de optie in een nieuwe sessie. De opdracht maakt gebruik van de cmdlet New-PSSession om een nieuwe sessie te maken. De waarde van de parameter SessionOption is het SessionOption--object in de variabele $so.

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

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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 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, 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 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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-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
  • Basisch
  • Credssp
  • Verteren
  • Kerberos
  • Onderhandelen
  • NegotiateWithImplicitCredential

De standaardwaarde is Standaard.

Zie Opsomming AuthenticationMechanism in de MSDN-bibliotheek voor meer informatie over de waarden van deze parameter.

Waarschuwing: CredSSP-verificatie (Credential Security Support Provider), waarbij de gebruikersreferenties 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
Geaccepteerde waarden:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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 opdracht Get-Item of Get-ChildItem in het Windows PowerShell-certificaat: station.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-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, localhost of 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' in about_Remote_Troubleshooting (https://go.microsoft.com/fwlink/?LinkID=135188) voor 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.

Type:String[]
Aliassen:Cn
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-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: https://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, is microsoft.PowerShell de standaardinstelling. Zie about_Preference_Variablesvoor meer informatie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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>:<Poort>/<ApplicationName->

De standaardwaarde is als volgt:

https://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 Windows 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 Windows PowerShell de omleiding, tenzij u de AllowRedirection parameter in de opdracht gebruikt.

Type:Uri[]
Aliassen:URI, CU
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-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, Domain01\User01 of User@Domain.com, of voer een PSCredential--object in, zoals een object dat wordt geretourneerd door de Get-Credential-cmdlet.

Wanneer u een gebruikersnaam typt, wordt u door deze cmdlet gevraagd om een wachtwoord.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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 loopbacksessie wilt maken, laat u de parameter ComputerName weg of stelt u de waarde in op punt (.), localhost of 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-PSSession voor meer informatie.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

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

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

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

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

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

Type:PSSession[]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-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-PSSessionOption voor een beschrijving van de sessieopties die de standaardwaarden bevatten. Zie about_Preference_Variablesvoor meer informatie over de $PSSessionOption voorkeursvariabele. Zie about_Session_Configurationsvoor meer informatie over sessieconfiguraties.

Type:PSSessionOption
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

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

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

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

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

System.String, System.URI, System.Management.Automation.Runspaces.PSSession

U kunt een tekenreeks, URI of sessieobject doorsluisen naar deze cmdlet.

Uitvoerwaarden

PSSession

Notities

  • Deze cmdlet maakt gebruik van de externe infrastructuur van Windows PowerShell. Als u deze cmdlet wilt gebruiken, moeten de lokale computer en alle externe computers worden geconfigureerd voor externe communicatie met Windows PowerShell. Zie about_Remote_Requirementsvoor meer informatie.

  • Als u een PSSession- op de lokale computer wilt maken, start u Windows PowerShell met de optie Als administrator uitvoeren.

  • Wanneer u klaar bent met de PSSession-, gebruikt u de Remove-PSSession cmdlet om de PSSession- te verwijderen en de bijbehorende resources vrij te geven.