New-PSTransportOption

Modül:: Microsoft.PowerShell.Core Module

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

Syntax

Default (Varsayılan)

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

Description

New-PSTransportOption cmdlet'i, oturum yapılandırmaları için aktarım seçeneklerini içeren bir nesne oluşturur. nesnesini, ve Register-PSSessionConfiguration cmdlet'leri gibi bir oturum yapılandırmasını oluşturan veya değiştiren cmdlet'lerin Set-PSSessionConfiguration parametresinin 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 veya uzak bağlantının alıcı tarafında ayarlanan oturum değerlerini temsil eder. Bağlantının istemci tarafı, ya da gönderici ucu, oturum oluşturulduğunda veya istemcinin oturumdan bağlantısı kesildiğinde ya da yeniden bağlandığında oturum ayar değerlerini belirleyebilir. 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ğerler içeren 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 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, New-PSTransportOption parametresiz ç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, New-PSTransportOption değişkenine kaydettiği bir aktarım seçenekleri nesnesi oluşturmak için $t cmdlet'ini kullanır. Komut, en fazla oturum sayısını 40'a yükseltmek için MaxSessions parametresini kullanır.

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

Üçüncü komut, Get-PSSessionConfiguration cmdlet'ini kullanarak ITTasks oturum yapılandırmalarını ve Format-List cmdlet'ini kullanarak oturum yapılandırma nesnesinin tüm özelliklerini bir listede görüntüler. Çıktı, 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, aktarım seçeneği nesnesi oluşturmak için New-PSTransportOption cmdlet'ini kullanır. Komut, nesnenin IdleTimeoutSec özellik değerini bir saat (3600 saniye) olarak ayarlamak için IdleTimeoutSec parametresini kullanır. komutu, aktarım nesnelerini $t değişkenine kaydeder.

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

Üçüncü komut, yerel bilgisayarda MyITTasks oturumunu oluşturmak için New-PSSession cmdlet'ini kullanır. komut, 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 New-PSSession parametresini 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, oturumun tüm özelliklerini listedeki Format-List değişkeninde görüntülemek için $s cmdlet'ini 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, kalp atış 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ğramadı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 Shell nesnelerinin IdleTimeout özelliğinin değeridir (WSMan:\\\<ComputerName\>\Shell\IdleTimeout). 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ği değerini aşamaz. MaxIdleTimeoutMs özelliğinin değerini ayarlamak için MaxIdleTimeoutSec parametresini kullanın.

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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, oturum yapılandırmasının MaxConcurrentCommandsPerShell özelliğine karşılık gelir.

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaxIdleTimeoutSec

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

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

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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, bir oturum yapılandırmasının MaxMemoryPerShellMB özelliğine karşılık gelir.

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaxSessions

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

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

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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'tir.

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.

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-OutputBufferingMode

Çıkış arabelleği dolduğunda, komut çıkışının bağlantısız oturumlarda nasıl yönetileceğini belirler. Bu parametre için kabul edilebilir değerler ş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ış silinir.
None Hiçbir çıkış arabelleği modu belirtilmedi.

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

Parametre özellikleri

Tür:	Nullable<T>[OutputBufferingMode]
Default value:	None
Kabul edilen değerler:	None, Drop, Block
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Aracılığıyla paylaş

New-PSTransportOption

Syntax

Default (Varsayılan)

Description

Örnekler

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

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

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

Parametreler

-IdleTimeoutSec

Parametre özellikleri

Parametre kümeleri

-MaxConcurrentCommandsPerSession

Parametre özellikleri

Parametre kümeleri

-MaxConcurrentUsers

Parametre özellikleri

Parametre kümeleri

-MaxIdleTimeoutSec

Parametre özellikleri

Parametre kümeleri

-MaxMemoryPerSessionMB

Parametre özellikleri

Parametre kümeleri

-MaxProcessesPerSession

Parametre özellikleri

Parametre kümeleri

-MaxSessions

Parametre özellikleri

Parametre kümeleri

-MaxSessionsPerUser

Parametre özellikleri

Parametre kümeleri

-OutputBufferingMode

Parametre özellikleri

Parametre kümeleri

-ProcessIdleTimeoutSec

Parametre özellikleri

Parametre kümeleri

CommonParameters

Girişler

None

Çıkışlar

WSManConfigurationOption

Notlar

İlişkili Bağlantılar

Geri Bildirim