New-PSWorkflowExecutionOption

New-PSWorkflowExecutionOption cmdlet 创建一个对象，该对象包含用于工作流会话配置的高级选项，该配置是用于运行 Windows PowerShell 工作流工作流的会话配置。

可以使用 生成的 New-PSWorkflowExecutionOption 对象作为创建或更改会话配置的 cmdlet SessionTypeOption 参数的值，例如 Register-PSSessionConfiguration 和 Set-PSSessionConfiguration cmdlet。

New-PSWorkflowExecutionOption cmdlet 的每个参数都表示 cmdlet 返回的工作流会话配置选项对象的属性。 如果省略参数，该 cmdlet 会创建具有该属性默认值的对象。

New-PSWorkflowExecutionOption cmdlet 是 Windows PowerShell 工作流功能的一部分。

还可以向此命令添加工作流通用参数。 有关工作流通用参数的详细信息，请参阅 about_WorkflowCommonParameters。

此 cmdlet 在 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

此命令使用 New-PSWorkflowExecutionOption cmdlet 将 MaxSessionsPerWorkflow 值增加到 10，并将 MaxDisconnectedSessions 值减少到 200。

输出显示 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                    :

前两个命令创建新的会话配置对象并注册它。

第三个命令使用 Get-PSSessionConfiguration cmdlet 获取 ITWorkflows 会话配置和 Format-List 在列表中显示会话配置的所有属性。输出显示会话配置中的工作流选项。 具体而言，会话配置具有值为 10 的 MaxSessionsPerWorkflow 属性，以及值为 200 的 MaxDisconnectedSessions 属性。

None

不能通过管道将对象传递给此 cmdlet。

PSWorkflowExecutionOption

如果超出选项设置的最大值，则会话中创建另一个实例的命令将失败，除非在参数说明中指出。 例如，如果 MaxConnectedSessions 的值为 100。 创建与远程节点（目标计算机）的第 101 个会话的命令失败。

会话配置对象的属性因为会话配置设置的选项以及这些选项的值而有所不同。 此外，使用会话配置文件的会话配置具有其他属性。

具体而言，包含 PSWorkflowExecutionOptions 对象的会话配置的属性因工作流选项值而异。 例如，如果会话配置包含 PSWorkflowExecutionOptions 对象，该对象为 SessionThrottleLimit 属性设置非默认值，则会话配置具有 SessionThrottleLimit 属性。 否则，它不会。