New-PSWorkflowExecutionOption
Létrehoz egy objektumot, amely munkamenet-konfigurációs beállításokat tartalmaz a munkafolyamat-munkamenetekhez.
Syntax
Default (Alapértelmezett)
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 az PSWorkflowExecutionOption objektumot, amelyet New-PSWorkflowExecutionOption generál a munkamenet-konfigurációt létrehozó vagy módosító parancsmagok SessionTypeOption paraméterének értékeként, például a Register-PSSessionConfiguration és Set-PSSessionConfiguration parancsmagok értékeként.
A New-PSWorkflowExecutionOption parancsmag minden paramétere 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_WorkflowCommonParameterscímű témakörben 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 növeli a MaxSessionsPerWorkflow értékét 10-re, és csökkenti a MaxDisconnectedSessions értékét 200-ra.
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 : https://schemas.microsoft.com/powershell/ITWorkflows
MaxConcurrentCommandsPerShell : 1000
allowedactivity : PSDefaultActivities
UseSharedProcess : false
ProcessIdleTimeoutSec : 0
xmlns : https://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 parancsmagot használja az ITWorkflows munkamenet-konfigurációjának lekéréséhez, a Format-List pedig a munkamenet-konfiguráció összes tulajdonságának megjelenítéséhez egy listában. A kimenet azt mutatja, hogy a munkafolyamat beállításai a munkamenet-konfigurációban. A munkamenet-konfiguráció egy MaxSessionsPerWorkflow tulajdonsággal rendelkezik 10 értékkel, és egy MaxDisconnectedSessions tulajdonsággal, amelynek értéke 200.
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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 60 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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, PSDefaultActivities, tartalmazza a Windows Workflow Foundation beépített tevékenységeit és a Windows PowerShell Core-parancsmagokat képviselő tevékenységeket.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | PSDefaultActivities |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | True |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 5 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 100 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 1000 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | Int64 |
| Alapértelmezett érték: | 10 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-MaxRunningWorkflows
A munkamenetben egyidejűleg futtatható munkafolyamatok maximális számát adja meg. Az alapértelmezett érték 30.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 30 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 5 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 5 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-OutOfProcessActivity
Meghatározza, hogy mely engedélyezett tevékenységek (a AllowedActivities paraméter által meghatározott) futnak ki a folyamatból. Az alapértelmezett érték InlineScript.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | InlineScript |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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 a $env:LocalAppData\Microsoft\Windows\PowerShell\WF\PS.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | $env:LocalAppData\Microsoft\Windows\PowerShell\WF\PS |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 60 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 100 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 500 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Ehhez a parancsmaghoz nem csövezhet be bemenetet.
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.
Az 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, a munkamenet-konfiguráció SessionThrottleLimit tulajdonsággal rendelkezik. Ellenkező esetben nem.