New-PSWorkflowExecutionOption

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>]

Cmdleten New-PSWorkflowExecutionOption skapar ett objekt som innehåller avancerade alternativ för arbetsflödessessionskonfigurationer, dvs. sessionskonfigurationer som är utformade för att köra arbetsflöden för Windows PowerShell-arbetsflöden.

Du kan använda PSWorkflowExecutionOption objekt som New-PSWorkflowExecutionOption genererar som värdet för parametern SessionTypeOption för cmdletar som skapar eller ändrar en sessionskonfiguration, till exempel cmdletarna Register-PSSessionConfiguration och Set-PSSessionConfiguration.

Varje parameter i cmdleten New-PSWorkflowExecutionOption representerar en egenskap för konfigurationsalternativobjektet för arbetsflödessessionen som cmdleten returnerar. Om du utelämnar en parameter skapar cmdleten objektet med ett standardvärde för egenskapen.

Cmdleten New-PSWorkflowExecutionOption är en del av windows PowerShell-arbetsflödesfunktionen.

Du kan också lägga till vanliga parametrar för arbetsflödet i det här kommandot. Mer information om vanliga parametrar för arbetsflöden finns i about_WorkflowCommonParameters.

Den här cmdleten introduceras i Windows PowerShell 3.0.

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

Det här kommandot använder cmdleten New-PSWorkflowExecutionOption för att öka värdet MaxSessionsPerWorkflow till 10 och minska värdet MaxDisconnectedSessions till 200.

Utdata visar det objekt som cmdleten returnerar.

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

De två första kommandona skapar ett nytt sessionskonfigurationsobjekt och registrerar det.

Det tredje kommandot använder cmdleten Get-PSSessionConfiguration för att hämta konfigurationen av ITWorkflows-sessionen och Format-List för att visa alla egenskaper för sessionskonfigurationen i en lista. Utdata visar att arbetsflödesalternativen i sessionskonfigurationen. Mer specifikt har sessionskonfigurationen en MaxSessionsPerWorkflow-egenskap med värdet 10 och en MaxDisconnectedSessions-egenskap med värdet 200.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan inte skicka objekt till den här cmdleten.

När det högsta värdet som anges av ett alternativ överskrids misslyckas kommandot för att skapa en annan instans i sessionen, om det inte anges i parameterbeskrivningen. Om till exempel värdet för MaxConnectedSessions är 100. Kommandot för att skapa den 101:a sessionen till en fjärrnod (måldator) misslyckas.

Egenskaperna för ett sessionskonfigurationsobjekt varierar med de alternativ som angetts för sessionskonfigurationen och värdena för dessa alternativ. Sessionskonfigurationer som använder en sessionskonfigurationsfil har dessutom ytterligare egenskaper.

I synnerhet varierar egenskaperna för sessionskonfigurationer som innehåller ett PSWorkflowExecutionOptions-objekt baserat på arbetsflödesalternativvärdena. Om sessionskonfigurationen till exempel innehåller ett PSWorkflowExecutionOptions objekt som anger ett icke-standardvärde för egenskapen SessionThrottleLimit, har sessionskonfigurationen en egenskap SessionThrottleLimit. Annars gör det inte det.