Delen via

New-PSSessionOption

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee maakt u een object met geavanceerde opties voor een PSSession.

Syntaxis

New-PSSessionOption
   [-MaximumRedirection <Int32>]
   [-NoCompression]
   [-NoMachineProfile]
   [-Culture <CultureInfo>]
   [-UICulture <CultureInfo>]
   [-MaximumReceivedDataSizePerCommand <Int32>]
   [-MaximumReceivedObjectSize <Int32>]
   [-OutputBufferingMode <OutputBufferingMode>]
   [-MaxConnectionRetryCount <Int32>]
   [-ApplicationArguments <PSPrimitiveDictionary>]
   [-OpenTimeout <Int32>]
   [-CancelTimeout <Int32>]
   [-IdleTimeout <Int32>]
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <AuthenticationMechanism>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [-IncludePortInSPN]
   [<CommonParameters>]

Description

De cmdlet New-PSSessionOption maakt een object met geavanceerde opties voor een door de gebruiker beheerde sessie (PSSession). U kunt het object gebruiken als de waarde van de parameter SessionOption van cmdlets die een PSSession-maken, zoals New-PSSession, Enter-PSSessionen Invoke-Command.

Zonder parameters genereert New-PSSessionOption een object dat de standaardwaarden voor alle opties bevat. Omdat elke eigenschap kan worden bewerkt, kunt u het resulterende object als sjabloon gebruiken en standaardoptieobjecten maken voor uw onderneming.

U kunt ook een SessionOption--object opslaan in de $PSSessionOption voorkeursvariabele. Met de waarden van deze variabele worden nieuwe standaardwaarden voor de sessieopties ingesteld. Ze zijn effectief wanneer er geen sessieopties zijn ingesteld voor de sessie en ze voorrang hebben op opties die zijn ingesteld in de sessieconfiguratie, maar u kunt ze overschrijven door sessieopties of een SessionOption--object op te geven in een cmdlet waarmee een sessie wordt gemaakt. Zie about_Preference_Variablesvoor meer informatie over de $PSSessionOption voorkeursvariabele.

Wanneer u een SessionOption-object gebruikt in een cmdlet waarmee een sessie wordt gemaakt, hebben de waarden van de sessieoptie 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 about_Session_Configurationsvoor meer informatie over sessieconfiguraties.

Voorbeelden

Voorbeeld 1: Een standaardsessieoptie maken

Met deze opdracht maakt u een SessionOption--object met de standaardwaarden.

New-PSSessionOption

MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Voorbeeld 2: Een sessie configureren met behulp van een sessieoptieobject

In dit voorbeeld ziet u hoe u een SessionOption--object gebruikt om een sessie te configureren.

$pso = New-PSSessionOption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB
New-PSSession -ComputerName Server01 -SessionOption $pso

Met de eerste opdracht wordt een nieuw SessionOption--object gemaakt en opgeslagen in de waarde van de $pso variabele. De tweede opdracht maakt gebruik van de New-PSSession cmdlet om een sessie te maken op de externe Server01-computer. De opdracht gebruikt het SessionOption--object in de waarde van de $pso variabele als de waarde van de parameter SessionOption van de opdracht.

Voorbeeld 3: Een interactieve sessie starten

Met deze opdracht wordt de cmdlet Enter-PSSession gebruikt om een interactieve sessie met de Server01-computer te starten.

Enter-PSSession -ComputerName Server01 -SessionOption (New-PSSessionOption -NoEncryption -NoCompression)

De waarde van de parameter SessionOption is een New-PSSessionOption opdracht met de parameters NoEncryption en NoCompression.

De New-PSSessionOption opdracht staat tussen haakjes om ervoor te zorgen dat deze wordt uitgevoerd vóór de opdracht Enter-PSSession.

Voorbeeld 4: Een sessieoptieobject wijzigen

In dit voorbeeld ziet u dat u het SessionOption--object kunt wijzigen. Alle eigenschappen hebben lees-/schrijfwaarden.

$a = New-PSSessionOption
$a.OpenTimeout

Days              : 0
Hours             : 0
Minutes           : 3
Seconds           : 0
Milliseconds      : 0
Ticks             : 1800000000
TotalDays         : 0.00208333333333333
TotalHours        : 0.05
TotalMinutes      : 3
TotalSeconds      : 180
TotalMilliseconds : 180000

$a.UICulture = (Get-UICulture)
$a.OpenTimeout = (New-Timespan -Minutes 4)
$a.MaximumConnectionRedirectionCount = 1
$a

MaximumConnectionRedirectionCount : 1
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         : en-US
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:04:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Gebruik deze methode om een standaardsessieobject voor uw bedrijf te maken en vervolgens aangepaste versies ervan te maken voor bepaalde toepassingen.

Voorbeeld 5: Een voorkeursvariabele maken

Met deze opdracht maakt u een $PSSessionOption voorkeursvariabele.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Wanneer de $PSSessionOption voorkeursvariabele is ingesteld in de sessie, worden standaardwaarden ingesteld voor opties in de sessies die zijn gemaakt met de New-PSSession, Enter-PSSessionen Invoke-Command cmdlets.

Als u de $PSSessionOption variabele beschikbaar wilt maken in alle sessies, voegt u deze toe aan uw PowerShell-sessie en aan uw PowerShell-profiel.

Zie about_Preference_Variablesvoor meer informatie over de $PSSessionOption voorkeursvariabele. Zie about_Profilesvoor meer informatie over profielen.

Voorbeeld 6: voldoen aan de vereisten voor een externe sessieconfiguratie

In dit voorbeeld ziet u hoe u een SessionOption--object gebruikt om te voldoen aan de vereisten voor een externe sessieconfiguratie.

$skipCN = New-PSSessionOption -SkipCNCheck
New-PSSession -ComputerName 171.09.21.207 -UseSSL -Credential Domain01\User01 -SessionOption $SkipCN

De eerste opdracht maakt gebruik van de New-PSSessionOption-cmdlet om een SessionOption--object te maken met de eigenschap SkipCNCheck. Met de opdracht wordt het resulterende sessieobject opgeslagen in de variabele $skipCN.

De tweede opdracht maakt gebruik van de New-PSSession cmdlet om een nieuwe sessie te maken op een externe computer. De $skipCN controlevariabele wordt gebruikt in de waarde van de parameter SessionOption.

Omdat de computer wordt geïdentificeerd door het IP-adres, komt de waarde van de parameter ComputerName niet overeen met een van de algemene namen in het certificaat dat wordt gebruikt voor SSL (Secure Sockets Layer). Als gevolg hiervan is de optie SkipCNCheck vereist.

Voorbeeld 7: Argumenten beschikbaar maken voor een externe sessie

In dit voorbeeld ziet u hoe u de parameter ApplicationArguments van de New-PSSessionOption-cmdlet gebruikt om extra gegevens beschikbaar te maken voor de externe sessie.

$team = @{Team="IT"; Use="Testing"}
$TeamOption = New-PSSessionOption -ApplicationArguments $team
$s = New-PSSession -ComputerName Server01 -SessionOption $TeamOption
Invoke-Command -Session $s {$PSSenderInfo.ApplicationArguments}

Name                 Value
----                 -----
Team                 IT
Use                  Testing
PSVersionTable       {CLRVersion, BuildVersion, PSVersion, WSManStackVersion...}

Invoke-Command -Session $s {
  if ($PSSenderInfo.ApplicationArguments.Use -ne "Testing") {
    .\logFiles.ps1
  }
  else {
    "Just testing."
  }
}

Just testing.

Met de eerste opdracht maakt u een hash-tabel met twee sleutels, Team en Gebruik. Met de opdracht wordt de hash-tabel opgeslagen in de variabele $team. Zie about_Hash_Tablesvoor meer informatie over hashtabellen.

Vervolgens maakt de New-PSSessionOption-cmdlet, met behulp van de parameter ApplicationArguments, een SessionOption--object dat is opgeslagen in de variabele $team. Wanneer New-PSSessionOption het sessieoptieobject maakt, wordt de hash-tabel automatisch geconverteerd in de waarde van de parameter ApplicationArguments naar een PrimitiveDictionary-, zodat de gegevens betrouwbaar naar de externe sessie kunnen worden verzonden.

De cmdlet New-PSSession start een sessie op de Server01-computer. Hierbij wordt de parameter SessionOption gebruikt om de opties in de variabele $teamOption op te nemen.

De Invoke-Command cmdlet laat zien dat de gegevens in de $team variabele beschikbaar zijn voor opdrachten in de externe sessie. De gegevens worden weergegeven in de eigenschap ApplicationArguments van de automatische variabele $PSSenderInfo.

In de laatste Invoke-Command ziet u hoe de gegevens kunnen worden gebruikt.

Parameters

-ApplicationArguments

Hiermee geeft u een PrimitiveDictionary die naar de externe sessie wordt verzonden. Opdrachten en scripts in de externe sessie, inclusief opstartscripts in de sessieconfiguratie, kunnen deze woordenlijst vinden in de eigenschap ApplicationArguments van de automatische variabele $PSSenderInfo. U kunt deze parameter gebruiken om gegevens naar de externe sessie te verzenden.

Zie about_Hash_Tables, about_Session_Configurationsen about_Automatic_Variablesvoor meer informatie.

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

-CancelTimeout

Bepaalt hoe lang PowerShell wacht op een annuleringsbewerking (Ctrl+C) voordat u deze beëindigt. Voer een waarde in milliseconden in.

De standaardwaarde is 60000 (één minuut). Een waarde van 0 (nul) betekent geen time-out; de opdracht voor onbepaalde tijd doorgaat.

Type:Int32
Aliassen:CancelTimeoutMSec
Position:Named
Default value:60000
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Culture

Hiermee geeft u de cultuur die moet worden gebruikt voor de sessie. Voer een cultuurnaam in <languagecode2>-<country/regioncode2>-indeling (zoals ja-JP), een variabele die een CultureInfo-object bevat of een opdracht waarmee een CultureInfo object wordt opgehaald.

De standaardwaarde is $Nullen de cultuur die in het besturingssysteem is ingesteld, wordt gebruikt in de sessie.

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

-IdleTimeout

Bepaalt hoe lang de sessie open blijft als de externe computer geen communicatie van de lokale computer ontvangt. Dit omvat het heartbeatsignaal. Wanneer het interval verloopt, wordt de sessie gesloten.

De time-outwaarde voor inactiviteit is van groot belang als u de verbinding met een sessie wilt verbreken en opnieuw verbinding wilt maken. U kunt alleen opnieuw verbinding maken als er geen time-out optreedt voor de sessie.

Voer een waarde in milliseconden in. De minimumwaarde is 60000 (1 minuut). Het maximum is de waarde van de MaxIdleTimeoutms eigenschap van de sessieconfiguratie. De standaardwaarde, -1, stelt geen time-out voor inactiviteit in.

De sessie gebruikt de time-out voor inactiviteit die is ingesteld in de sessieopties, indien van toepassing. Als er geen is ingesteld (-1), gebruikt de sessie de waarde van de IdleTimeoutMs eigenschap van de sessieconfiguratie of de time-outwaarde van de WSMan-shell (WSMan:\<ComputerName>\Shell\IdleTimeout), afhankelijk van wat het kortst is.

Als de time-out voor inactiviteit in de sessieopties groter is dan de waarde van de MaxIdleTimeoutMs eigenschap van de sessieconfiguratie, mislukt de opdracht om een sessie te maken.

De IdleTimeoutMs waarde van de standaardconfiguratie van Microsoft.PowerShell sessie is 7200000 milliseconden (2 uur). De MaxIdleTimeoutMs waarde is 2147483647 milliseconden (>24 dagen). De standaardwaarde van de time-out voor inactiviteit van de WSMan-shell (WSMan:\<ComputerName>\Shell\IdleTimeout) is 7200000 milliseconden (2 uur).

De time-outwaarde voor inactiviteit van een sessie kan ook worden gewijzigd wanneer de verbinding met een sessie wordt verbroken of opnieuw verbinding maakt met een sessie. Zie Disconnect-PSSession en Connect-PSSessionvoor meer informatie.

In Windows PowerShell 2.0 is de standaardwaarde van de parameter IdleTimeout240000 (4 minuten).

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

-IncludePortInSPN

Bevat het poortnummer in de SPN (Service Principal Name) die wordt gebruikt voor Kerberos-verificatie, bijvoorbeeld HTTP://<ComputerName>:5985. Met deze optie kan een client die gebruikmaakt van een niet-standaard SPN verifiëren op een externe computer die gebruikmaakt van Kerberos-verificatie.

De optie is ontworpen voor ondernemingen waarbij meerdere services die Kerberos-verificatie ondersteunen, worden uitgevoerd onder verschillende gebruikersaccounts. Een IIS-toepassing die kerberos-verificatie toestaat, kan bijvoorbeeld vereisen dat de standaard-SPN wordt geregistreerd bij een gebruikersaccount dat verschilt van het computeraccount. In dergelijke gevallen kan externe communicatie van PowerShell Kerberos niet gebruiken om te verifiëren, omdat hiervoor een SPN is vereist die is geregistreerd bij het computeraccount. Om dit probleem op te lossen, kunnen beheerders verschillende SPN's maken, zoals met behulp van Setspn.exe, die zijn geregistreerd bij verschillende gebruikersaccounts en onderscheid kunnen maken tussen deze accounts door het poortnummer in de SPN op te geven.

Zie Setspn Overviewvoor 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

-MaxConnectionRetryCount

Hiermee geeft u het aantal keren op dat PowerShell probeert verbinding te maken met een doelcomputer als de huidige poging mislukt vanwege netwerkproblemen. De standaardwaarde is 5.

Deze parameter is toegevoegd voor PowerShell versie 5.0.

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

-MaximumReceivedDataSizePerCommand

Hiermee geeft u het maximum aantal bytes op dat de lokale computer kan ontvangen van de externe computer in één opdracht. Voer een waarde in bytes in. Standaard is er geen limiet voor de gegevensgrootte.

Deze optie is ontworpen om de resources op de clientcomputer te beveiligen.

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

-MaximumReceivedObjectSize

Hiermee geeft u de maximale grootte van een object dat de lokale computer kan ontvangen van de externe computer. Deze optie is ontworpen om de resources op de clientcomputer te beveiligen. Voer een waarde in bytes in.

Als u deze parameter weglaat in Windows PowerShell 2.0, is er geen limiet voor de objectgrootte. Vanaf Windows PowerShell 3.0 wordt de standaardwaarde 209715200 bytes (of 200MB) als u deze parameter weglaat.

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

-MaximumRedirection

Bepaalt hoe vaak PowerShell een verbinding omleidt naar een alternatieve URI (Uniform Resource Identifier) voordat de verbinding mislukt. De standaardwaarde is 5. Een waarde van 0 (nul) voorkomt alle omleiding.

Deze optie wordt alleen in de sessie gebruikt wanneer de parameter AllowRedirection wordt gebruikt in de opdracht waarmee de sessie wordt gemaakt.

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

-NoCompression

Hiermee schakelt u pakketcompressie in de sessie uit. Compressie maakt gebruik van meer processorcycli, maar het maakt transmissie sneller.

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

-NoEncryption

Hiermee schakelt u gegevensversleuteling uit.

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

-NoMachineProfile

Hiermee voorkomt u dat het Windows-gebruikersprofiel van de gebruiker wordt geladen. Hierdoor kan de sessie sneller worden gemaakt, maar gebruikersspecifieke registerinstellingen, items zoals omgevingsvariabelen en certificaten zijn niet beschikbaar in de sessie.

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

-OpenTimeout

Bepaalt hoe lang de clientcomputer wacht totdat de sessieverbinding tot stand is gebracht. Wanneer het interval verloopt, mislukt de opdracht om de verbinding tot stand te brengen. Voer een waarde in milliseconden in.

De standaardwaarde is 180000 (3 minuten). Een waarde van 0 (nul) betekent geen time-out; de opdracht voor onbepaalde tijd doorgaat.

Type:Int32
Aliassen:OpenTimeoutMSec
Position:Named
Default value:180000 (3 minutes)
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OperationTimeout

Bepaalt de maximale tijd WinRM- wacht op positieve verbindingstests van een liveverbinding voordat er een time-out voor de verbinding wordt gestart. Zie de Windows Remote Management Documentationvoor meer informatie over WinRM.

OperationTimeoutgeen tijdslimiet op voor opdrachten of processen die worden uitgevoerd in een externe sessie en heeft geen invloed op andere externe protocollen, zoals SSH.

De standaardwaarde is 180000 (3 minuten). Een waarde van 0 (nul) betekent geen time-out.

Type:Int32
Aliassen:OperationTimeoutMSec
Position:Named
Default value:180000 (3 minutes)
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OutputBufferingMode

Bepaalt hoe opdrachtuitvoer wordt beheerd in niet-verbonden sessies wanneer de uitvoerbuffer vol raakt.

Als de uitvoerbuffermodus niet is ingesteld in de sessie of in de sessieconfiguratie, wordt de standaardwaarde Block. Gebruikers kunnen ook de uitvoerbuffermodus wijzigen wanneer de sessie wordt verbroken.

Als u deze parameter weglaat, wordt de waarde van de OutputBufferingMode van het SessionOption--object None. Een waarde van Block of Drop overschrijft de transportoptie voor de uitvoerbuffermodus die is ingesteld in de sessieconfiguratie. De acceptabele waarden voor deze parameter zijn:

  • Block. Wanneer de uitvoerbuffer vol is, wordt de uitvoering onderbroken totdat de buffer leeg is.
  • Drop. Wanneer de uitvoerbuffer vol is, wordt de uitvoering voortgezet. Wanneer nieuwe uitvoer wordt opgeslagen, wordt de oudste uitvoer verwijderd.
  • None. Er is geen uitvoerbuffermodus opgegeven.

Zie New-PSTransportOptionvoor meer informatie over de transportoptie uitvoerbuffermodus.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:OutputBufferingMode
Geaccepteerde waarden:None, Drop, Block
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProxyAccessType

Bepaalt welk mechanisme wordt gebruikt om de hostnaam op te lossen. De acceptabele waarden voor deze parameter zijn:

  • IEConfig
  • WinHttpConfig
  • AutoDetect
  • NoProxyServer
  • None

De standaardwaarde is None.

Zie Opsomming ProxyAccessTypevoor meer informatie over de waarden van deze parameter.

Type:ProxyAccessType
Geaccepteerde waarden:None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProxyAuthentication

Hiermee geeft u de verificatiemethode op die wordt gebruikt voor proxyomzetting. De acceptabele waarden voor deze parameter zijn:

  • Basic
  • Digest
  • Negotiate

De standaardwaarde is Negotiate.

Zie Opsomming AuthenticationMechanismvoor meer informatie over de waarden van deze parameter.

Type:AuthenticationMechanism
Geaccepteerde waarden:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Default value:Negotiate
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProxyCredential

Hiermee geeft u de referenties die moeten worden gebruikt voor proxyverificatie. Voer een variabele in die een PSCredential--object bevat of een opdracht waarmee een PSCredential--object wordt opgehaald, zoals een Get-Credential opdracht. Als deze optie niet is ingesteld, worden er geen referenties opgegeven.

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

-SkipCACheck

Hiermee geeft u op dat wanneer er verbinding wordt gemaakt via HTTPS, de client niet valideert dat het servercertificaat is ondertekend door een vertrouwde certificeringsinstantie (CA).

Gebruik deze optie alleen wanneer de externe computer wordt vertrouwd met een ander mechanisme, zoals wanneer de externe computer deel uitmaakt van een netwerk dat fysiek veilig en geïsoleerd is of wanneer de externe computer wordt vermeld als een vertrouwde host in een WinRM-configuratie.

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

-SkipCNCheck

Hiermee geeft u op dat de algemene naam van het certificaat (CN) van de server niet moet overeenkomen met de hostnaam van de server. Deze optie wordt alleen gebruikt in externe bewerkingen die gebruikmaken van het HTTPS-protocol.

Gebruik deze optie alleen voor vertrouwde computers.

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

-SkipRevocationCheck

Valideert de intrekkingsstatus van het servercertificaat niet.

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

-UICulture

Hiermee geeft u de UI-cultuur op die moet worden gebruikt voor de sessie.

Geldige waarden zijn:

  • Een cultuurnaam in <languagecode2>-<country/regioncode2> indeling, zoals ja-JP
  • Een variabele die een CultureInfo--object bevat
  • Een opdracht waarmee een CultureInfo--object wordt opgehaald, zoals Get-Culture

De standaardwaarde is $nullen de UI-cultuur die is ingesteld in het besturingssysteem wanneer de sessie wordt gemaakt.

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

-UseUTF16

Geeft aan dat deze cmdlet de aanvraag in UTF16-indeling codeert in plaats van de UTF8-indeling.

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

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

PSSessionOption

Notities

Als de parameter SessionOption niet wordt gebruikt in een opdracht om een PSSession-te maken, worden de sessieopties bepaald door de eigenschapswaarden van de $PSSessionOption voorkeursvariabele, als deze is ingesteld. Zie about_Preference_Variablesvoor meer informatie over de variabele $PSSessionOption.

De eigenschappen van een sessieconfiguratieobject variëren met de opties die zijn ingesteld voor de sessieconfiguratie en de waarden van deze opties. Daarnaast hebben sessieconfiguraties die gebruikmaken van een sessieconfiguratiebestand aanvullende eigenschappen.