New-PSSessionOption

Syntax

Default (Standard)

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

Exempel

Exempel 1: Skapa ett standardalternativ för sessioner

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

Exempel 2: Konfigurera en session med hjälp av ett sessionsalternativobjekt

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

Exempel 3: Starta en interaktiv session

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

Exempel 4: Ändra ett sessionsalternativobjekt

$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

Exempel 5: Skapa en inställningsvariabel

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Exempel 6: Uppfylla kraven för en fjärrsessionskonfiguration

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

Exempel 7: Gör argument tillgängliga för en fjärrsession

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

Parametrar

-ApplicationArguments

Anger en PrimitiveDictionary som skickas till fjärrsessionen. Kommandon och skript i fjärrsessionen, inklusive startskript i sessionskonfigurationen, kan hitta den här ordlistan i egenskapen ApplicationArguments för den $PSSenderInfo automatiska variabeln. Du kan använda den här parametern för att skicka data till fjärrsessionen.

Mer information finns i about_Hash_Tables, about_Session_Configurationsoch about_Automatic_Variables.

Parameteregenskaper

Parameteruppsättningar

-CancelTimeout

Avgör hur länge PowerShell väntar på att en avbruten åtgärd (CTRL+C) ska slutföras innan den avslutas. Ange ett värde i millisekunder.

Standardvärdet är 60000 (en minut). Värdet 0 (noll) innebär ingen timeout. kommandot fortsätter på obestämd tid.

Parameteregenskaper

Parameteruppsättningar

-Culture

Anger vilken kultur som ska användas för sessionen. Ange ett kulturnamn i <languagecode2>-<country/regioncode2> format (till exempel ja-JP), en variabel som innehåller ett CultureInfo--objekt eller ett kommando som hämtar ett CultureInfo--objekt.

Standardvärdet är $nulloch den kultur som anges i operativsystemet används i sessionen.

Parameteregenskaper

Parameteruppsättningar

-IdleTimeout

Avgör hur länge sessionen är öppen om fjärrdatorn inte tar emot någon kommunikation från den lokala datorn. Detta inkluderar pulsslagssignalen. När intervallet upphör att gälla stängs sessionen.

Tidsgränsvärdet för inaktivitet är av stor betydelse om du tänker koppla från och återansluta till en session. Du kan bara återansluta om sessionen inte har överskridit tidsgränsen.

Ange ett värde i millisekunder. Minimivärdet är 60000 (1 minut). Det maximala värdet är värdet för egenskapen MaxIdleTimeoutMs för sessionskonfigurationen. Standardvärdet, -1, anger inte tidsgränsen för inaktivitet.

Sessionen använder tidsgränsen för inaktivitet som anges i sessionsalternativen, om det finns några. Om ingen anges (-1) använder sessionen värdet för IdleTimeoutMs egenskapen för sessionskonfigurationen eller WSMan-gränssnittets timeout-värde (WSMan:\<ComputerName>\Shell\IdleTimeout), beroende på vilket som är kortast.

Om tidsgränsen för inaktivitet som anges i sessionsalternativen överskrider värdet för MaxIdleTimeoutMs egenskapen för sessionskonfigurationen misslyckas kommandot för att skapa en session.

IdleTimeoutMs värdet för standardinställningen Microsoft.PowerShell sessionskonfiguration är 7200000 millisekunder (2 timmar). Dess MaxIdleTimeoutMs värde är 2147483647 millisekunder (>24 dagar). Standardvärdet för tidsgränsen för inaktivitet i WSMan-gränssnittet (WSMan:\<ComputerName>\Shell\IdleTimeout) är 7200000 millisekunder (2 timmar).

Tidsgränsvärdet för inaktivitet för en session kan också ändras när du kopplar från en session eller återansluter till en session. Mer information finns i Disconnect-PSSession och Connect-PSSession.

I Windows PowerShell 2.0 är standardvärdet för parametern IdleTimeout240000 (4 minuter).

Parameteregenskaper

Parameteruppsättningar

-IncludePortInSPN

Innehåller portnumret i tjänstens huvudnamn (SPN) som används för Kerberos-autentisering, till exempel HTTP://<ComputerName>:5985. Med det här alternativet kan en klient som använder ett SPN som inte är standard autentiseras mot en fjärrdator som använder Kerberos-autentisering.

Alternativet är utformat för företag där flera tjänster som stöder Kerberos-autentisering körs under olika användarkonton. Till exempel kan ett IIS-program som tillåter Kerberos-autentisering kräva att standard-SPN registreras till ett användarkonto som skiljer sig från datorkontot. I sådana fall kan PowerShell-fjärrkommunikation inte använda Kerberos för autentisering eftersom det kräver ett SPN som är registrerat för datorkontot. För att lösa det här problemet kan administratörer skapa olika SPN: er, till exempel genom att använda Setspn.exe, som är registrerade på olika användarkonton och kan skilja mellan dem genom att inkludera portnumret i SPN.

Mer information finns i Setspn Overview.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-MaxConnectionRetryCount

Anger antalet gånger som PowerShell försöker upprätta en anslutning till en måldator om det aktuella försöket misslyckas på grund av nätverksproblem. Standardvärdet är 5.

Den här parametern har lagts till för PowerShell version 5.0.

Parameteregenskaper

Parameteruppsättningar

-MaximumReceivedDataSizePerCommand

Anger det maximala antalet byte som den lokala datorn kan ta emot från fjärrdatorn i ett enda kommando. Ange ett värde i byte. Som standard finns det ingen datastorleksgräns.

Det här alternativet är utformat för att skydda resurserna på klientdatorn.

Parameteregenskaper

Parameteruppsättningar

-MaximumReceivedObjectSize

Anger den maximala storleken på ett objekt som den lokala datorn kan ta emot från fjärrdatorn. Det här alternativet är utformat för att skydda resurserna på klientdatorn. Ange ett värde i byte.

Om du utelämnar den här parametern i Windows PowerShell 2.0 finns det ingen storleksgräns för objekt. Från och med Windows PowerShell 3.0, om du utelämnar den här parametern, är standardvärdet 209715200 byte (eller 200MB).

Parameteregenskaper

Parameteruppsättningar

-MaximumRedirection

Avgör hur många gånger PowerShell omdirigerar en anslutning till en alternativ URI (Uniform Resource Identifier) innan anslutningen misslyckas. Standardvärdet är 5. Ett värde på 0 (noll) förhindrar all omdirigering.

Det här alternativet används endast i sessionen när parametern AllowRedirection används i kommandot som skapar sessionen.

Parameteregenskaper

Parameteruppsättningar

-NoCompression

Inaktiverar paketkomprimering i sessionen. Komprimering använder fler processorcykler, men det gör överföringen snabbare.

Parameteregenskaper

Parameteruppsättningar

-NoEncryption

Inaktiverar datakryptering.

Parameteregenskaper

Parameteruppsättningar

-NoMachineProfile

Förhindrar inläsning av användarens Windows-användarprofil. Därför kan sessionen skapas snabbare, men användarspecifika registerinställningar, objekt som miljövariabler och certifikat är inte tillgängliga i sessionen.

Parameteregenskaper

Parameteruppsättningar

-OpenTimeout

Avgör hur länge klientdatorn väntar på att sessionsanslutningen ska upprättas. När intervallet upphör att gälla misslyckas kommandot för att upprätta anslutningen. Ange ett värde i millisekunder.

Standardvärdet är 180000 (3 minuter). Värdet 0 (noll) innebär ingen timeout. kommandot fortsätter på obestämd tid.

Parameteregenskaper

Parameteruppsättningar

-OperationTimeout

Avgör den maximala tiden WinRM- väntar på positiva anslutningstester från en live-anslutning innan tidsgränsen för anslutningen initieras. Mer information om WinRM finns i dokumentationen Windows Remote Management.

OperationTimeoutinte införa en tidsgräns för kommandon eller processer som körs i en fjärrsession och inte påverka andra fjärrkommunikationsprotokoll som SSH.

Standardvärdet är 180000 (3 minuter). Värdet 0 (noll) innebär ingen tidsgräns.

Parameteregenskaper

Parameteruppsättningar

-OutputBufferingMode

Avgör hur kommandoutdata hanteras i frånkopplade sessioner när utdatabufferten blir full.

Om utdatabuffertningsläget inte har angetts i sessionen eller i sessionskonfigurationen är standardvärdet Block. Användare kan också ändra utdatabuffertningsläget när sessionen kopplas från.

Om du utelämnar den här parametern är värdet för OutputBufferingMode för objektet SessionOptionNone. Värdet Block eller Drop åsidosätter transportalternativet för utdatabuffertningsläge som anges i sessionskonfigurationen. De godtagbara värdena för den här parametern är:

• Block. När utdatabufferten är full pausas körningen tills bufferten är klar.
• Drop. När utdatabufferten är full fortsätter körningen. När nya utdata sparas ignoreras de äldsta utdata.
• None. Inget utdatabuffertningsläge har angetts.

Mer information om transportalternativet för utdatabuffertningsläge finns i New-PSTransportOption.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Parameteruppsättningar

-ProxyAccessType

Avgör vilken mekanism som används för att lösa hostnamnet. De godtagbara värdena för den här parametern är:

• IEConfig
• WinHttpConfig
• AutoDetect
• NoProxyServer
• None

Standardvärdet är None.

Information om värdena för den här parametern finns i ProxyAccessType-uppräkning.

Parameteregenskaper

Parameteruppsättningar

-ProxyAuthentication

Anger den autentiseringsmetod som används för proxymatchning. De godtagbara värdena för den här parametern är:

• Basic
• Digest
• Negotiate

Standardvärdet är Negotiate.

Mer information om värdena för den här parametern finns i AuthenticationMechanism Enumeration.

Parameteregenskaper

Parameteruppsättningar

-ProxyCredential

Anger de autentiseringsuppgifter som ska användas för proxyautentisering. Ange en variabel som innehåller ett PSCredential--objekt eller ett kommando som hämtar ett PSCredential--objekt, till exempel ett Get-Credential kommando. Om det här alternativet inte har angetts anges inga autentiseringsuppgifter.

Parameteregenskaper

Parameteruppsättningar

-SkipCACheck

Anger att när den ansluter via HTTPS verifierar klienten inte att servercertifikatet har signerats av en betrodd certifikatutfärdare (CA).

Använd endast det här alternativet när fjärrdatorn är betrodd med hjälp av en annan mekanism, till exempel när fjärrdatorn är en del av ett nätverk som är fysiskt säkert och isolerat eller när fjärrdatorn anges som en betrodd värd i en WinRM-konfiguration.

Parameteregenskaper

Parameteruppsättningar

-SkipCNCheck

Anger att certifikatets gemensamma namn (CN) på servern inte behöver matcha serverns värdnamn. Det här alternativet används endast i fjärråtgärder som använder HTTPS-protokollet.

Använd endast det här alternativet för betrodda datorer.

Parameteregenskaper

Parameteruppsättningar

-SkipRevocationCheck

Verifierar inte återkallningsstatusen för servercertifikatet.

Parameteregenskaper

Parameteruppsättningar

-UICulture

Anger den användargränssnittskultur som ska användas för sessionen.

Giltiga värden är:

• Ett kulturnamn i <languagecode2>-<country/regioncode2> format, till exempel ja-JP
• En variabel som innehåller ett CultureInfo-objekt
• Ett kommando som hämtar ett CultureInfo- objekt, till exempel Get-Culture

Standardvärdet är $nulloch användargränssnittskulturen som anges i operativsystemet när sessionen skapas.

Parameteregenskaper

Parameteruppsättningar

-UseUTF16

Anger att denna cmdlet kodar begäran i UTF16-format i stället för UTF8-format.

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

None

Utdata

PSSessionOption

Kommentarer

Relaterade länkar

• Enter-PSSession
• Invoke-Command
• New-PSSession