New-PSSessionOption

Referentie

Module:: Microsoft.PowerShell.Core

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 dat geavanceerde opties bevat 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 wordt New-PSSessionOption een object gegenereerd dat de standaardwaarden voor alle opties bevat. Omdat elke eigenschap kan worden bewerkt, kunt u het resulterende object als sjabloon gebruiken en standaardoptieobjecten voor uw onderneming maken.

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 hebben voorrang 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 sessieoptiewaarden 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 Creatie

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 maakt u een nieuw SessionOption-object en slaat u dit op in de waarde van de $pso variabele. De tweede opdracht gebruikt 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 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 Object SessionOption 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 onderneming te maken en vervolgens aangepaste versies van het object te maken voor specifieke toepassingen.

Voorbeeld 5: een voorkeursvariabele Creatie

Met deze opdracht maakt u een voorkeursvariabele $PSSessionOption .

$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-PSSessioncmdlets , Enter-PSSessionen Invoke-Command .

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 dat de eigenschap SkipCNCheck heeft. Met de opdracht wordt het resulterende sessieobject opgeslagen in de $skipCN variabele.

De tweede opdracht gebruikt 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 aanvullende 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 hashtabel met twee sleutels, Team en Use. Met de opdracht wordt de hashtabel 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 kunnen worden verzonden naar de externe sessie.

De New-PSSession cmdlet start een sessie op de Server01-computer. De parameter SessionOption wordt 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.

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

Parameters

-ApplicationArguments

Hiermee geeft u een PrimitiveDictionary die wordt verzonden naar de externe sessie. 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 moet wachten tot 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 te gebruiken voor de sessie. Voer een cultuurnaam in in <languagecode2>-<country/regioncode2> de 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 is ingesteld in het besturingssysteem 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 is verlopen, 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 is opgetreden 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. De standaardwaarde, -1, stelt geen time-out voor inactiviteit in.

De sessie maakt gebruik van 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 die is ingesteld 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 van 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 u de verbinding met een sessie verbreekt 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, HTTP://<ComputerName>:5985bijvoorbeeld . Met deze optie kan een client die gebruikmaakt van een niet-standaard SPN verifiëren op een externe computer die kerberos-verificatie gebruikt.

De optie is ontworpen voor ondernemingen waar 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 toegang 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, bijvoorbeeld met behulp van Setspn.exe, die zijn geregistreerd bij verschillende gebruikersaccounts en onderscheid kunnen maken tussen deze accounts door het poortnummer op te slaan in de SPN.

Zie Setspn Overzicht 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 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 in Windows PowerShell 2.0 deze parameter weglaat, is er geen objectgroottelimiet. Als u vanaf Windows PowerShell 3.0 deze parameter weglaat, is 209715200 de standaardwaarde bytes (of 200MB).

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

Deze optie wordt alleen gebruikt in de sessie 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 maakt de overdracht 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. Als gevolg hiervan kan de sessie sneller worden gemaakt, maar zijn gebruikersspecifieke registerinstellingen, items zoals omgevingsvariabelen en certificaten 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 is verlopen, 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 dat WinRM wacht op positieve verbindingstests van een liveverbinding voordat een verbindingstime-out wordt gestart. Zie de Documentatie voor Windows Remote Management voor meer informatie over WinRM.

OperationTimeout legt geen 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
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-PSTransportOptionvoor de uitvoerbuffermodus.

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 ProxyAccessType Enumeration voor meer 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 te gebruiken 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
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 behulp van een ander mechanisme, zoals wanneer de externe computer deel uitmaakt van een netwerk dat fysiek beveiligd 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 hoeft overeen te komen 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 te gebruiken 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 codeert in de UTF16-indeling 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 doorspezen 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 afhankelijk van de opties die zijn ingesteld voor de sessieconfiguratie en de waarden van deze opties. Sessieconfiguraties die gebruikmaken van een sessieconfiguratiebestand hebben ook aanvullende eigenschappen.

Delen via

New-PSSessionOption

Syntax

Description

Voorbeelden

Voorbeeld 1: een standaardsessieoptie Creatie

Voorbeeld 2: een sessie configureren met behulp van een sessieoptieobject

Voorbeeld 3: Een interactieve sessie starten

Voorbeeld 4: Een sessieoptieobject wijzigen

Voorbeeld 5: een voorkeursvariabele Creatie

Voorbeeld 6: voldoen aan de vereisten voor een externe sessieconfiguratie

Voorbeeld 7: Argumenten beschikbaar maken voor een externe sessie

Parameters

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

Invoerwaarden

Uitvoerwaarden

Notities

Aanvullende resources

Delen via

New-PSSessionOption

Syntax

Description

Voorbeelden

Voorbeeld 1: een standaardsessieoptie Creatie

Voorbeeld 2: een sessie configureren met behulp van een sessieoptieobject

Voorbeeld 3: Een interactieve sessie starten

Voorbeeld 4: Een sessieoptieobject wijzigen

Voorbeeld 5: een voorkeursvariabele Creatie

Voorbeeld 6: voldoen aan de vereisten voor een externe sessieconfiguratie

Voorbeeld 7: Argumenten beschikbaar maken voor een externe sessie

Parameters

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

Invoerwaarden

Uitvoerwaarden

Notities

Verwante koppelingen

Aanvullende resources