New-PSWorkflowExecutionOption

Modül:

PSWorkflow Module

İş akışı oturumları için oturum yapılandırma seçeneklerini içeren bir nesne oluşturur.

Syntax

Default (Varsayılan)

New-PSWorkflowExecutionOption
    [-PersistencePath <String>]
    [-MaxPersistenceStoreSizeGB <Int64>]
    [-PersistWithEncryption]
    [-MaxRunningWorkflows <Int32>]
    [-AllowedActivity <String[]>]
    [-OutOfProcessActivity <String[]>]
    [-EnableValidation]
    [-MaxDisconnectedSessions <Int32>]
    [-MaxConnectedSessions <Int32>]
    [-MaxSessionsPerWorkflow <Int32>]
    [-MaxSessionsPerRemoteNode <Int32>]
    [-MaxActivityProcesses <Int32>]
    [-ActivityProcessIdleTimeoutSec <Int32>]
    [-RemoteNodeSessionIdleTimeoutSec <Int32>]
    [-SessionThrottleLimit <Int32>]
    [-WorkflowShutdownTimeoutMSec <Int32>]
    [<CommonParameters>]

Description

New-PSWorkflowExecutionOption cmdlet'i, windows PowerShell İş Akışı iş akışlarını çalıştırmak üzere tasarlanmış oturum yapılandırmaları olan iş akışı oturum yapılandırmaları için gelişmiş seçenekler içeren bir nesne oluşturur.

ve New-PSWorkflowExecutionOption cmdlet'leri gibi bir oturum yapılandırmasını oluşturan veya değiştiren cmdlet'lerin SessionTypeOption parametresi olarak Register-PSSessionConfiguration tarafından oluşturulan Set-PSSessionConfiguration nesnesini kullanabilirsiniz.

New-PSWorkflowExecutionOption cmdlet'in her parametresi, cmdlet'in döndürdüğü iş akışı oturumu yapılandırma seçeneği nesnesinin bir özelliğini temsil eder. Bir parametreyi atlarsanız, cmdlet özelliği için varsayılan değere sahip nesnesini oluşturur.

New-PSWorkflowExecutionOption cmdlet'i Windows PowerShell İş Akışı özelliğinin bir parçasıdır.

Bu komuta iş akışı ortak parametreleri de ekleyebilirsiniz. İş akışı ortak parametreleri hakkında daha fazla bilgi için bkz. about_WorkflowCommonParameters.

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

Örnekler

Örnek 1: İş Akışı Seçenekleri Nesnesi Oluşturma

New-PSWorkflowExecutionOption -MaxSessionsPerWorkflow 10 -MaxDisconnectedSessions 200

SessionThrottleLimit                       : 100
PersistencePath                            : C:\Users\User01\AppData\Local\Microsoft\Windows\PowerShell\WF\PS
MaxPersistenceStoreSizeGB                  : 10
PersistWithEncryption                      : False
MaxRunningWorkflows                        : 30
AllowedActivity                            : {PSDefaultActivities}
OutOfProcessActivity                       : {InlineScript}
EnableValidation                           : True
MaxDisconnectedSessions                    : 200
MaxConnectedSessions                       : 100
MaxSessionsPerWorkflow                     : 10
MaxSessionsPerRemoteNode                   : 5
MaxActivityProcesses                       : 5
ActivityProcessIdleTimeoutSec              : 60
RemoteNodeSessionIdleTimeoutSec            : 60
WorkflowShutdownTimeoutMSec                : 500

Bu komut MaxSessionsPerWorkflow değerini 10'a yükseltmek ve MaxDisconnectedSessions değerini 200'e düşürmek için cmdlet'ini kullanır.

Çıktı, cmdlet'in döndürdüğü nesneyi gösterir.

Örnek 2: İş Akışı Seçenekleri Nesnesi Kullanma

# Create a Workflow Options object and save it in a variable
$wo = New-PSWorkflowExecutionOption -MaxSessionsPerWorkflow 10 -MaxDisconnectedSessions 200
# Create the ITWorkflow session configuration
Register-PSSessionConfiguration -Name ITWorkflows -SessionTypeOption $wo -Force

    WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin

Type            Keys                                Name
----            ----                                ----
Container       {Name=ITWorkflows}                  ITWorkflows

Get-PSSessionConfiguration ITWorkflows | Format-List -Property *

Architecture                  : 64
Filename                      : %windir%\system32\pwrshplugin.dll
ResourceUri                   : http://schemas.microsoft.com/powershell/ITWorkflows
MaxConcurrentCommandsPerShell : 1000
allowedactivity               : PSDefaultActivities
UseSharedProcess              : false
ProcessIdleTimeoutSec         : 0
xmlns                         : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
MaxConcurrentUsers            : 5
maxsessionsperworkflow        : 10
lang                          : en-US
sessionconfigurationdata      : <SessionConfigurationData>
                                    <Param Name='PrivateData'>
                                        <PrivateData>
                                            <ParamName='enablevalidation' Value='True'/>
                                            <Param Name='allowedactivity'Value='PSDefaultActivities' />
                                            <Param Name='outofprocessactivity' Value='InlineScript'/>
                                            <Param Name='maxdisconnectedsessions' Value='200' />
                                            <ParamName='maxsessionsperworkflow' Value='10'/>
                                        </PrivateData>
                                    </Param>
                                </SessionConfigurationData>
SupportsOptions               : true
ExactMatch                    : true
RunAsUser                     :
IdleTimeoutms                 : 7200000
PSVersion                     : 3.0
OutputBufferingMode           : Block
AutoRestart                   : false
MaxShells                     : 25
MaxMemoryPerShellMB           : 1024
MaxIdleTimeoutMs              : 43200000
outofprocessactivity          : InlineScript
SDKVersion                    : 2
Name                          : ITWorkflows
XmlRenderingType              : text
Capability                    : {Shell}
RunAsPassword                 :
MaxProcessesPerShell          : 15
enablevalidation              : True
Enabled                       : True
maxdisconnectedsessions       : 200
MaxShellsPerUser              : 25
Permission                    :

İlk iki komut yeni bir oturum yapılandırma nesnesi oluşturur ve bunu kaydeder.

Üçüncü komut, ITWorkflows oturum yapılandırmasını almak için Get-PSSessionConfiguration cmdlet'ini ve oturum yapılandırmasının tüm özelliklerini bir listede görüntülemek için Format-List kullanır. Çıktı, oturum yapılandırmasındaki iş akışı seçeneklerini gösterir. Özel olarak, oturum yapılandırmasında 10 değerine sahip MaxSessionsPerWorkflow özelliği ve 200 değerine sahip MaxDisconnectedSessions özelliği vardır.

Parametreler

-ActivityProcessIdleTimeoutSec

İşlem boşta kaldıktan sonra her etkinlik konağı işleminin ne kadar süreyle tutuldığını belirler. Aralığın süresi dolduğunda işlem kapanır.

Saniye olarak bir değer girin. Varsayılan değer 60'tır.

Parametre özellikleri

Tür:	Int32
Default value:	60
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-AllowedActivity

Oturumda çalışmasına izin verilen etkinlikleri belirtir.

Microsoft.PowerShell.HyperV.Activities.*gibi ad alanı nitelenmiş etkinlik adlarını girin. Joker karakterler desteklenir. PSDefaultActivities varsayılan değer, yerleşik Windows Workflow Foundation etkinliklerini ve temel Windows PowerShell cmdlet'lerini temsil eden etkinlikleri içerir.

Parametre özellikleri

Tür:	String[]
Default value:	PSDefaultActivities
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-EnableValidation

Oturumdaki tüm iş akışı etkinliklerinin izin verilen etkinlikler listesine dahil olduğunu doğrular.

Varsayılan değer True'dur. Doğrulamayı devre dışı bırakmak için şu komut biçimini kullanın: -EnableValidation:$false.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	True
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaxActivityProcesses

İş akışı etkinliklerini desteklemek için oturumda oluşturulabilecek işlem sayısı üst sınırını belirtir. Varsayılan değer 5'tir.

Parametre özellikleri

Tür:	Int32
Default value:	5
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaxConnectedSessions

İşletimsel durumdaki uzak oturum sayısı üst sınırını belirtir. Bu kota, tüm uzak düğümlere (hedef bilgisayarlar) bağlı oturumlara uygulanır. Varsayılan değer 100 şeklindedir.

Parametre özellikleri

Tür:	Int32
Default value:	100
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaxDisconnectedSessions

Bağlantısı kesilmiş durumda olan uzak oturum sayısı üst sınırını belirtir. Bu kota, tüm uzak düğümlere (hedef bilgisayarlar) bağlı oturumlara uygulanır. Varsayılan değer 1000'dir.

Parametre özellikleri

Tür:	Int32
Default value:	1000
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaxPersistenceStoreSizeGB

Oturumda çalışan iş akışlarına ayrılan kalıcılık deposunun gigabayt cinsinden en büyük boyutunu belirtir. Boyut aşıldığında kalıcılık deposu tüm kalıcı verileri kaydedecek şekilde genişletilir, ancak bir uyarı görüntülenir ve iş akışı olay günlüğüne bir ileti yazılır. Varsayılan değer 10'dur.

Kalıcılık deposu tüm iş akışı işlerinin verilerini içerir. Verileri depolama özelliği, işlerin durumu kaybetmeden sürdürülmesini sağlar.

Parametre özellikleri

Tür:	Int64
Default value:	10
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaxRunningWorkflows

Oturumda eşzamanlı olarak çalışabilecek iş akışı sayısı üst sınırını belirtir. Varsayılan değer 30'dur.

Parametre özellikleri

Tür:	Int32
Default value:	30
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaxSessionsPerRemoteNode

Her uzak düğüme (hedef bilgisayar) bağlanabilecek en fazla oturum sayısını belirtir. Varsayılan değer 5'tir.

Parametre özellikleri

Tür:	Int32
Default value:	5
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaxSessionsPerWorkflow

Her iş akışını desteklemek için oluşturulabilecek en fazla oturum sayısını belirtir. Varsayılan değer 5'tir.

Parametre özellikleri

Tür:	Int32
Default value:	5
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-OutOfProcessActivity

İzin verilen etkinliklerin (AllowedActivities parametresi tarafından belirtilen) işlem dışı olduğunu belirler. Varsayılan değer InlineScriptdeğeridir.

Parametre özellikleri

Tür:	String[]
Default value:	InlineScript
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-PersistencePath

Diskte iş akışı durumunun ve verilerin depolandığı konumu belirtir. İş akışı durumunu ve verilerini depolamak, iş akışlarının askıya alınmasına ve sürdürülmesine, kesintilerden ve ağ hatalarından kurtarılmasına olanak tanır.

Varsayılan değer şudur: $Env:LOCALAPPDATA\Microsoft\Windows\PowerShell\WF\PS.

Parametre özellikleri

Tür:	String
Default value:	False
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-PersistWithEncryption

İş akışının kalıcılık deposundaki verileri şifrelediğini gösterir. Kalıcılık verilerini bir ağ paylaşımında depolarken bu özelliği kullanmayı göz önünde bulundurun.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	$Env:LOCALAPPDATA\Microsoft\Windows\PowerShell\WF\PS
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RemoteNodeSessionIdleTimeoutSec

Uzak düğüme (hedef bilgisayar) bağlı bir oturumun boşta olması durumunda ne kadar süreyle tutulduğunu belirtir.

Saniye olarak bir değer girin. Varsayılan değer 60'tır.

Parametre özellikleri

Tür:	Int32
Default value:	60
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SessionThrottleLimit

Oturumda başlatılan tüm iş akışlarını desteklemek için kaç işlem oluşturulduğunu belirtir. Varsayılan değer 100 şeklindedir.

Parametre özellikleri

Tür:	Int32
Default value:	100
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WorkflowShutdownTimeoutMSec

Oturumdaki tüm iş akışları zorla askıya alındıktan sonra oturumun ne kadar süreyle tutulduğunu belirtir. Zaman aşımı süresi dolduğunda, tüm iş akışları henüz askıya alınmamış olsa bile Windows PowerShell oturumu kapatır.

Milisaniye cinsinden bir değer girin. Varsayılan değer 500'dür.

Parametre özellikleri

Tür:	Int32
Default value:	500
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:	False
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

PSWorkflowExecutionOption

Notlar

Bir seçenek tarafından ayarlanan maksimum değer aşıldığında, parametre açıklamasında belirtilmediği sürece oturumda başka bir örnek oluşturma komutu başarısız olur. Örneğin, MaxConnectedSessions değeri 100 ise. Uzak düğümde (hedef bilgisayar) 101. oturumu oluşturma komutu başarısız olur.

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.

Özellikle, PSWorkflowExecutionOptions nesnesi içeren oturum yapılandırmalarının özellikleri iş akışı seçeneği değerlerine göre değişir. Örneğin, oturum yapılandırması SessionThrottleLimit özelliği için varsayılan olmayan bir değer ayarlayan bir PSWorkflowExecutionOptions nesnesi içeriyorsa, oturum yapılandırmasının bir SessionThrottleLimit özelliği vardır. Aksi takdirde, yapmaz.

İlişkili Bağlantılar

• New-PSWorkflowSession
• İş Akışları Hakkında
• hakkında_İşAkışıOrtakParametreleri