New-PSTransportOption

  • Referencia
Modul:
Microsoft.PowerShell.Core

Létrehoz egy objektumot, amely speciális beállításokat tartalmaz egy munkamenet-konfigurációhoz.

Syntax

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

Description

A New-PSTransportOption parancsmag létrehoz egy objektumot, amely átviteli beállításokat tartalmaz a munkamenet-konfigurációkhoz. Az objektumot a munkamenet-konfigurációt létrehozó vagy módosító parancsmagok TransportOption paraméterének értékeként használhatja, például a parancsmagokat és Set-PSSessionConfiguration a Register-PSSessionConfiguration parancsmagokat.

Az átviteli beállítás beállításait a WSMan: meghajtó munkamenetkonfigurációs tulajdonságainak szerkesztésével is módosíthatja. További információ: WSMan Provider.

A munkamenet-konfigurációs beállítások a kiszolgálóoldalon beállított munkamenet-értékeket jelölik, vagy távoli kapcsolat végét fogadják. Az ügyféloldali vagy a kapcsolat végét küldő beállításértékek megadhatóak a munkamenet létrehozásakor, illetve amikor az ügyfél leválasztja a munkamenetet, vagy újra csatlakozik a munkamenethez. Ellenkező rendelkezés hiányában a beállítási értékek ütközése esetén az ügyféloldali értékek elsőbbséget élveznek. Az ügyféloldali értékek azonban nem sértheti meg a munkamenet-konfigurációban beállított maximális értékeket és kvótákat.

Paraméterek nélkül létrehoz egy átviteli beállításobjektumot, New-PSTransportOption amely az összes beállításhoz null értékű. Ha kihagy egy paramétert, az objektum null értékkel rendelkezik a paraméter által képviselt tulajdonsághoz. A null érték nem befolyásolja a munkamenet konfigurációját.

További információ a munkamenet-beállításokról: New-PSSessionOption. A munkamenet-konfigurációkkal kapcsolatos további tudnivalókért tekintse meg az about_Session_Configuration_Files című témakört.

Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.

Példák

1. példa: Alapértelmezett átviteli beállítás létrehozása

New-PSTransportOption

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

Ez a parancs paraméterek nélkül futtatja a New-PSTransportOption parancsot. A kimenet azt mutatja, hogy a parancsmag létrehoz egy átviteli beállításobjektumot, amely minden tulajdonsághoz null értékű.

2. példa: Munkamenet-konfigurációs beállítások lekérése

Ez a példa bemutatja, hogyan lehet átviteli beállítások objektumot használni a munkamenet-konfigurációs beállítások beállításához.

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

Az első parancs a New-PSTransportOption parancsmaggal hoz létre egy átviteli beállítások objektumot, amelyet a $t változóban ment. A parancs a MaxSessions paraméter használatával 40-re növeli a munkamenetek maximális számát.

A második parancs a Register-PSSessionConfiguration parancsmaggal hozza létre az ITTasks-munkamenet konfigurációját. A parancs a TransportOption paraméter használatával adja meg a változó átviteli beállításainak objektumát $t .

A harmadik parancs a parancsmagot használja az Get-PSSessionConfiguration ITTasks-munkamenet konfigurációinak lekéréséhez, a Format-List parancsmag pedig a munkamenet-konfigurációs objektum összes tulajdonságának megjelenítéséhez egy listában. A kimenet azt mutatja, hogy a munkamenet-konfiguráció MaxShells tulajdonságának értéke 40.

3. példa: Átviteli beállítás beállítása

Ez a parancs bemutatja, hogy milyen hatással van egy átviteli beállítás egy munkamenet-konfigurációban a munkamenet-konfigurációt használó munkamenetekre.

$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

Az első parancs a New-PSTransportOption parancsmaggal hoz létre egy átviteli beállításobjektumot. A parancs az IdleTimeoutSec paraméter használatával állítja be az objektum IdleTimeoutSec tulajdonságértékét egy órára (3600 másodpercre). A parancs menti az átviteli objektumot a $t változóban.

A második parancs a Set-PSSessionConfiguration parancsmaggal módosítja az ITTasks-munkamenet konfigurációjának átviteli beállításait. A parancs a TransportOption paraméter használatával adja meg a változó átviteli beállításainak objektumát $t .

A harmadik parancs a New-PSSession parancsmaggal hozza létre a MyITTasks-munkamenetet a helyi számítógépen. A parancs a ConfigurationName tulajdonságot használja az ITTasks-munkamenet konfigurációjának megadásához. A parancs menti a munkamenetet a $s változóban. Figyelje meg, hogy a parancs nem használja a SessionOption paramétert New-PSSession a munkamenet egyéni tétlenségi időtúllépésének beállításához. Ha igen, a munkamenet-beállításban beállított tétlen időtúllépési érték elsőbbséget élvezne a munkamenet-konfiguráció üresjárati időkészletével szemben.

A negyedik parancs a Format-List parancsmaggal jeleníti meg a munkamenet összes tulajdonságát a változóban egy $s listában. A kimenet azt mutatja, hogy a munkamenet egy óra tétlen időtúllépéssel rendelkezik (360 000 ezredmásodperc).

Paraméterek

-IdleTimeoutSec

Meghatározza, hogy az egyes munkamenetek mennyi ideig maradnak nyitva, ha a távoli számítógép nem kap kommunikációt a helyi számítógépről. Ez magában foglalja a szívverés jelét. Ha az időköz lejár, a munkamenet bezárul.

A tétlen időtúllépési érték akkor fontos, ha a felhasználó leválasztja a munkamenetet, és újra csatlakozik egy munkamenethez. A felhasználó csak akkor csatlakozhat újra, ha a munkamenet nem időtúllépést váltott ki.

Az IdleTimeoutSec paraméter egy munkamenet-konfiguráció IdleTimeoutMs tulajdonságának felel meg.

Adjon meg egy értéket másodpercek alatt. Az alapértelmezett érték 7200 (2 óra). A minimális érték 60 (1 perc). A maximális érték a Shell-objektumok IdleTimeout tulajdonságának értéke a WSMan-konfigurációban (WSMan:\\\<ComputerName\>\Shell\IdleTimeout). Az alapértelmezett érték 72000000 ezredmásodperc (2 óra).

Ha a munkamenet beállításaiban és a munkamenet-konfigurációban üresjárati időtúllépési érték van beállítva, a munkamenet beállításaiban megadott érték elsőbbséget élvez, de nem haladhatja meg a munkamenet-konfiguráció MaxIdleTimeoutMs tulajdonságának értékét. A MaxIdleTimeoutMs tulajdonság értékének beállításához használja a MaxIdleTimeoutSec paramétert.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxConcurrentCommandsPerSession

Az egyes munkamenetekben egyszerre futtatható parancsok számát a megadott értékre korlátozza. Az alapértelmezett érték 1000.

A MaxConcurrentCommandsPerSession paraméter egy munkamenet-konfiguráció MaxConcurrentCommandsPerShell tulajdonságának felel meg.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxConcurrentUsers

Az egyes munkamenetekben egyszerre parancsokat futtatni képes felhasználók számát a megadott értékre korlátozza. Az alapértelmezett érték 5.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxIdleTimeoutSec

Az egyes munkamenetekhez beállított tétlenségi időtúllépést a megadott értékre korlátozza. Az alapértelmezett érték [Int]::MaxValue (~25 nap).

A tétlen időtúllépési érték akkor fontos, ha a felhasználó leválasztja a munkamenetet, és újra csatlakozik egy munkamenethez. A felhasználó csak akkor csatlakozhat újra, ha a munkamenet nem időtúllépést váltott ki.

A MaxIdleTimeoutSec paraméter egy munkamenet-konfiguráció MaxIdleTimeoutMs tulajdonságának felel meg.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxMemoryPerSessionMB

Az egyes munkamenetek által használt memóriát a megadott értékre korlátozza. Adjon meg egy értéket megabájtban. Az alapértelmezett érték 1024 megabájt (1 GB).

A MaxMemoryPerSessionMB paraméter egy munkamenet-konfiguráció MaxMemoryPerShellMB tulajdonságának felel meg.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxProcessesPerSession

Az egyes munkamenetekben futó folyamatok számát a megadott értékre korlátozza. Az alapértelmezett érték 15.

A MaxProcessesPerSession paraméter egy munkamenet-konfiguráció MaxProcessesPerShell tulajdonságának felel meg.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxSessions

Korlátozza a munkamenet-konfigurációt használó munkamenetek számát. Az alapértelmezett érték 25.

A MaxSessions paraméter egy munkamenet-konfiguráció MaxShells tulajdonságának felel meg.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MaxSessionsPerUser

A munkamenet-konfigurációt használó és az adott felhasználó hitelesítő adataival futtatott munkamenetek számát a megadott értékre korlátozza. Az alapértelmezett érték 25.

Ha megadja ezt az értéket, vegye figyelembe, hogy sok felhasználó használja a futtatás hitelesítő adatait felhasználóként.

A MaxSessionsPerUser paraméter egy munkamenet-konfiguráció MaxShellsPerUser tulajdonságának felel meg.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OutputBufferingMode

Meghatározza, hogyan történik a parancskimenet kezelése a leválasztott munkamenetekben, amikor a kimeneti puffer megtelik. A paraméter elfogadható értékei a következők:

  • Block Ha a kimeneti puffer megtelt, a végrehajtás fel van függesztve, amíg a puffer nem tiszta.
  • Drop Ha a kimeneti puffer megtelt, a végrehajtás folytatódik. Az új kimenet mentésekor a rendszer elveti a legrégebbi kimenetet.
  • None Nincs megadva kimeneti pufferelési mód.

A munkamenetek OutputBufferingMode tulajdonságának alapértelmezett értéke a Blokk.

Type:Nullable<T>[OutputBufferingMode]
Accepted values:None, Drop, Block
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProcessIdleTimeoutSec

Az egyes gazdagépfolyamatok időtúllépését a megadott értékre korlátozza. Az alapértelmezett érték (0) azt jelenti, hogy a folyamathoz nincs időtúllépési érték.

Más munkamenet-konfigurációk folyamatonkénti időtúllépési értékekkel rendelkeznek. A Microsoft.PowerShell.Workflow munkamenet konfigurációja például 28800 másodperc (8 óra) folyamatonkénti időtúllépési értékkel rendelkezik.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

WSManConfigurationOption

Jegyzetek

  • A munkamenet-konfigurációs objektumok tulajdonságai a munkamenet-konfiguráció beállításaitól és a beállítások értékétől függően változnak. Emellett a munkamenet-konfigurációs fájlt használó munkamenet-konfigurációk további tulajdonságokkal is rendelkeznek.