Sdílet prostřednictvím

New-PSSessionOption

  • Reference
Modul:
Microsoft.PowerShell.Core

Vytvoří objekt, který obsahuje upřesňující možnosti pro PSSession.

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 pro relaci spravovanou uživatelem (PSSession). Objekt můžete použít jako hodnotu parametru SessionOption u cmdletů, které vytvářejí PSSession , například New-PSSession, Enter-PSSessiona Invoke-Command.

Bez parametrů New-PSSessionOption vygeneruje objekt, 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.

Do proměnné předvoleb $PSSessionOption SessionOption. Hodnoty této proměnné nastavují 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. Pro více informací o preferenční proměnné $PSSessionOption si přečtěte téma about_Preference_Variables.

Pokud použijete objekt SessionOption v rutině, která vytvoří relaci, budou mít hodnoty možností relace přednost před výchozími hodnotami pro relace nastavené v proměnné předvoleb $PSSessionOption 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 relací 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 do hodnoty proměnné $pso. Druhý příkaz používá rutinu New-PSSession k vytvoření relace na vzdáleném počítači Server01. Příkaz používá objekt SessionOption v hodnotě $pso proměnné jako hodnotu SessionOption parametru příkazu.

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

Tento příkaz používá rutinu Enter-PSSession ke spuštění interaktivní relace s počítačem Server01.

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 předvoleb $PSSessionOption.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

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

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

Pro více informací o preferenční proměnné $PSSessionOption si přečtěte téma about_Preference_Variables. Další informace o profilech about_Profiles

Příklad 6: Splňte požadavky na konfiguraci vzdálené relace

Tento příklad ukazuje, jak pomocí SessionOption objektu 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žije rutinu New-PSSessionOption k vytvoření objektu SessionOption, který má vlastnost SkipCNCheck. Příkaz uloží výsledný objekt relace do proměnné $skipCN.

Druhý příkaz používá rutinu New-PSSession k vytvoření nové relace na vzdáleném počítači. Proměnná $skipCN pro kontrolu 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 volba SkipCNCheck.

Příklad 7: Zpřístupnění argumentů pro vzdálenou relaci

Tento příklad ukazuje, jak pomocí parametru ApplicationArguments rutiny New-PSSessionOption 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, Team a Use. Příkaz uloží tabulku hash do proměnné $team. 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 proměnné $team. Když New-PSSessionOption vytvoří objekt možnosti relace, automaticky převede tabulku hash v hodnotě parametru ApplicationArguments na PrimitiveDictionary, aby bylo možné data spolehlivě přenést do vzdáleného spojení.

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

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

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

Parametry

-ApplicationArguments

Určuje PrimitiveDictionary, který se odešle do vzdálené relace. Příkazy a skripty ve vzdálené relaci, včetně spouštěcích skriptů v konfiguraci relace, mohou tento slovník najít ve vlastnosti ApplicationArguments automatické proměnné $PSSenderInfo. Tento parametr můžete použít k odesílání dat do vzdálené relace.

Další informace najdete v tématu about_Hash_Tables, about_Session_Configurationsa about_Automatic_Variables.

Typ:PSPrimitiveDictionary
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CancelTimeout

Určuje, jak dlouho PowerShell čeká na dokončení operace zrušení (CTRL+C) předtím, než ji ukončí. Zadejte hodnotu v milisekundách.

Výchozí hodnota je 60000 (jedna minuta). Hodnota 0 (nula) znamená žádný časový limit; příkaz pokračuje po neomezenou dobu.

Typ:Int32
Aliasy:CancelTimeoutMSec
Position:Named
Default value:60000
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Culture

Určuje kulturní nastavení, které se má použít pro relaci. Zadejte název jazykové verze ve formátu <languagecode2>-<country/regioncode2> (například ja-JP), proměnnou obsahující objekt CultureInfo, nebo příkaz získávající objekt CultureInfo.

Výchozí hodnota je $Nulla kultura nastavená v operačním systému se používá během relace.

Typ:CultureInfo
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IdleTimeout

Určuje, jak dlouho relace zůstane otevřená, pokud vzdálený počítač neobdrží žádnou komunikaci z místního počítače. To zahrnuje signál srdečního tepu. Po vypršení intervalu se relace zavře.

Hodnota časového limitu nečinnosti je velmi důležitá, pokud se chcete odpojit a znovu připojit k relaci. Můžete se znovu připojit jenom v případě, že relace nevysadila časový limit.

Zadejte hodnotu v milisekundách. Minimální hodnota je 60000 (1 minuta). Maximum je hodnota MaxIdleTimeoutMs vlastnost konfigurace relace. Výchozí hodnota, -1, nenastaví časový limit pro nečinnost.

Relace používá časový limit nečinnosti, který je nastaven v možnostech relace (pokud existují). Pokud není nastavena žádná (-1), relace používá hodnotu IdleTimeoutMs vlastnost konfigurace relace nebo hodnota časového limitu prostředí WSMan (WSMan:\<ComputerName>\Shell\IdleTimeout), která je nejkratší.

Pokud časový limit nečinnosti nastavený v možnostech relace překročí hodnotu MaxIdleTimeoutMs vlastnost konfigurace relace, příkaz pro vytvoření relace selže.

Hodnota IdleTimeoutMs ve výchozí konfiguraci relace Microsoft.PowerShell je o 7200000 milisekund (2 hodiny). Hodnota MaxIdleTimeoutMs je 2147483647 milisekund (>24 dní). Výchozí hodnota časového limitu nečinnosti prostředí WSMan (WSMan:\<ComputerName>\Shell\IdleTimeout) je 7200000 milisekund (2 hodiny).

Hodnotu časového limitu nečinnosti relace lze také změnit při odpojení od relace nebo opětovném připojení k relaci. Další informace najdete v tématu Disconnect-PSSession a Connect-PSSession.

Ve Windows PowerShellu 2.0 je výchozí hodnota parametru IdleTimeout240000 (4 minuty).

Typ:Int32
Aliasy:IdleTimeoutMSec
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IncludePortInSPN

Zahrnuje číslo portu v hlavním názvu služby (SPN) používaném pro ověřování protokolem Kerberos, například HTTP://<ComputerName>:5985. Tato možnost umožňuje klientovi, který používá jiný než výchozí hlavní název služby (SPN), ověřit se na vzdáleném počítači, který používá ověřování protokolem Kerberos.

Tato možnost je určená pro podniky, ve kterých pod různými uživatelskými účty běží více služeb, které podporují ověřování protokolem Kerberos. Například aplikace služby IIS, která umožňuje ověřování protokolem Kerberos, může vyžadovat registraci výchozího hlavního názvu služby (SPN) na uživatelský účet, který se liší od účtu počítače. V takových případech nemůže PowerShell vzdáleně používat k ověření protokol Kerberos, protože vyžaduje hlavní název služby (SPN), který je zaregistrovaný v účtu počítače. Pokud chtějí tento problém vyřešit, mohou správci vytvořit různé hlavní názvy služeb (SPN), například pomocí Setspn.exe, které jsou zaregistrované u různých uživatelských účtů, a mohou mezi nimi rozlišovat zahrnutím čísla portu do SPN.

Další informace naleznete v tématu Setspn Přehled.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxConnectionRetryCount

Určuje, kolikrát se PowerShell pokusí připojit k cílovému počítači, pokud se aktuální pokus nezdaří kvůli problémům se sítí. Výchozí hodnota je 5.

Tento parametr byl přidán pro PowerShell verze 5.0.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaximumReceivedDataSizePerCommand

Určuje maximální počet bajtů, které může místní počítač přijímat ze vzdáleného počítače v jednom příkazu. Zadejte hodnotu v bajtech. Ve výchozím nastavení neexistuje žádný limit velikosti dat.

Tato možnost je navržená tak, aby chránila prostředky v klientském počítači.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaximumReceivedObjectSize

Určuje maximální velikost objektu, který může místní počítač přijímat ze vzdáleného počítače. Tato možnost je navržená tak, aby chránila prostředky v klientském počítači. Zadejte hodnotu v bajtech.

Pokud tento parametr vynecháte, v prostředí Windows PowerShell 2.0 neexistuje žádný limit velikosti objektu. Počínaje windows PowerShellem 3.0, pokud tento parametr vynecháte, výchozí hodnota je 209715200 bajty (nebo 200MB).

Typ:Int32
Position:Named
Default value:209715200
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaximumRedirection

Určuje, kolikrát PowerShell přesměruje připojení na alternativní identifikátor URI (Uniform Resource Identifier) před selháním připojení. Výchozí hodnota je 5. Hodnota 0 (nula) zabraňuje veškerému přesměrování.

Tato možnost se používá v relaci pouze v případě, že se v příkazu, kterým se relace vytváří, použije parametr AllowRedirection.

Typ:Int32
Position:Named
Default value:5
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NoCompression

Vypne kompresi paketů v relaci. Komprese používá více cyklů procesoru, ale zrychlová přenos.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NoEncryption

Vypne šifrování dat.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NoMachineProfile

Zabrání načtení profilu uživatele systému Windows. V důsledku toho může být relace vytvořena dříve, ale uživatelsky specifická nastavení, jako jsou nastavení registru, proměnné prostředí a certifikáty, nejsou v relaci k dispozici.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OpenTimeout

Určuje, jak dlouho klientský počítač čeká na navázání relace. Po vypršení intervalu se příkaz pro navázání připojení nezdaří. Zadejte hodnotu v milisekundách.

Výchozí hodnota je 180000 (3 minuty). Hodnota 0 (nula) znamená žádný časový limit; příkaz pokračuje po neomezenou dobu.

Typ:Int32
Aliasy:OpenTimeoutMSec
Position:Named
Default value:180000 (3 minutes)
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OperationTimeout

Určuje maximální dobu, po kterou WinRM čeká na úspěšné testy připojení z aktivního připojení, než zahájí vypršení časového limitu připojení. Další informace o WinRM naleznete v dokumentaci Windows Remote Management.

OperationTimeout nenařizuje časový limit pro příkazy nebo procesy běžící ve vzdálené relaci a neovlivňuje jiné protokoly vzdálené komunikace, jako je SSH.

Výchozí hodnota je 180000 (3 minuty). Hodnota 0 (nula) znamená žádný časový limit.

Typ:Int32
Aliasy:OperationTimeoutMSec
Position:Named
Default value:180000 (3 minutes)
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OutputBufferingMode

Určuje, jak se výstup příkazu spravuje v odpojených relacích, když se výstupní vyrovnávací paměť zaplní.

Pokud není režim výstupního ukládání do vyrovnávací paměti nastaven v relaci nebo v konfiguraci relace, výchozí hodnota je Block. Uživatelé mohou také změnit režim ukládání výstupu do vyrovnávací paměti při odpojení relace.

Pokud tento parametr vynecháte, hodnota OutputBufferingMode objektu SessionOption je None. Hodnota Block nebo Drop přepíše možnost přenosu režimu vyrovnávací paměti výstupu nastavenou v konfiguraci relace. Přijatelné hodnoty pro tento parametr jsou:

  • Block. Pokud je výstupní vyrovnávací paměť plná, spuštění se pozastaví, dokud se vyrovnávací paměť nesmaže.
  • Drop. Jakmile je výstupní vyrovnávací paměť plná, provádění pokračuje. Při ukládání nového výstupu se nejstarší výstup zahodí.
  • None. Není zadán žádný režim ukládání výstupu do vyrovnávací paměti.

Další informace o možnosti přenosu režimu vyrovnávací paměti výstupu naleznete v tématu New-PSTransportOption.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Typ:OutputBufferingMode
Přípustné hodnoty:None, Drop, Block
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProxyAccessType

Určuje, který mechanismus se používá k rozlišení názvu hostitele. Přijatelné hodnoty pro tento parametr jsou:

  • IEConfig
  • WinHttpConfig
  • AutoDetect
  • NoProxyServer
  • None

Výchozí hodnota je None.

Informace o hodnotách tohoto parametru naleznete v sekci ProxyAccessType Enumerace.

Typ:ProxyAccessType
Přípustné hodnoty:None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProxyAuthentication

Určuje způsob ověřování, který se používá při řešení proxy serveru. Přijatelné hodnoty pro tento parametr jsou:

  • Basic
  • Digest
  • Negotiate

Výchozí hodnota je Negotiate.

Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism – výčet.

Typ:AuthenticationMechanism
Přípustné hodnoty:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Default value:Negotiate
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProxyCredential

Určuje přihlašovací údaje, které se mají použít pro ověřování proxy serveru. Zadejte proměnnou, která obsahuje objekt PSCredential nebo příkaz, který získá objekt PSCredential, například příkaz Get-Credential. Pokud tato možnost není nastavená, nejsou zadány žádné přihlašovací údaje.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SkipCACheck

Určuje, že když se připojí přes PROTOKOL HTTPS, klient neověří, že certifikát serveru je podepsaný důvěryhodnou certifikační autoritou (CA).

Tuto možnost použijte pouze v případě, že je vzdálený počítač důvěryhodný pomocí jiného mechanismu, například pokud je vzdálený počítač součástí sítě, která je fyzicky zabezpečená a izolovaná nebo pokud je vzdálený počítač uveden jako důvěryhodný hostitel v konfiguraci WinRM.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SkipCNCheck

Určuje, že běžný název certifikátu (CN) serveru nemusí odpovídat názvu hostitele serveru. Tato možnost se používá pouze ve vzdálených operacích, které používají protokol HTTPS.

Tuto možnost použijte jenom pro důvěryhodné počítače.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SkipRevocationCheck

Neověřuje stav odvolání certifikátu serveru.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UICulture

Určuje jazyk uživatelského rozhraní, který se má použít pro relaci.

Mezi platné hodnoty patří:

  • Název jazykové kulturní verze ve formátu <languagecode2>-<country/regioncode2>, například ja-JP
  • Proměnná, která obsahuje objekt CultureInfo
  • Příkaz, který získá objekt CultureInfo, například Get-Culture

Výchozí hodnota je $nulla jazyková verze uživatelského rozhraní, která je nastavena v operačním systému při vytvoření relace.

Typ:CultureInfo
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UseUTF16

Označuje, že tato rutina kóduje požadavek ve formátu UTF16 místo formátu UTF8.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Do této rutiny nemůžete přesměrovat objekty.

Výstupy

PSSessionOption

Poznámky

Pokud parametr SessionOption není použit v příkazu k vytvoření PSSession, jsou možnosti relace určeny hodnotami vlastností proměnné předvolby $PSSessionOption, pokud je nastavena. Další informace o proměnné $PSSessionOption naleznete 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.