New-PSTransportOption

  • Başvuru
Modül:
Microsoft.PowerShell.Core

Oturum yapılandırması için gelişmiş seçenekler içeren bir nesne oluşturur.

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

cmdlet'i New-PSTransportOption , oturum yapılandırmaları için aktarım seçeneklerini içeren bir nesne oluşturur. nesnesini, ve Set-PSSessionConfiguration cmdlet'leri gibi bir oturum yapılandırmasını oluşturan veya değiştiren cmdlet'lerin TransportOption parametresinin Register-PSSessionConfiguration değeri olarak kullanabilirsiniz.

WSMan: sürücüsündeki oturum yapılandırma özelliklerinin değerlerini düzenleyerek aktarım seçeneği ayarlarını da değiştirebilirsiniz. Daha fazla bilgi için bkz. WSMan Sağlayıcısı.

Oturum yapılandırma seçenekleri, sunucu tarafında ayarlanan veya uzak bağlantının sonunu alan oturum değerlerini temsil eder. İstemci tarafı veya bağlantının sonuna gönderme, oturum oluşturulduğunda veya istemcinin oturumla bağlantısı kesildiğinde veya yeniden bağlandığında oturum seçeneği değerlerini ayarlayabilir. Aksi belirtilmedikçe, ayar değerleri çakıştığında istemci tarafı değerleri öncelikli olur. Ancak istemci tarafı değerleri, oturum yapılandırmasında ayarlanan maksimum değerleri ve kotaları ihlal edemez.

Parametreler olmadan, New-PSTransportOption tüm seçenekler için null değerlere sahip bir aktarım seçeneği nesnesi oluşturur. Bir parametreyi atlarsanız, parametrenin temsil ettiği özellik için nesnenin null değeri vardır. Null değer oturum yapılandırmasını etkilemez.

Oturum seçenekleri hakkında daha fazla bilgi için bkz New-PSSessionOption. . Oturum yapılandırmaları hakkında daha fazla bilgi edinmek için bkz. about_Session_Configurations.

Bu cmdlet, Windows PowerShell 3.0'da kullanıma sunulmuştur.

Örnekler

Örnek 1: Varsayılan aktarım seçeneği oluşturma

New-PSTransportOption

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

Bu komut parametresiz komutunu New-PSTransportOption çalıştırır. Çıktı, cmdlet'in tüm özellikler için null değerler içeren bir aktarım seçeneği nesnesi oluşturduğunu gösterir.

Örnek 2: Oturum yapılandırma seçeneklerini alma

Bu örnekte, oturum yapılandırma seçeneklerini ayarlamak için aktarım seçenekleri nesnesinin nasıl kullanılacağı gösterilmektedir.

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

İlk komut cmdlet'ini New-PSTransportOption kullanarak değişkene $t kaydettiği bir aktarım seçenekleri nesnesi oluşturur. Komut, maksimum oturum sayısını 40'a yükseltmek için MaxSessions parametresini kullanır.

İkinci komut, BTTasks oturum yapılandırmasını oluşturmak için cmdlet'ini kullanır Register-PSSessionConfiguration . komutu, değişkendeki aktarım seçenekleri nesnesini belirtmek için TransportOption parametresini $t kullanır.

Üçüncü komut, BTTasks oturum yapılandırmalarını almak için cmdlet'ini Format-List ve oturum yapılandırma nesnesinin tüm özelliklerini bir listede görüntülemek için cmdlet'ini kullanırGet-PSSessionConfiguration. Çıkış, oturum yapılandırmasının MaxShells özelliğinin değerinin 40 olduğunu gösterir.

Örnek 3: Taşıma seçeneğini ayarlama

Bu komut, oturum yapılandırmasında aktarım seçeneğini ayarlamanın oturum yapılandırmasını kullanan oturumlar üzerindeki etkisini gösterir.

$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

İlk komut, bir aktarım seçeneği nesnesi oluşturmak için cmdlet'ini kullanır New-PSTransportOption . Komut, nesnenin IdleTimeoutSec özellik değerini bir saat (3600 saniye) olarak ayarlamak için IdleTimeoutSec parametresini kullanır. komutu, aktarım nesneleri nesnesini değişkene $t kaydeder.

İkinci komut, ITTasks oturum yapılandırmasının aktarım seçeneklerini değiştirmek için cmdlet'ini kullanır Set-PSSessionConfiguration . komutu, değişkendeki aktarım seçenekleri nesnesini belirtmek için TransportOption parametresini $t kullanır.

Üçüncü komut cmdlet'ini New-PSSession kullanarak yerel bilgisayarda MyITTasks oturumunu oluşturur. komutu, ITTasks oturum yapılandırmasını belirtmek için ConfigurationName özelliğini kullanır. komutu oturumu $s değişkenine kaydeder. Komutun oturum için özel boşta kalma zaman aşımı ayarlamak için sessionOption parametresini New-PSSession kullanmadığını unutmayın. Bu durumda oturum seçeneğinde ayarlanan boşta kalma zaman aşımı değeri, oturum yapılandırmasındaki boşta kalma zaman aşımı kümesinden öncelikli olacaktır.

Dördüncü komut, bir listedeki değişkende Format-List oturumun tüm özelliklerini görüntülemek için cmdlet'ini $s kullanır. Çıktı, oturumun boşta kalma süresi bir saat (360.000 milisaniye) olduğunu gösterir.

Parametreler

-IdleTimeoutSec

Uzak bilgisayar yerel bilgisayardan herhangi bir iletişim almazsa her oturumun ne kadar süre açık kalacağını belirler. Bu sinyal sinyalini içerir. Aralığın süresi dolduğunda oturum kapanır.

Kullanıcı oturumun bağlantısını kesmeyi ve yeniden bağlanmayı amaçladığında boşta kalma zaman aşımı değeri önemli bir öneme sahip olur. Kullanıcı yalnızca oturum zaman aşımına uğradıysa yeniden bağlanabilir.

IdleTimeoutSec parametresi, oturum yapılandırmasının IdleTimeoutMs özelliğine karşılık gelir.

Saniye olarak bir değer girin. Varsayılan değer 7200'dür (2 saat). En düşük değer 60 'tır (1 dakika). Maksimum değer, WSMan yapılandırmasındaki (WSMan:\\\<ComputerName\>\Shell\IdleTimeout ) Shell nesnelerinin IdleTimeout özelliğinin değeridir. Varsayılan değer 7200000 milisaniyedir (2 saat).

Oturum seçeneklerinde ve oturum yapılandırmasında boşta kalma zaman aşımı değeri ayarlanırsa, oturum seçeneklerinde ayarlanan değer önceliklidir, ancak oturum yapılandırmasının MaxIdleTimeoutMs özelliğinin değerini aşamaz. MaxIdleTimeoutMs özelliğinin değerini ayarlamak için MaxIdleTimeoutSec parametresini kullanın.

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

-MaxConcurrentCommandsPerSession

Her oturumda aynı anda çalışabilecek komut sayısını belirtilen değerle sınırlar. Varsayılan değer 1000'dir.

MaxConcurrentCommandsPerSession parametresi, bir oturum yapılandırmasının MaxConcurrentCommandsPerShell özelliğine karşılık gelir.

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

-MaxConcurrentUsers

Her oturumda aynı anda komut çalıştırabilen kullanıcı sayısını belirtilen değerle sınırlar. Varsayılan değer 5'tir.

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

-MaxIdleTimeoutSec

Her oturum için boşta kalma zaman aşımı kümesini belirtilen değerle sınırlar. Varsayılan değerdir [Int]::MaxValue (yaklaşık 25 gün).

Kullanıcı oturumun bağlantısını kesmeyi ve yeniden bağlanmayı amaçladığında boşta kalma zaman aşımı değeri önemli bir öneme sahip olur. Kullanıcı yalnızca oturum zaman aşımına uğradıysa yeniden bağlanabilir.

MaxIdleTimeoutSec parametresi, bir oturum yapılandırmasının MaxIdleTimeoutMs özelliğine karşılık gelir.

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

-MaxMemoryPerSessionMB

Her oturum tarafından kullanılan belleği belirtilen değerle sınırlar. Megabayt cinsinden bir değer girin. Varsayılan değer 1024 megabayttır (1 GB).

MaxMemoryPerSessionMB parametresi, oturum yapılandırmasının MaxMemoryPerShellMB özelliğine karşılık gelir.

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

-MaxProcessesPerSession

Her oturumda çalışan işlem sayısını belirtilen değerle sınırlar. Varsayılan değer 15'tir.

MaxProcessesPerSession parametresi, bir oturum yapılandırmasının MaxProcessesPerShell özelliğine karşılık gelir.

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

-MaxSessions

Oturum yapılandırmasını kullanan oturum sayısını sınırlar. Varsayılan değer 25’dir.

MaxSessions parametresi, oturum yapılandırmasının MaxShells özelliğine karşılık gelir.

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

-MaxSessionsPerUser

Oturum yapılandırmasını kullanan ve belirli bir kullanıcının kimlik bilgileriyle çalışan oturum sayısını belirtilen değerle sınırlar. Varsayılan değer 25’dir.

Bu değeri belirttiğinizde, birçok kullanıcının kullanıcı olarak çalıştırmanın kimlik bilgilerini kullanıyor olabileceğini göz önünde bulundurun.

MaxSessionsPerUser parametresi, oturum yapılandırmasının MaxShellsPerUser özelliğine karşılık gelir.

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

-OutputBufferingMode

Çıkış arabelleği dolduğunda, komut çıkışının bağlantısız oturumlarda nasıl yönetileceğini belirler. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • Block Çıkış arabelleği dolduğunda, arabellek temizlenene kadar yürütme askıya alınır.
  • Drop Çıkış arabelleği dolduğunda yürütme devam eder. Yeni çıkış kaydedildikçe en eski çıkış atılır.
  • None Çıkış arabelleği modu belirtilmedi.

Oturumların OutputBufferingMode özelliğinin varsayılan değeri Engelle'dir.

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

Her konak işlemi için zaman aşımını belirtilen değerle sınırlar. Varsayılan değer olan 0, işlem için zaman aşımı değeri olmadığı anlamına gelir.

Diğer oturum yapılandırmalarında işlem başına zaman aşımı değerleri vardır. Örneğin, Microsoft.PowerShell.Workflow oturum yapılandırması işlem başına 28800 saniye (8 saat) zaman aşımı değerine sahiptir.

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

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

WSManConfigurationOption

Notlar

  • Oturum yapılandırma nesnesinin özellikleri, oturum yapılandırması için ayarlanan seçeneklere ve bu seçeneklerin değerlerine göre değişir. Ayrıca, oturum yapılandırma dosyası kullanan oturum yapılandırmaları ek özelliklere sahiptir.