New-PSSessionOption

Modul:

Microsoft.PowerShell.Core Module

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

Syntax

Default (Výchozí)

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. Další informace o preferenční proměnné $PSSessionOption naleznete v části 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í naleznete v části 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.

Další informace o preferenční proměnné $PSSessionOption naleznete v části about_Preference_Variables. Další informace o profilech, viz 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.

Vlastnosti parametru

Typ:	PSPrimitiveDictionary
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	60000
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	CancelTimeoutMSec

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	CultureInfo
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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í časového 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. Pro více informací se podívejte na Disconnect-PSSession a Connect-PSSession.

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

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	IdleTimeoutMSec

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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).

Vlastnosti parametru

Typ:	Int32
Default value:	209715200
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	5
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-NoCompression

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-NoEncryption

Vypne šifrování dat.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	180000 (3 minutes)
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	OpenTimeoutMSec

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	Int32
Default value:	180000 (3 minutes)
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	OperationTimeoutMSec

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-OutputBufferingMode

Určuje, jak se výstup příkazu zpracovává v odpojených relacích, když se výstupní buffer 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.

Vlastnosti parametru

Typ:	OutputBufferingMode
Default value:	None
Přípustné hodnoty:	None, Drop, Block
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	ProxyAccessType
Default value:	None
Přípustné hodnoty:	None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	AuthenticationMechanism
Default value:	Negotiate
Přípustné hodnoty:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SkipRevocationCheck

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	CultureInfo
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-UseUTF16

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Do tohoto cmdletu nemůžete předávat 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.

Související odkazy

• Příkaz Enter-PSSession
• Invoke-Command
• New-PSSession