New-PSSessionOption

Syntaxis

Default (Standaard)

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

Voorbeelden

Voorbeeld 1: Een standaardsessieoptie maken

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

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

Voorbeeld 3: Een interactieve sessie starten

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

Voorbeeld 4: Een sessieoptieobject wijzigen

$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

Voorbeeld 5: Een voorkeursvariabele maken

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Voorbeeld 6: 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

Voorbeeld 7: Argumenten beschikbaar maken voor een 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.

Parameters

-ApplicationArguments

Hiermee wordt een PrimitiveDictionary naar de externe sessie 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.

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

-Culture

Hiermee specificeert u de cultuur 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.

Parametereigenschappen

Parametersets

-IdleTimeout

Bepaalt hoe lang de sessie open blijft als de externe computer geen communicatie van de lokale computer ontvangt. Dit omvat het hartslagsignaal. 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 de sessie niet is verlopen.

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 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 wanneer opnieuw verbinding met een sessie wordt gemaakt. Zie voor meer informatie Disconnect-PSSession en Connect-PSSession.

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

Parametereigenschappen

Parametersets

-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 PowerShell-remoting Kerberos niet gebruiken voor authenticatie, omdat hiervoor een SPN is vereist dat is geregistreerd op 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.

Voor meer informatie, zie Setspn Overview.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

-NoCompression

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

Parametereigenschappen

Parametersets

-NoEncryption

Hiermee schakelt u gegevensversleuteling uit.

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

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

OperationTimeout stelt geen tijdslimiet op voor opdrachten of processen die in een externe sessie worden uitgevoerd en beïnvloedt geen andere externe protocollen zoals SSH.

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

Parametereigenschappen

Parametersets

-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 uitvoerbuffermodus-transportoptie die in de sessieconfiguratie is ingesteld. 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 uitvoerbuffermodus als transportoptie.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Parametereigenschappen

Parametersets

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

Voor meer informatie over de waarden van deze parameter, zie ProxyAccessType Opsomming.

Parametereigenschappen

Parametersets

-ProxyAuthentication

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

• Basic
• Digest
• Negotiate

De standaardwaarde is Negotiate.

Zie AuthenticationMechanism-opsommingvoor meer informatie over de waarden van deze parameter.

Parametereigenschappen

Parametersets

-ProxyCredential

Hiermee specificeert u de inloggegevens 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.

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

-SkipRevocationCheck

Valideert de intrekkingsstatus van het servercertificaat niet.

Parametereigenschappen

Parametersets

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

Parametereigenschappen

Parametersets

-UseUTF16

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

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

None

Uitvoerwaarden

PSSessionOption

Notities

Verwante koppelingen

• Enter-PSSession
• Invoke-opdracht
• New-PSSession