New-PSSessionOption

Syntaxe

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

Rutina New-PSSessionOption vytvoří objekt, který obsahuje pokročilé možnosti relace spravované uživatelem (PSSession). Objekt můžete použít jako hodnotu Parametr SessionOption rutin, které vytvářejí PSSession, například New-PSSession, Enter-PSSessiona Invoke-Command.

Bez parametrů vygeneruje objekt, New-PSSessionOption který obsahuje výchozí hodnoty pro všechny možnosti. Vzhledem k tomu, že lze každou vlastnost upravit, můžete výsledný objekt použít jako šablonu a vytvořit standardní objekty možností pro vaši firmu.

Objekt SessionOption můžete také uložit do $PSSessionOption proměnné předvoleb. Hodnoty této proměnné vytvářejí nové výchozí hodnoty pro možnosti relace. Jsou efektivní, pokud nejsou pro relaci nastaveny žádné možnosti relace a mají přednost před možnostmi nastavenými v konfiguraci relace, ale můžete je přepsat zadáním možností relace nebo objektu SessionOption v rutině, která vytvoří relaci. Další informace o $PSSessionOption proměnné předvoleb najdete v tématu about_Preference_Variables.

Při použití SessionOption objektu v rutině, která vytvoří relaci, mají hodnoty možností relace přednost před výchozími hodnotami pro relace nastavené v $PSSessionOption proměnné předvoleb a v konfiguraci relace. Nemají však přednost před maximálními hodnotami, kvótami nebo limity nastavenými v konfiguraci relace. Další informace o konfiguracích relace najdete v tématu about_Session_Configurations.

Příklady

Příklad 1: Vytvoření výchozí možnosti relace

Tento příkaz vytvoří Objekt SessionOption s výchozími hodnotami.

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

Příklad 2: Konfigurace relace pomocí objektu možnosti relace

Tento příklad ukazuje, jak použít SessionOption objekt ke konfiguraci relace.

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

První příkaz vytvoří nový objekt SessionOption a uloží ho $pso do hodnoty proměnné. Druhý příkaz pomocí rutiny New-PSSession vytvoří relaci na vzdáleném počítači Serveru01. Příkaz používá SessionOption objekt v hodnotě $pso proměnné jako hodnotu SessionOption parametru příkazu.

Příklad 3: Spuštění interaktivní relace

Tento příkaz pomocí rutiny Enter-PSSession spustí interaktivní relaci s počítačem Se serverem 01.

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

Hodnota parametru SessionOption je New-PSSessionOption příkaz, který má parametry NoEncryption a NoCompression.

Příkaz New-PSSessionOption je uzavřený v závorkách, aby se zajistilo, že se spustí před příkazem Enter-PSSession .

Příklad 4: Úprava objektu možnosti relace

Tento příklad ukazuje, že můžete upravit SessionOption objektu. Všechny vlastnosti mají hodnoty pro čtení a zápis.

$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

Tuto metodu použijte k vytvoření standardního objektu relace pro váš podnik a následnému vytvoření přizpůsobených verzí pro konkrétní použití.

Příklad 5: Vytvoření proměnné předvoleb

Tento příkaz vytvoří proměnnou $PSSessionOption předvoleb.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

$PSSessionOption Pokud je v relaci nastavena proměnná předvoleb, vytvoří výchozí hodnoty pro možnosti v relacích, které jsou vytvořeny pomocí New-PSSession, Enter-PSSessiona Invoke-Command rutiny.

Pokud chcete proměnnou $PSSessionOption zpřístupnit ve všech relacích, přidejte ji do relace PowerShellu a do profilu PowerShellu.

Další informace o $PSSessionOption proměnné předvoleb najdete v tématu about_Preference_Variables. Další informace o profilech najdete v tématu about_Profiles.

Příklad 6: Splnění požadavků na konfiguraci vzdálené relace

Tento příklad ukazuje, jak pomocí objektu SessionOption splnit požadavky na konfiguraci vzdálené relace.

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

První příkaz používá rutinu New-PSSessionOption k vytvoření SessionOption objektu, který má SkipCNCheck vlastnost. Příkaz uloží výsledný objekt relace do $skipCN proměnné.

Druhý příkaz pomocí rutiny New-PSSession vytvoří novou relaci ve vzdáleném počítači. Kontrolní $skipCN proměnná se používá v hodnotě parametru SessionOption .

Vzhledem k tomu, že počítač je identifikován jeho IP adresou, hodnota parametru ComputerName neodpovídá žádnému z běžných názvů v certifikátu, který se používá pro protokol SSL (Secure Sockets Layer). V důsledku toho je vyžadována možnost SkipCNCheck .

Příklad 7: Zpřístupnění argumentů vzdálené relaci

Tento příklad ukazuje, jak pomocí parametru New-PSSessionOption ApplicationArguments rutiny zpřístupnit další data vzdálené relaci.

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

První příkaz vytvoří tabulku hash se dvěma klíči, týmem a použitím. Příkaz uloží tabulku hash do $team proměnné. Další informace o tabulkách hash najdete v tématu about_Hash_Tables.

Dále rutina New-PSSessionOption pomocí parametru ApplicationArguments vytvoří objekt SessionOption uložený v $team proměnné. Když New-PSSessionOption vytvoří objekt možnosti relace, automaticky převede tabulku hash v hodnotě parametru ApplicationArguments na PrimitiveDictionary , takže data lze spolehlivě přenést do vzdálené relace.

Rutina New-PSSession spustí relaci na počítači Server01. Používá parametr SessionOption k zahrnutí možností do $teamOption proměnné.

Rutina Invoke-Command ukazuje, že data v $team proměnné jsou k dispozici pro příkazy ve vzdálené relaci. Data se zobrazí ve vlastnosti $PSSenderInfo ApplicationArguments automatické proměnné.

Poslední Invoke-Command ukázka ukazuje, jak se data můžou použít.

Parametry

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

PSSessionOption

Poznámky

Pokud parametr SessionOption není použit v příkazu k vytvoření PSSession, možnosti relace jsou určeny hodnotami $PSSessionOption vlastností proměnné předvolby, pokud je nastavena. Další informace o $PSSessionOption proměnné najdete v tématu about_Preference_Variables.

Vlastnosti objektu konfigurace relace se liší podle možností nastavených pro konfiguraci relace a hodnot těchto možností. Konfigurace relací, které používají konfigurační soubor relace, mají také další vlastnosti.

Související odkazy

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