New-PSWorkflowExecutionOption

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 워크플로 워크플로를 실행하도록 설계된 세션 구성입니다.

및 cmdlet과 같은 세션 구성을 만들거나 변경하는 cmdlet의 SessionTypeOption 매개 변수 값으로 생성하는 PSWorkflowExecutionOption 개체 New-PSWorkflowExecutionOption 를 Register-PSSessionConfigurationSet-PSSessionConfiguration 사용할 수 있습니다.

cmdlet의 New-PSWorkflowExecutionOption 각 매개 변수는 cmdlet이 반환하는 워크플로 세션 구성 옵션 개체의 속성을 나타냅니다. 매개 변수를 생략하면 이 cmdlet은 속성의 기본값으로 개체를 만듭니다.

cmdlet은 New-PSWorkflowExecutionOption Windows PowerShell 워크플로 기능의 일부입니다.

또한 이 명령에 워크플로 일반 매개 변수를 추가할 수 있습니다. 워크플로 공통 매개 변수에 대한 자세한 내용은 about_WorkflowCommonParameters.

이 cmdlet은 Windows PowerShell 3.0에서 도입되었습니다.

예제

예제 1: 워크플로 옵션 개체 Create

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

이 명령은 cmdlet을 New-PSWorkflowExecutionOption 사용하여 MaxSessionsPerWorkflow 값을 10으로 늘리고 MaxDisconnectedSessions 값을 200으로 줄입니다.

출력은 이 cmdlet에서 반환하는 개체를 보여 줍니다.

예제 2: 워크플로 옵션 개체 사용

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

처음 두 명령은 새 세션 구성 개체를 만들고 등록합니다.

세 번째 명령은 cmdlet을 사용하여 ITWorkflows 세션 구성 가져오기 및 Format-List 를 사용하여 Get-PSSessionConfiguration 세션 구성의 모든 속성을 목록에 표시합니다. 출력은 세션 구성의 워크플로 옵션을 보여 줍니다. 특히, 세션 구성에는 MaxSessionsPerWorkflow 속성의 값이 10으로 설정되어 있고 MaxDisconnectedSessions 속성의 값이 200으로 설정되어 있습니다.

매개 변수

-ActivityProcessIdleTimeoutSec

-AllowedActivity

-EnableValidation

-MaxActivityProcesses

-MaxConnectedSessions

-MaxDisconnectedSessions

-MaxPersistenceStoreSizeGB

-MaxRunningWorkflows

-MaxSessionsPerRemoteNode

-MaxSessionsPerWorkflow

-OutOfProcessActivity

-PersistencePath

-PersistWithEncryption

-RemoteNodeSessionIdleTimeoutSec

-SessionThrottleLimit

-WorkflowShutdownTimeoutMSec

입력

None

이 cmdlet에 입력을 파이프할 수 없습니다.

출력

PSWorkflowExecutionOption

참고

옵션으로 설정된 최대값을 초과하면 매개 변수 설명에 다른 설명이 없는 한 세션에 다른 인스턴스를 만드는 명령은 실패합니다. 예를 들어 MaxConnectedSessions 값이 100이라고 가정합니다. 그러면 원격 노드(대상 컴퓨터)에 대한 101번째 세션을 만드는 명령은 실패합니다.

세션 구성 개체의 속성은 세션 구성에 대해 설정된 옵션과 해당 옵션 값에 따라 달라집니다. 또한 세션 구성 파일을 사용하는 세션 구성에는 추가 속성이 있습니다.

특히, PSWorkflowExecutionOptions 개체가 포함된 세션 구성의 속성은 워크플로 옵션 값에 따라 달라집니다. 예를 들어 세션 구성에 SessionThrottleLimit 속성에 대해 기본값이 아닌 값을 설정하는 PSWorkflowExecutionOptions 개체가 포함된 경우 세션 구성에 SessionThrottleLimit 속성이 포함됩니다. 그러지 않으면 이러한 속성을 포함하지 않습니다.

관련 링크

• New-PSWorkflowSession
• about_Workflows
• about_WorkflowCommonParameters