New-PSTransportOption
Vytvoří objekt, který obsahuje rozšířené možnosti konfigurace relace.
Syntaxe
New-PSTransportOption
[-MaxIdleTimeoutSec <Int32>]
[-ProcessIdleTimeoutSec <Int32>]
[-MaxSessions <Int32>]
[-MaxConcurrentCommandsPerSession <Int32>]
[-MaxSessionsPerUser <Int32>]
[-MaxMemoryPerSessionMB <Int32>]
[-MaxProcessesPerSession <Int32>]
[-MaxConcurrentUsers <Int32>]
[-IdleTimeoutSec <Int32>]
[-OutputBufferingMode <OutputBufferingMode>]
[<CommonParameters>] Description
Rutina New-PSTransportOption vytvoří objekt, který obsahuje možnosti přenosu pro konfigurace relací. Objekt můžete použít jako hodnotu parametru TransportOption rutin, které vytvářejí nebo mění konfiguraci relace, jako jsou Register-PSSessionConfiguration a rutiny Set-PSSessionConfiguration.
Nastavení možností přenosu můžete také změnit úpravou hodnot vlastností konfigurace relace na jednotce WSMan: Další informace naleznete v tématu WSMan Provider.
Možnosti konfigurace relace představují hodnoty relace nastavené na straně serveru nebo příjem konce vzdáleného připojení. Klient na straně klienta nebo odeslání konce 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í najdete v tématu 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
PS C:\> 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
The first command uses the **New-PSTransportOption** cmdlet to create a transport options object, which it saves in the $t variable. The command uses the *MaxSessions* parameter to increase the maximum number of sessions to 40.
PS C:\> $t = New-PSTransportOption -MaxSessions 40
The second command uses the **Register-PSSessionConfiguration** cmdlet create the ITTasks session configuration. The command uses the *TransportOption* parameter to specify the transport options object in the $t variable.
PS C:\> Register-PSSessionConfiguration -Name ITTasks -TransportOption $t
The third command uses the Get-PSSessionConfiguration cmdlet to get the ITTasks session configurations and the Format-List cmdlet to display all of the properties of the session configuration object in a list. The output shows that the value of the **MaxShells** property of the session configuration is 40.
PS C:\> Get-PSSessionConfiguration -Name ITTasks | Format-List -Property *
Architecture : 64
Filename : %windir%\system32\pwrshplugin.dll
ResourceUri : https://schemas.microsoft.com/powershell/ITTasks
MaxConcurrentCommandsPerShell : 1000
UseSharedProcess : false
ProcessIdleTimeoutSec : 0
xmlns : https://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 :Tento příklad ukazuje, jak pomocí objektu možností přenosu nastavit možnosti konfigurace relace.
Příklad 3: Nastavení možnosti přenosu
The first command uses the **New-PSTransportOption** cmdlet to create a transport option object. The command uses the *IdleTimeoutSec* parameter to set the **IdleTimeoutSec** property value of the object to one hour (3600 seconds). The command saves the transport objects object in the $t variable.
PS C:\> $t = New-PSTransportOption -IdleTimeoutSec 3600
The second command uses the Set-PSSessionConfiguration cmdlet to change the transport options of the ITTasks session configuration. The command uses the *TransportOption* parameter to specify the transport options object in the $t variable.
PS C:\> Set-PSSessionConfiguration -Name ITTasks -TransportOption $t
The third command uses the New-PSSession cmdlet to create the MyITTasks session on the local computer. The command uses the **ConfigurationName** property to specify the ITTasks session configuration. The command saves the session in the $s variable.Notice that the command does not use the *SessionOption* parameter of **New-PSSession** to set a custom idle time-out for the session. If it did, the idle time-out value set in the session option would take precedence over the idle time-out set in the session configuration.
PS C:\> $s = New-PSSession -Name MyITTasks -ConfigurationName ITTasks
The fourth command uses the Format-List cmdlet to display all properties of the session in the $s variable in a list. The output shows that the session has an idle time-out of one hour (360,000 milliseconds).
PS C:\> $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.RemoteRunspaceTento příkaz ukazuje účinek nastavení možnosti přenosu v konfiguraci relace na relacích, které používají konfiguraci relace.
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 prezenčních signálů. Po vypršení 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 jenom v případě, že relace nevysadila časový limit.
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).
Maximum je hodnota IdleTimeout vlastnost Shell objektů 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 a v konfiguraci relace, hodnota nastavená v možnostech relace má přednost, ale nemůže překročit hodnotu MaxIdleTimeoutMs vlastnost konfigurace relace. Pokud chcete nastavit hodnotu vlastnosti MaxIdleTimeoutMs, použijte parametr MaxIdleTimeoutSec.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-MaxConcurrentCommandsPerSession
Omezí počet příkazů, které se můžou spustit současně v každé relaci, na zadanou hodnotu. Výchozí hodnota je 1000.
Parametr
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-MaxIdleTimeoutSec
Omezuje časový limit nečinnosti nastavený pro každou relaci na zadanou hodnotu. Výchozí hodnota je [Int]::MaxValue (~25 dní).
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 jenom v případě, že relace nevysadila časový limit.
Parametr
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-MaxSessions
Omezuje počet relací, které používají konfiguraci relace. Výchozí hodnota je 25.
Parametr MaxSessions odpovídá vlastnosti MaxShells konfigurace relace.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-MaxSessionsPerUser
Omezuje počet relací, které používají konfiguraci relace, a spouští se s přihlašovacími údaji daného uživatele na zadanou hodnotu. Výchozí hodnota je 25.
Při zadávání této hodnoty zvažte, že mnoho uživatelů může používat přihlašovací údaje spustit jako uživatel.
Parametr MaxSessionsPerUser odpovídá vlastnosti MaxShellsPerUser konfigurace relace.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| 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í. Přijatelné hodnoty pro tento parametr jsou:
- Blokovat. Pokud je výstupní vyrovnávací paměť plná, spuštění se pozastaví, dokud se vyrovnávací paměť nesmaže.
- Kapka. Jakmile je výstupní vyrovnávací paměť plná, provádění bude pokračovat. Při ukládání nového výstupu se nejstarší výstup zahodí.
- Žádný. Není zadán žádný režim ukládání výstupu do vyrovnávací paměti.
Výchozí hodnota OutputBufferingMode vlastnost relace je Block.
| Typ: | OutputBufferingMode |
| Přípustné hodnoty: | None, Drop, Block |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | 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 procesu 28800 sekund (8 hodin).
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
Vstupy
None
Vstup do této rutiny nelze převést.
Výstupy
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.