New-PSWorkflowExecutionOption
Crea un oggetto che contiene le opzioni di configurazione della sessione per le sessioni del flusso di lavoro.
Sintassi
Default (Impostazione predefinita)
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>]
Descrizione
Il cmdlet New-PSWorkflowExecutionOption crea un oggetto che contiene opzioni avanzate per le configurazioni di sessione del flusso di lavoro, ovvero configurazioni di sessione progettate per eseguire flussi di lavoro flusso di lavoro di Windows PowerShell.
È possibile utilizzare l'oggetto PSWorkflowExecutionOption generato da New-PSWorkflowExecutionOption come valore del parametro SessionTypeOption dei cmdlet che creano o modificano una configurazione di sessione, ad esempio i cmdlet Register-PSSessionConfiguration e Set-PSSessionConfiguration.
Ogni parametro del cmdlet New-PSWorkflowExecutionOption rappresenta una proprietà dell'oggetto opzione di configurazione della sessione del flusso di lavoro restituito dal cmdlet. Se si omette un parametro, il cmdlet crea l'oggetto con un valore predefinito per la proprietà .
Il cmdlet New-PSWorkflowExecutionOption fa parte della funzionalità Flusso di lavoro di Windows PowerShell.
È anche possibile aggiungere parametri comuni del flusso di lavoro a questo comando. Per altre informazioni sui parametri comuni del flusso di lavoro, vedere about_WorkflowCommonParameters.
Questo cmdlet è stato introdotto in Windows PowerShell 3.0.
Esempio
Esempio 1: Creare un oggetto Opzioni flusso di lavoro
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
Questo comando usa il cmdlet
L'output mostra l'oggetto restituito dal cmdlet.
Esempio 2: Utilizzo di un oggetto Opzioni flusso di lavoro
# 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 :
I primi due comandi creano un nuovo oggetto di configurazione sessione e lo registra.
Il terzo comando usa il cmdlet Get-PSSessionConfiguration per ottenere la configurazione della sessione ITWorkflows e il Format-List per visualizzare tutte le proprietà della configurazione della sessione in un elenco. L'output mostra che le opzioni del flusso di lavoro nella configurazione della sessione. In particolare, la configurazione della sessione ha una proprietà MaxSessionsPerWorkflow con un valore pari a 10 e una proprietà MaxDisconnectedSessions con un valore pari a 200.
Parametri
-ActivityProcessIdleTimeoutSec
Determina per quanto tempo ogni processo host attività viene mantenuto dopo che il processo diventa inattiva. Alla scadenza dell'intervallo, il processo viene chiuso.
Immettere un valore in secondi. Il valore predefinito è 60.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 60 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AllowedActivity
Specifica le attività consentite per l'esecuzione nella sessione.
Immettere nomi di attività qualificati per lo spazio dei nomi, ad esempio Microsoft.PowerShell.HyperV.Activities.*.
Sono supportati caratteri jolly. Il valore predefinito, PSDefaultActivities, include le attività predefinite di Windows Workflow Foundation e le attività che rappresentano i cmdlet principali di Windows PowerShell.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | PSDefaultActivities |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-EnableValidation
Verifica che tutte le attività del flusso di lavoro nella sessione siano incluse nell'elenco delle attività consentite.
Il valore predefinito è True. Per disabilitare la convalida, usare il formato di comando seguente: -EnableValidation:$false.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | True |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MaxActivityProcesses
Specifica il numero massimo di processi che è possibile creare nella sessione per supportare le attività del flusso di lavoro. Il valore predefinito è 5.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 5 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MaxConnectedSessions
Specifica il numero massimo di sessioni remote in uno stato operativo. Questa quota viene applicata alle sessioni connesse a tutti i nodi remoti (computer di destinazione). Il valore predefinito è 100.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 100 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MaxDisconnectedSessions
Specifica il numero massimo di sessioni remote in uno stato disconnesso. Questa quota viene applicata alle sessioni connesse a tutti i nodi remoti (computer di destinazione). Il valore predefinito è 1000.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 1000 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MaxPersistenceStoreSizeGB
Specifica le dimensioni massime, in gigabyte, dell'archivio di persistenza allocato ai flussi di lavoro eseguiti nella sessione. Quando le dimensioni vengono superate, l'archivio di persistenza viene espanso per salvare tutti i dati persistenti, ma viene visualizzato un avviso e viene scritto un messaggio nel registro eventi del flusso di lavoro. Il valore predefinito è 10.
L'archivio di persistenza contiene dati per tutti i processi del flusso di lavoro. La possibilità di archiviare i dati consente ai processi di riprendere senza perdere lo stato.
Proprietà dei parametri
| Tipo: | Int64 |
| Valore predefinito: | 10 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MaxRunningWorkflows
Specifica il numero massimo di flussi di lavoro che possono essere eseguiti simultaneamente nella sessione. Il valore predefinito è 30.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 30 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MaxSessionsPerRemoteNode
Specifica il numero massimo di sessioni che possono essere connesse a ogni nodo remoto (computer di destinazione). Il valore predefinito è 5.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 5 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MaxSessionsPerWorkflow
Specifica il numero massimo di sessioni che è possibile creare per supportare ogni flusso di lavoro. Il valore predefinito è 5.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 5 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-OutOfProcessActivity
Determina quali attività consentite (specificate dal parametro AllowedActivities) eseguono out-of-process. Il valore predefinito è InlineScript.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | InlineScript |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PersistencePath
Specifica il percorso sul disco in cui vengono archiviati lo stato e i dati del flusso di lavoro. L'archiviazione dello stato e dei dati del flusso di lavoro consente la sospensione e la ripresa dei flussi di lavoro e il ripristino da interruzioni e errori di rete.
Il valore predefinito è $Env:LOCALAPPDATA\Microsoft\Windows\PowerShell\WF\PS.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PersistWithEncryption
Indica che il flusso di lavoro crittografa i dati nell'archivio di persistenza. È consigliabile usare questa funzionalità quando si archiviano i dati di persistenza in una condivisione di rete.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | $Env:LOCALAPPDATA\Microsoft\Windows\PowerShell\WF\PS |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RemoteNodeSessionIdleTimeoutSec
Specifica per quanto tempo viene mantenuta una sessione connessa a un nodo remoto (computer di destinazione) se è inattiva.
Immettere un valore in secondi. Il valore predefinito è 60.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 60 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SessionThrottleLimit
Specifica il numero di operazioni create per supportare tutti i flussi di lavoro avviati nella sessione. Il valore predefinito è 100.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 100 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WorkflowShutdownTimeoutMSec
Specifica per quanto tempo la sessione viene mantenuta dopo la sospensione forzata di tutti i flussi di lavoro nella sessione. Alla scadenza del timeout, Windows PowerShell chiude la sessione, anche se tutti i flussi di lavoro non sono ancora sospesi.
Immettere un valore in millisecondi. Il valore predefinito è 500.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | 500 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
None
Gli oggetti non possono essere inviati tramite pipe a questo cmdlet.
Output
PSWorkflowExecutionOption
Note
Quando viene superato il valore massimo impostato da un'opzione, il comando per creare un'altra istanza della sessione ha esito negativo, a meno che non sia indicato nella descrizione del parametro. Ad esempio, se il valore di MaxConnectedSessions è 100. Il comando per creare la sessione 101 in un nodo remoto (computer di destinazione) ha esito negativo.
Le proprietà di un oggetto di configurazione sessione variano in base alle opzioni impostate per la configurazione della sessione e ai valori di tali opzioni. Inoltre, le configurazioni di sessione che usano un file di configurazione di sessione hanno proprietà aggiuntive.
In particolare, le proprietà delle configurazioni di sessione che includono un PSWorkflowExecutionOptions oggetto variano in base ai valori delle opzioni del flusso di lavoro. Ad esempio, se la configurazione della sessione include un oggetto PSWorkflowExecutionOptions che imposta un valore non predefinito per la proprietà SessionThrottleLimit, la configurazione della sessione ha una proprietà SessionThrottleLimit. In caso contrario, non lo fa.
