New-PSSessionOption

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

Syntax

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 New-PSSessionOption cmdlet 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 New-PSSessionOption genereert u 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_Variables voor 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_Configurations (Engelstalig) voor 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 cmdlet voor het New-PSSession maken van een sessie 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 Enter-PSSession cmdlet gebruikt om een interactieve sessie te starten met de Server01-computer.

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 vóór de Enter-PSSession opdracht wordt uitgevoerd.

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_Variables voor meer informatie over de $PSSessionOption voorkeursvariabele. Zie about_Profiles voor 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 gebruikt de New-PSSessionOption cmdlet om een SessionOption-object te maken met de eigenschap SkipCNCheck . Met de opdracht wordt het resulterende sessieobject opgeslagen in de $skipCN variabele.

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 Use. Met de opdracht wordt de hash-tabel opgeslagen in de $team variabele. Zie about_Hash_Tables voor meer informatie over hashtabellen.

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

De New-PSSession cmdlet start een sessie op de Server01-computer. Hierbij wordt de parameter SessionOption gebruikt om de opties in de $teamOption variabele 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 $PSSenderInfo automatische variabele.

De laatste geeft Invoke-Command aan hoe de gegevens kunnen worden gebruikt.

Parameters

-ApplicationArguments

Hiermee geeft u een PrimitiveDictionary op 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 $PSSenderInfo automatische variabele. U kunt deze parameter gebruiken om gegevens naar de externe sessie te verzenden.

Zie about_Hash_Tables, about_Session_Configurations en about_Automatic_Variables voor meer informatie.

Type:PSPrimitiveDictionary
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CancelTimeout

Bepaalt hoe lang PowerShell wacht totdat een annuleringsbewerking (CTRL+C) is voltooid voordat deze wordt beëindigd. Voer een waarde in milliseconden in.

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

Type:Int32
Aliases:CancelTimeoutMSec
Position:Named
Default value:60000
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Culture

Hiermee geeft u de cultuur die moet worden gebruikt voor de sessie. Voer een cultuurnaam in opmaken <languagecode2>-<country/regioncode2> (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
Required:False
Accept pipeline input:False
Accept wildcard characters: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 eigenschap MaxIdleTimeoutms van de sessieconfiguratie. Met de standaardwaarde wordt -1geen time-out voor inactiviteit ingesteld.

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 eigenschap IdleTimeoutMs 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 eigenschap MaxIdleTimeoutMs van de sessieconfiguratie, mislukt de opdracht om een sessie te maken.

De waarde idleTimeoutMs van de standaardconfiguratie van de Microsoft.PowerShell-sessie is 7200000 milliseconden (2 uur). De waarde maxIdleTimeoutMs 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 voor meer informatie Disconnect-PSSession en Connect-PSSession.

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

Type:Int32
Aliases:IdleTimeoutMSec
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 door ze te gebruiken 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 Overzicht van Setspn voor meer informatie.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Als u deze parameter weglaat, is 209715200 de standaardwaarde bytes (of 200MB) vanaf Windows PowerShell 3.0.

Type:Int32
Position:Named
Default value:209715200
Required:False
Accept pipeline input:False
Accept wildcard characters: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 dat alle omleidingen worden omgeleid.

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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoEncryption

Hiermee schakelt u gegevensversleuteling uit.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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 wordt voor onbepaalde tijd voortgezet.

Type:Int32
Aliases:OpenTimeoutMSec
Position:Named
Default value:180000 (3 minutes)
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OperationTimeout

Bepaalt de maximale tijd waarop WinRM wacht op positieve verbindingstests van een liveverbinding voordat er een time-out voor de verbinding wordt gestart. Zie de windows-documentatie voor extern beheer voor meer informatie over WinRM.

OperationTimeout legt geentijdslimiet 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
Aliases:OperationTimeoutMSec
Position:Named
Default value:180000 (3 minutes)
Required:False
Accept pipeline input:False
Accept wildcard characters: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, is Blockde standaardwaarde. Gebruikers kunnen ook de uitvoerbuffermodus wijzigen wanneer de sessie wordt verbroken.

Als u deze parameter weglaat, is Nonede waarde van de OutputBufferingMode van het SessionOption-object . Een waarde van Block of Drop overschrijft de transportoptie voor de uitvoerbuffermodus die is ingesteld in de sessieconfiguratie. De aanvaardbare 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 voor meer informatie over de transportoptie New-PSTransportOptionuitvoerbuffermodus.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:OutputBufferingMode
Accepted values:None, Drop, Block
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAccessType

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

  • IEConfig
  • WinHttpConfig
  • AutoDetect
  • NoProxyServer
  • None

De standaardwaarde is None.

Zie De opsomming ProxyAccessType voor informatie over de waarden van deze parameter.

Type:ProxyAccessType
Accepted values:None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAuthentication

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

  • Basic
  • Digest
  • Negotiate

De standaardwaarde is Negotiate.

Zie AuthenticationMechanism Enumeration voor meer informatie over de waarden van deze parameter.

Type:AuthenticationMechanism
Accepted values:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Default value:Negotiate
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyCredential

Hiermee geeft u de referenties die moeten worden gebruikt voor proxyverificatie. Voer een variabele in die een PSCredential-object of een opdracht bevat 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipRevocationCheck

Valideert de intrekkingsstatus van het servercertificaat niet.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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_Variables voor meer informatie over de $PSSessionOption variabele.

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.