New-PSWorkflowExecutionOption

Başvuru

Modül:: PSWorkflow

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

Syntax

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

Cmdlet, New-PSWorkflowExecutionOption windows PowerShell İş Akışı iş akışlarını çalıştırmak için 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 Set-PSSessionConfiguration cmdlet'leri gibi bir oturum yapılandırmasını oluşturan veya değiştiren cmdlet'lerin SessionTypeOption parametresinin değeri olarak Register-PSSessionConfiguration oluşturulan PSWorkflowExecutionOption nesnesini New-PSWorkflowExecutionOption kullanabilirsiniz.

Cmdlet'in New-PSWorkflowExecutionOption 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, 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ırNew-PSWorkflowExecutionOption.

Çı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, BTWorkflows oturum yapılandırmasını almak için cmdlet'ini Format-List ve oturum yapılandırmasının tüm özelliklerini bir listede görüntülemek için cmdlet'ini kullanırGet-PSSessionConfiguration. Çıktı, oturum yapılandırmasındaki iş akışı seçeneklerini gösterir. Özellikle, oturum yapılandırması 10 değerine sahip bir MaxSessionsPerWorkflow özelliğine ve 200 değerine sahip bir MaxDisconnectedSessions özelliğine sahiptir.

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.

Type:	Int32
Position:	Named
Default value:	60
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowedActivity

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

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

Type:	String[]
Position:	Named
Default value:	PSDefaultActivities
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	True
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	5
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	100
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	1000
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int64
Position:	Named
Default value:	10
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxRunningWorkflows

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

Type:	Int32
Position:	Named
Default value:	30
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxSessionsPerRemoteNode

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

Type:	Int32
Position:	Named
Default value:	5
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxSessionsPerWorkflow

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

Type:	Int32
Position:	Named
Default value:	5
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OutOfProcessActivity

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

Type:	String[]
Position:	Named
Default value:	InlineScript
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	$env:LocalAppData\Microsoft\Windows\PowerShell\WF\PS
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	60
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	100
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32
Position:	Named
Default value:	500
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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, Max Bağlan edSessions 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ında SessionThrottleLimitözelliği vardır. Aksi takdirde basamaklanmaz.

Aracılığıyla paylaş

New-PSWorkflowExecutionOption

Syntax

Description

Örnekler

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

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

Parametreler

-ActivityProcessIdleTimeoutSec

-AllowedActivity

-EnableValidation

-MaxActivityProcesses

-MaxConnectedSessions

-MaxDisconnectedSessions

-MaxPersistenceStoreSizeGB

-MaxRunningWorkflows

-MaxSessionsPerRemoteNode

-MaxSessionsPerWorkflow

-OutOfProcessActivity

-PersistencePath

-PersistWithEncryption

-RemoteNodeSessionIdleTimeoutSec

-SessionThrottleLimit

-WorkflowShutdownTimeoutMSec

Girişler

Çıkışlar

Notlar

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

New-PSWorkflowExecutionOption

Syntax

Description

Örnekler

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

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

Parametreler

-ActivityProcessIdleTimeoutSec

-AllowedActivity

-EnableValidation

-MaxActivityProcesses

-MaxConnectedSessions

-MaxDisconnectedSessions

-MaxPersistenceStoreSizeGB

-MaxRunningWorkflows

-MaxSessionsPerRemoteNode

-MaxSessionsPerWorkflow

-OutOfProcessActivity

-PersistencePath

-PersistWithEncryption

-RemoteNodeSessionIdleTimeoutSec

-SessionThrottleLimit

-WorkflowShutdownTimeoutMSec

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar