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

El cmdlet New-PSWorkflowExecutionOption crea un objeto que contiene opciones avanzadas para configuraciones de sesión de flujo de trabajo, es decir, configuraciones de sesión diseñadas para ejecutar flujos de trabajo de flujo de trabajo de Windows PowerShell.

Puede usar el objeto PSWorkflowExecutionOption que New-PSWorkflowExecutionOption genera como el valor del parámetro SessionTypeOption de cmdlets que crean o cambian una configuración de sesión, como los cmdlets Register-PSSessionConfiguration y Set-PSSessionConfiguration.

Cada parámetro del cmdlet New-PSWorkflowExecutionOption representa una propiedad del objeto de opción de configuración de sesión de flujo de trabajo que devuelve el cmdlet. Si omite un parámetro, el cmdlet crea el objeto con un valor predeterminado para la propiedad .

El cmdlet New-PSWorkflowExecutionOption forma parte de la característica flujo de trabajo de Windows PowerShell.

También puede agregar parámetros comunes de flujo de trabajo a este comando. Para obtener más información sobre los parámetros comunes del flujo de trabajo, consulte about_WorkflowCommonParameters.

Este cmdlet se presenta en 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

Este comando usa el cmdlet para aumentar el valor de MaxSessionsPerWorkflow a 10 y reducir el valor de MaxDisconnectedSessions a 200.

La salida muestra el objeto que devuelve el cmdlet.

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

Los dos primeros comandos crean un nuevo objeto de configuración de sesión y lo registran.

El tercer comando usa el cmdlet Get-PSSessionConfiguration para obtener la configuración de sesión itWorkflows y el Format-List para mostrar todas las propiedades de la configuración de sesión en una lista. La salida muestra que las opciones de flujo de trabajo en la configuración de sesión. En concreto, la configuración de sesión tiene una propiedad MaxSessionsPerWork flow con un valor de 10 y una propiedad MaxDisconnectedSessions con un valor de 200.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

No se pueden canalizar objetos a este cmdlet.

Cuando se supera el valor máximo establecido por una opción, se produce un error en el comando para crear otra instancia en la sesión, a menos que se indique en la descripción del parámetro. Por ejemplo, si el valor de MaxConnectedSessions es 100. Se produce un error en el comando para crear la sesión 101st en un nodo remoto (equipo de destino).

Las propiedades de un objeto de configuración de sesión varían con las opciones establecidas para la configuración de sesión y los valores de esas opciones. Además, las configuraciones de sesión que usan un archivo de configuración de sesión tienen propiedades adicionales.

En concreto, las propiedades de las configuraciones de sesión que incluyen una PSWorkflowExecutionOptions objeto varían en función de los valores de opción de flujo de trabajo. Por ejemplo, si la configuración de sesión incluye un objeto PSWorkflowExecutionOptions que establece un valor no predeterminado para la propiedad sessionThrottleLimit , la configuración de sesión tiene una propiedad SessionThrottleLimit. De lo contrario, no lo hace.