New-PSTransportOption

Modul:: Microsoft.PowerShell.Core Module

Vytvoří objekt, který obsahuje rozšířené možnosti konfigurace relace.

Syntax

Default (Výchozí)

New-PSTransportOption
    [-MaxIdleTimeoutSec <Int32>]
    [-ProcessIdleTimeoutSec <Int32>]
    [-MaxSessions <Int32>]
    [-MaxConcurrentCommandsPerSession <Int32>]
    [-MaxSessionsPerUser <Int32>]
    [-MaxMemoryPerSessionMB <Int32>]
    [-MaxProcessesPerSession <Int32>]
    [-MaxConcurrentUsers <Int32>]
    [-IdleTimeoutSec <Int32>]
    [-OutputBufferingMode <OutputBufferingMode>]
    [<CommonParameters>]

Description

Cmdlet New-PSTransportOption vytvoří objekt, který obsahuje možnosti transportu pro konfigurace relací. Objekt můžete použít jako hodnotu parametru TransportOption u rutin, které vytvářejí nebo mění konfiguraci relace, například u rutin Register-PSSessionConfiguration a Set-PSSessionConfiguration.

Můžete také změnit nastavení možností přenosu úpravou hodnot vlastností konfigurace relace na disku WSMan. Další informace naleznete v tématu WSMan Provider.

Možnosti konfigurace relace představují hodnoty relace nastavené na straně serveru nebo na straně přijímače vzdáleného připojení. Klientská strana nebo odesílající strana připojení může nastavit hodnoty možností relace při vytvoření relace nebo když se klient odpojí od relace nebo se k relaci znovu připojí. Pokud není uvedeno jinak, při konfliktu hodnot nastavení mají přednost hodnoty na straně klienta. Hodnoty na straně klienta ale nemohou porušit maximální hodnoty a kvóty nastavené v konfiguraci relace.

Bez parametrů New-PSTransportOption vygeneruje objekt možnosti přenosu, který má hodnoty null pro všechny možnosti. Pokud parametr vynecháte, má objekt hodnotu null pro vlastnost, kterou parametr představuje. Hodnota null nemá vliv na konfiguraci relace.

Další informace o možnostech relace naleznete v tématu New-PSSessionOption. Další informace o konfiguracích relací naleznete v části about_Session_Configurations.

Tato rutina byla zavedena ve Windows PowerShellu 3.0.

Příklady

Příklad 1: Vygenerování výchozí možnosti přenosu

New-PSTransportOption

ProcessIdleTimeoutSec           :
MaxIdleTimeoutSec               :
MaxSessions                     :
MaxConcurrentCommandsPerSession :
MaxSessionsPerUser              :
MaxMemoryPerSessionMB           :
MaxProcessesPerSession          :
MaxConcurrentUsers              :
IdleTimeoutSec                  :
OutputBufferingMode             :

Tento příkaz spustí New-PSTransportOption bez parametrů. Výstup ukazuje, že rutina generuje objekt možnosti přenosu, který má hodnoty null pro všechny vlastnosti.

Příklad 2: Získání možností konfigurace relace

Tento příklad ukazuje, jak pomocí objektu možností přenosu nastavit možnosti konfigurace relace.

$t = New-PSTransportOption -MaxSessions 40
Register-PSSessionConfiguration -Name ITTasks -TransportOption $t
Get-PSSessionConfiguration -Name ITTasks | Format-List -Property *

Architecture                  : 64
Filename                      : %windir%\system32\pwrshplugin.dll
ResourceUri                   : http://schemas.microsoft.com/powershell/ITTasks
MaxConcurrentCommandsPerShell : 1000
UseSharedProcess              : false
ProcessIdleTimeoutSec         : 0
xmlns                         : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
MaxConcurrentUsers            : 5
lang                          : en-US
SupportsOptions               : true
ExactMatch                    : true
RunAsUser                     :
IdleTimeoutms                 : 7200000
PSVersion                     : 3.0
OutputBufferingMode           : Block
AutoRestart                   : false
MaxShells                     : 40
MaxMemoryPerShellMB           : 1024
MaxIdleTimeoutms              : 43200000
SDKVersion                    : 2
Name                          : ITTasks
XmlRenderingType              : text
Capability                    : {Shell}
RunAsPassword                 :
MaxProcessesPerShell          : 15
Enabled                       : True
MaxShellsPerUser              : 25
Permission                    :

První příkaz pomocí rutiny New-PSTransportOption vytvoří objekt možností přenosu, který uloží do proměnné $t. Příkaz používá parametr MaxSessions ke zvýšení maximálního počtu relací na 40.

Druhý příkaz používá cmdlet Register-PSSessionConfiguration k vytvoření konfigurace relace ITTasks. Příkaz používá parametr TransportOption k určení objektu možností přenosu v proměnné $t.

Třetí příkaz používá rutinu Get-PSSessionConfiguration k získání konfigurací relací ITTasks a rutiny Format-List k zobrazení všech vlastností objektu konfigurace relace v seznamu. Výstup ukazuje, že hodnota vlastnosti MaxShells v konfiguraci relace je 40.

Příklad 3: Nastavení možnosti přenosu

Tento příkaz ukazuje účinek nastavení možnosti přenosu v konfiguraci relace na relacích, které používají konfiguraci relace.

$t = New-PSTransportOption -IdleTimeoutSec 3600
Set-PSSessionConfiguration -Name ITTasks -TransportOption $t
$s = New-PSSession -Name MyITTasks -ConfigurationName ITTasks
$s | Format-List -Property *

State                  : Opened
IdleTimeout            : 3600000
OutputBufferingMode    : Block
ComputerName           : localhost
ConfigurationName      : ITTasks
InstanceId             : 4110c3f5-68ea-40fa-9bbf-04a433dbb02d
Id                     : 1
Name                   : MyITTasks
Availability           : Available
ApplicationPrivateData : {PSVersionTable}
Runspace               : System.Management.Automation.RemoteRunspace

První příkaz používá rutinu New-PSTransportOption k vytvoření objektu možnosti přenosu. Příkaz používá parametr IdleTimeoutSec k nastavení hodnoty vlastnosti IdleTimeoutSec objektu na jednu hodinu (3600 sekund). Příkaz uloží objekt transportních objektů do proměnné $t.

Druhý příkaz používá rutinu Set-PSSessionConfiguration ke změně přenosových možností konfigurace relace ITTasks. Příkaz používá parametr TransportOption k určení objektu možností přenosu v proměnné $t.

Třetí příkaz používá cmdlet New-PSSession k vytvoření relace MyITTasks na místním počítači. Příkaz používá vlastnost ConfigurationName k určení konfigurace relace ITTasks. Příkaz uloží relaci do proměnné $s. Všimněte si, že příkaz nepoužívá parametr SessionOptionNew-PSSession k nastavení vlastního časového limitu nečinnosti relace. Pokud ano, hodnota časového limitu nečinnosti nastavená v možnosti relace bude mít přednost před časovým limitem nečinnosti nastaveným v konfiguraci relace.

Čtvrtý příkaz používá cmdlet Format-List k zobrazení všech vlastností relace v proměnné $s v seznamu. Výstup ukazuje, že relace má časový limit nečinnosti nastavený na jednu hodinu (360 000 milisekund).

Parametry

-IdleTimeoutSec

Určuje, jak dlouho bude každá relace 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á, když uživatel hodlá odpojit relaci a znovu se k relaci připojit. Uživatel se může znovu připojit pouze pokud nevypršel časový limit relace.

Parametr IdleTimeoutSec odpovídá vlastnosti IdleTimeoutMs konfigurace relace.

Zadejte hodnotu v sekundách. Výchozí hodnota je 7200 (2 hodiny). Minimální hodnota je 60 (1 minuta). Maximální hodnotou je hodnota vlastnosti IdleTimeout objektů Shell v konfiguraci WSMan (WSMan:\\\<ComputerName\>\Shell\IdleTimeout). Výchozí hodnota je 7200000 milisekund (2 hodiny).

Pokud je hodnota časového limitu nečinnosti nastavena v možnostech relace i v konfiguraci relace, má přednost hodnota nastavená v možnostech relace, avšak nesmí překročit hodnotu vlastnosti MaxIdleTimeoutMs v konfiguraci relace. Pokud chcete nastavit hodnotu vlastnosti MaxIdleTimeoutMs, použijte parametr MaxIdleTimeoutSec.

Vlastnosti parametru

Typ:	Nullable<T>[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:	True
Hodnota ze zbývajících argumentů:	False

-MaxConcurrentCommandsPerSession

Omezí počet příkazů, které mohou být spuštěny současně v každé relaci, na zadanou hodnotu. Výchozí hodnota je 1000.

Parametr MaxConcurrentCommandsPerSession odpovídá vlastnosti MaxConcurrentCommandsPerShell konfigurace relace.

Vlastnosti parametru

Typ:	Nullable<T>[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:	True
Hodnota ze zbývajících argumentů:	False

-MaxConcurrentUsers

Omezuje počet uživatelů, kteří můžou spouštět příkazy současně v každé relaci, na zadanou hodnotu. Výchozí hodnota je 5.

Vlastnosti parametru

Typ:	Nullable<T>[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:	True
Hodnota ze zbývajících argumentů:	False

-MaxIdleTimeoutSec

Omezuje časový limit nečinnosti nastavený pro každou relaci na zadanou hodnotu. Výchozí hodnota je [Int]::MaxValue (~25 dní).

Parametr MaxIdleTimeoutSec odpovídá vlastnosti MaxIdleTimeoutMs konfigurace relace.

Vlastnosti parametru

Typ:	Nullable<T>[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:	True
Hodnota ze zbývajících argumentů:	False

-MaxMemoryPerSessionMB

Omezuje paměť používanou každou relací na zadanou hodnotu. Zadejte hodnotu v megabajtech. Výchozí hodnota je 1024 megabajtů (1 GB).

Parametr MaxMemoryPerSessionMB odpovídá vlastnosti MaxMemoryPerShellMB konfigurace relace.

Vlastnosti parametru

Typ:	Nullable<T>[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:	True
Hodnota ze zbývajících argumentů:	False

-MaxProcessesPerSession

Omezuje počet procesů spuštěných v každé relaci na zadanou hodnotu. Výchozí hodnota je 15.

Parametr MaxProcessesPerSession odpovídá vlastnosti MaxProcessesPerShell konfigurace relace.

Vlastnosti parametru

Typ:	Nullable<T>[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:	True
Hodnota ze zbývajících argumentů:	False

-MaxSessions

Omezuje počet relací, které používají konfiguraci relace. Výchozí hodnota je 25.

Parametr MaxSessions odpovídá vlastnosti MaxShells konfigurace relace.

Vlastnosti parametru

Typ:	Nullable<T>[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:	True
Hodnota ze zbývajících argumentů:	False

-MaxSessionsPerUser

Omezuje počet relací, které spouštějí konfiguraci relace a využívají přihlašovací údaje daného uživatele, na specifikovanou hodnotu. Výchozí hodnota je 25.

Při zadávání této hodnoty mějte na paměti, že mnoho uživatelů může používat přihlašovací údaje pro běh jako uživatel.

Parametr MaxSessionsPerUser odpovídá vlastnosti MaxShellsPerUser konfigurace relace.

Vlastnosti parametru

Typ:	Nullable<T>[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:	True
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í. 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 Když je výstupní buffer plný, pokračuje se v provádění. 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.

Výchozí hodnota vlastnosti OutputBufferingMode relací je Block.

Vlastnosti parametru

Typ:	Nullable<T>[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:	True
Hodnota ze zbývajících argumentů:	False

-ProcessIdleTimeoutSec

Omezuje časový limit pro každý hostitelský proces na zadanou hodnotu. Výchozí hodnota 0 znamená, že pro proces neexistuje žádná hodnota časového limitu.

Jiné konfigurace relací mají hodnoty časového limitu pro jednotlivé procesy. Například konfigurace relace Microsoft.PowerShell.Workflow má hodnotu časového limitu pro jednotlivé procesy 28800 sekund (8 hodin).

Vlastnosti parametru

Typ:	Nullable<T>[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:	True
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

WSManConfigurationOption

Poznámky

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.

Sdílet prostřednictvím

New-PSTransportOption

Syntax

Default (Výchozí)

Description

Příklady

Příklad 1: Vygenerování výchozí možnosti přenosu

Příklad 2: Získání možností konfigurace relace

Příklad 3: Nastavení možnosti přenosu

Parametry

-IdleTimeoutSec

Vlastnosti parametru

Sady parametrů

-MaxConcurrentCommandsPerSession

Vlastnosti parametru

Sady parametrů

-MaxConcurrentUsers

Vlastnosti parametru

Sady parametrů

-MaxIdleTimeoutSec

Vlastnosti parametru

Sady parametrů

-MaxMemoryPerSessionMB

Vlastnosti parametru

Sady parametrů

-MaxProcessesPerSession

Vlastnosti parametru

Sady parametrů

-MaxSessions

Vlastnosti parametru

Sady parametrů

-MaxSessionsPerUser

Vlastnosti parametru

Sady parametrů

-OutputBufferingMode

Vlastnosti parametru

Sady parametrů

-ProcessIdleTimeoutSec

Vlastnosti parametru

Sady parametrů

CommonParameters

Vstupy

None

Výstupy

WSManConfigurationOption

Poznámky

Související odkazy