Megosztás a következőn keresztül:

New-PSWorkflowExecutionOption

  • Referencia
Modul:
PSWorkflow

Létrehoz egy objektumot, amely munkamenet-konfigurációs beállításokat tartalmaz a munkafolyamat-munkamenetekhez.

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

A New-PSWorkflowExecutionOption parancsmag létrehoz egy objektumot, amely speciális beállításokat tartalmaz a munkafolyamat-munkamenet-konfigurációkhoz, azaz a Windows PowerShell-munkafolyamatok futtatására tervezett munkamenet-konfigurációkat.

Használhatja azt a PSWorkflowExecutionOption objektumot, amely New-PSWorkflowExecutionOption a munkamenet-konfigurációt létrehozó vagy módosító parancsmagok SessionTypeOption paraméterének értékeként jön létre, például a parancsmagokat és Set-PSSessionConfiguration a Register-PSSessionConfiguration parancsmagokat.

A parancsmag minden paramétere New-PSWorkflowExecutionOption annak a munkafolyamat-munkamenet-konfigurációs beállításobjektumnak a tulajdonságát jelöli, amelyet a parancsmag visszaad. Ha kihagy egy paramétert, a parancsmag létrehozza az objektumot a tulajdonság alapértelmezett értékével.

A New-PSWorkflowExecutionOption parancsmag a Windows PowerShell-munkafolyamat szolgáltatás része.

A parancshoz gyakran használt munkafolyamat-paramétereket is hozzáadhat. A munkafolyamat gyakori paramétereiről további információt a about_WorkflowCommonParameters talál.

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

Példák

1. példa: Munkafolyamat-beállításobjektum létrehozása

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

Ez a parancs a New-PSWorkflowExecutionOption parancsmaggal 10-re növeli a MaxSessionsPerWorkflow értékét, és 200-ra csökkenti a MaxDisconnectedSessions értékét.

A kimenet a parancsmag által visszaadott objektumot jeleníti meg.

2. példa: Munkafolyamat-beállítások objektum használata

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

Az első két parancs létrehoz egy új munkamenet-konfigurációs objektumot, és regisztrálja azt.

A harmadik parancs a Get-PSSessionConfiguration parancsmaggal lekéri az ITWorkflows munkamenetkonfigurációját, és megjeleníti a Format-List munkamenet-konfiguráció összes tulajdonságát egy listában. A kimenet azt mutatja, hogy a munkafolyamat beállításai a munkamenet-konfigurációban. A munkamenet-konfiguráció egy 10 értékű MaxSessionsPerWorkflow tulajdonsággal és egy 200 értékű MaxDisconnectedSessions tulajdonsággal rendelkezik.

Paraméterek

-ActivityProcessIdleTimeoutSec

Meghatározza, hogy az egyes tevékenységgazdafolyamatok mennyi ideig maradnak fenn a folyamat tétlenné válása után. Ha az időköz lejár, a folyamat bezárul.

Adjon meg egy értéket másodpercek alatt. Az alapértelmezett érték 60.

Típus:Int32
Position:Named
Alapértelmezett érték:60
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-AllowedActivity

Megadja azokat a tevékenységeket, amelyek a munkamenetben futtathatók.

Adja meg a névtér által minősített tevékenységneveket, például Microsoft.Powershell.HyperV.Activities.*. A helyettesítő karakterek támogatottak. Az alapértelmezett érték, a PSDefaultActivities tartalmazza a Windows Workflow Foundation beépített tevékenységeit és az alapvető Windows PowerShell-parancsmagokat képviselő tevékenységeket.

Típus:String[]
Position:Named
Alapértelmezett érték:PSDefaultActivities
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-EnableValidation

Ellenőrzi, hogy a munkamenet összes munkafolyamat-tevékenysége szerepel-e az engedélyezett tevékenységek listájában.

Az alapértelmezett érték Igaz. Az érvényesítés letiltásához használja a következő parancsformátumot: -EnableValidation:$false.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:True
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaxActivityProcesses

Meghatározza a munkafolyamat-tevékenységek támogatásához a munkamenetben létrehozható folyamatok maximális számát. Az alapértelmezett érték 5.

Típus:Int32
Position:Named
Alapértelmezett érték:5
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaxConnectedSessions

Meghatározza a működési állapotban lévő távoli munkamenetek maximális számát. Ez a kvóta az összes távoli csomóponthoz (célszámítógéphez) csatlakoztatott munkamenetekre lesz alkalmazva. Az alapértelmezett érték 100.

Típus:Int32
Position:Named
Alapértelmezett érték:100
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaxDisconnectedSessions

A leválasztott állapotban lévő távoli munkamenetek maximális számát adja meg. Ez a kvóta az összes távoli csomóponthoz (célszámítógéphez) csatlakoztatott munkamenetekre lesz alkalmazva. Az alapértelmezett érték 1000.

Típus:Int32
Position:Named
Alapértelmezett érték:1000
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaxPersistenceStoreSizeGB

Megadja a munkamenetben futó munkafolyamatok számára lefoglalt adatmegőrzési tár maximális méretét gigabájtban. Ha túllépi a méretet, az adatmegőrzési tár ki van bontva az összes tárolt adat mentéséhez, de megjelenik egy figyelmeztetés, és egy üzenet íródik a munkafolyamat eseménynaplójába. Az alapértelmezett érték 10.

Az adatmegőrzési tár az összes munkafolyamat-feladat adatait tartalmazza. Az adatok tárolásának lehetősége lehetővé teszi, hogy a feladatok állapotvesztés nélkül folytatódjanak.

Típus:Int64
Position:Named
Alapértelmezett érték:10
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaxRunningWorkflows

A munkamenetben egyidejűleg futtatható munkafolyamatok maximális számát adja meg. Az alapértelmezett érték 30.

Típus:Int32
Position:Named
Alapértelmezett érték:30
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaxSessionsPerRemoteNode

Meghatározza az egyes távoli csomópontokhoz (célszámítógépekhez) csatlakoztatható munkamenetek maximális számát. Az alapértelmezett érték 5.

Típus:Int32
Position:Named
Alapértelmezett érték:5
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaxSessionsPerWorkflow

Meghatározza az egyes munkafolyamatok támogatásához létrehozható munkamenetek maximális számát. Az alapértelmezett érték 5.

Típus:Int32
Position:Named
Alapértelmezett érték:5
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-OutOfProcessActivity

Meghatározza, hogy mely engedélyezett tevékenységek (az AllowedActivities paraméter által megadott) futnak ki a folyamatból. Az alapértelmezett érték az InlineScript.

Típus:String[]
Position:Named
Alapértelmezett érték:InlineScript
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-PersistencePath

A lemez azon helyét adja meg, ahol a munkafolyamat állapota és az adatok tárolódnak. A munkafolyamat állapotának és adatainak tárolása lehetővé teszi a munkafolyamatok felfüggesztését és folytatását, valamint a megszakítások és hálózati hibák utáni helyreállítást.

Az alapértelmezett érték $env:LocalAppData\Microsoft\Windows\PowerShell\WF\PS.

Típus:String
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-PersistWithEncryption

Azt jelzi, hogy a munkafolyamat titkosítja az adatokat az adatmegőrzési tárban. Érdemes lehet ezt a funkciót használni a hálózati megosztásban tárolt adatmegőrzési adatok tárolásához.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:$env:LocalAppData\Microsoft\Windows\PowerShell\WF\PS
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-RemoteNodeSessionIdleTimeoutSec

Megadja, hogy mennyi ideig tart fenn egy távoli csomóponthoz (célszámítógéphez) csatlakoztatott munkamenet, ha tétlen.

Adjon meg egy értéket másodpercek alatt. Az alapértelmezett érték 60.

Típus:Int32
Position:Named
Alapértelmezett érték:60
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SessionThrottleLimit

Megadja, hogy hány művelet jön létre a munkamenetben elindított összes munkafolyamat támogatásához. Az alapértelmezett érték 100.

Típus:Int32
Position:Named
Alapértelmezett érték:100
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WorkflowShutdownTimeoutMSec

Megadja, hogy mennyi ideig tart fenn a munkamenet, miután a munkamenet összes munkafolyamata kényszerítetten fel van függesztve. Az időtúllépés lejártakor a Windows PowerShell bezárja a munkamenetet, még akkor is, ha az összes munkafolyamat még nincs felfüggesztve.

Adjon meg egy értéket ezredmásodpercben. Az alapértelmezett érték: 500.

Típus:Int32
Position:Named
Alapértelmezett érték:500
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

PSWorkflowExecutionOption

Jegyzetek

Ha túllépi egy beállítás által beállított maximális értéket, a munkamenetben egy másik példány létrehozására vonatkozó parancs meghiúsul, kivéve, ha a paraméter leírása fel nem veszi. Ha például a MaxConnectedSessions értéke 100. A 101. munkamenet távoli csomópontra (célszámítógépre) történő létrehozására vonatkozó parancs meghiúsul.

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.

A PSWorkflowExecutionOptions objektumot tartalmazó munkamenet-konfigurációk tulajdonságai a munkafolyamat-beállítás értékeitől függően változnak. Ha például a munkamenet-konfiguráció tartalmaz egy PSWorkflowExecutionOptions objektumot, amely nem alapértelmezett értéket állít be a SessionThrottleLimit tulajdonsághoz, akkor a munkamenet-konfiguráció MunkamenetThrottleLimit tulajdonsággal rendelkezik . Ellenkező esetben nem.