New-PSWorkflowExecutionOption

Referensi

Modul:: PSWorkflow

Membuat objek yang berisi opsi konfigurasi sesi untuk sesi alur kerja.

Sintaks

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

Deskripsi

New-PSWorkflowExecutionOption Cmdlet membuat objek yang berisi opsi tingkat lanjut untuk konfigurasi sesi alur kerja, yaitu konfigurasi sesi yang dirancang untuk menjalankan alur kerja Windows PowerShell Workflow.

Anda dapat menggunakan objek PSWorkflowExecutionOption yang New-PSWorkflowExecutionOption dihasilkan sebagai nilai parameter SessionTypeOption cmdlet yang membuat atau mengubah konfigurasi sesi, seperti Register-PSSessionConfiguration cmdlet dan Set-PSSessionConfiguration .

Setiap parameter New-PSWorkflowExecutionOption cmdlet mewakili properti objek opsi konfigurasi sesi alur kerja yang dikembalikan cmdlet. Jika Anda menghilangkan parameter, cmdlet membuat objek dengan nilai default untuk properti .

New-PSWorkflowExecutionOption Cmdlet adalah bagian dari fitur Windows PowerShell Workflow.

Anda juga dapat menambahkan parameter umum alur kerja ke perintah ini. Untuk informasi selengkapnya tentang parameter umum alur kerja, lihat about_WorkflowCommonParameters.

Cmdlet ini diperkenalkan di Windows PowerShell 3.0.

Contoh

Contoh 1: Membuat Objek Opsi Alur Kerja

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

Perintah ini menggunakan New-PSWorkflowExecutionOption cmdlet untuk meningkatkan nilai MaxSessionsPerWorkflow menjadi 10 dan mengurangi nilai MaxDisconnectedSessions menjadi 200.

Output menunjukkan objek yang dikembalikan cmdlet.

Contoh 2: Menggunakan Objek Opsi Alur Kerja

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

Dua perintah pertama membuat objek konfigurasi sesi baru dan mendaftarkannya.

Perintah ketiga menggunakan Get-PSSessionConfiguration cmdlet untuk mendapatkan konfigurasi sesi ITWorkflows dan Format-List untuk menampilkan semua properti konfigurasi sesi dalam daftar. Output menunjukkan bahwa opsi alur kerja dalam konfigurasi sesi. Secara khusus, konfigurasi sesi memiliki properti MaxSessionsPerWorkflow dengan nilai 10 dan properti MaxDisconnectedSessions dengan nilai 200.

Parameter

-ActivityProcessIdleTimeoutSec

Menentukan berapa lama setiap proses host aktivitas dipertahankan setelah proses menjadi menganggur. Ketika interval kedaluwarsa, proses ditutup.

Masukkan nilai dalam detik. Nilai defaultnya adalah 60.

Type:	Int32
Position:	Named
Default value:	60
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowedActivity

Menentukan aktivitas yang diizinkan untuk dijalankan dalam sesi.

Masukkan nama aktivitas yang memenuhi syarat namespace, seperti Microsoft.Powershell.HyperV.Activities.*. Karakter kartubebas didukung. Nilai default, PSDefaultActivities, mencakup aktivitas Windows Workflow Foundation bawaan dan aktivitas yang mewakili cmdlet Windows PowerShell inti.

Type:	String[]
Position:	Named
Default value:	PSDefaultActivities
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableValidation

Memverifikasi bahwa semua aktivitas alur kerja dalam sesi disertakan dalam daftar aktivitas yang diizinkan.

Nilai default-nya adalah True. Untuk menonaktifkan validasi, gunakan format perintah berikut: -EnableValidation:$false.

Type:	SwitchParameter
Position:	Named
Default value:	True
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxActivityProcesses

Menentukan jumlah maksimum proses yang dapat dibuat dalam sesi untuk mendukung aktivitas alur kerja. Nilai defaultnya adalah 5.

Type:	Int32
Position:	Named
Default value:	5
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxConnectedSessions

Menentukan jumlah maksimum sesi jarak jauh yang berada dalam status operasional. Kuota ini diterapkan ke sesi yang terhubung ke semua simpul jarak jauh (komputer target). Nilai default adalah 100.

Type:	Int32
Position:	Named
Default value:	100
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxDisconnectedSessions

Menentukan jumlah maksimum sesi jarak jauh yang dalam keadaan terputus. Kuota ini diterapkan ke sesi yang terhubung ke semua simpul jarak jauh (komputer target). Nilai defaultnya adalah 1000.

Type:	Int32
Position:	Named
Default value:	1000
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxPersistenceStoreSizeGB

Menentukan ukuran maksimum, dalam gigabyte, dari penyimpanan persistensi yang dialokasikan untuk alur kerja yang berjalan dalam sesi. Ketika ukuran terlampaui, penyimpanan persistensi diperluas untuk menyimpan semua data yang bertahan, tetapi peringatan ditampilkan dan pesan ditulis ke log peristiwa alur kerja. Nilai defaultnya adalah 10.

Penyimpanan persistensi berisi data untuk semua pekerjaan alur kerja. Kemampuan untuk menyimpan data memungkinkan pekerjaan dilanjutkan tanpa kehilangan status.

Type:	Int64
Position:	Named
Default value:	10
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxRunningWorkflows

Menentukan bahwa jumlah maksimum alur kerja yang dapat berjalan dalam sesi secara bersamaan. Nilai default adalah 30.

Type:	Int32
Position:	Named
Default value:	30
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxSessionsPerRemoteNode

Menentukan jumlah maksimum sesi yang dapat disambungkan ke setiap simpul jarak jauh (komputer target). Nilai defaultnya adalah 5.

Type:	Int32
Position:	Named
Default value:	5
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxSessionsPerWorkflow

Menentukan jumlah maksimum sesi yang dapat dibuat untuk mendukung setiap alur kerja. Nilai defaultnya adalah 5.

Type:	Int32
Position:	Named
Default value:	5
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OutOfProcessActivity

Menentukan aktivitas mana yang diizinkan (ditentukan oleh parameter Aktivitas yang Diizinkan) berjalan di luar proses. Nilai defaultnya adalah InlineScript.

Type:	String[]
Position:	Named
Default value:	InlineScript
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PersistencePath

Menentukan lokasi pada disk tempat status alur kerja dan data disimpan. Menyimpan status alur kerja dan data memungkinkan alur kerja ditangguhkan dan dilanjutkan, dan untuk pulih dari gangguan dan kegagalan jaringan.

Nilai defaultnya adalah $env:LocalAppData\Microsoft\Windows\PowerShell\WF\PS.

Type:	String
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PersistWithEncryption

Menunjukkan bahwa alur kerja mengenkripsi data di penyimpanan persistensi. Pertimbangkan untuk menggunakan fitur ini saat menyimpan data persistensi dalam berbagi jaringan.

Type:	SwitchParameter
Position:	Named
Default value:	$env:LocalAppData\Microsoft\Windows\PowerShell\WF\PS
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoteNodeSessionIdleTimeoutSec

Menentukan berapa lama sesi yang tersambung ke simpul jarak jauh (komputer target) dipertahankan jika diam.

Masukkan nilai dalam detik. Nilai defaultnya adalah 60.

Type:	Int32
Position:	Named
Default value:	60
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SessionThrottleLimit

Menentukan berapa banyak operasi yang dibuat untuk mendukung semua alur kerja yang dimulai dalam sesi. Nilai default adalah 100.

Type:	Int32
Position:	Named
Default value:	100
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkflowShutdownTimeoutMSec

Menentukan berapa lama sesi dipertahankan setelah semua alur kerja dalam sesi ditangguhkan secara paksa. Ketika batas waktu berakhir, Windows PowerShell menutup sesi, bahkan jika semua alur kerja belum ditangguhkan.

Masukkan nilai dalam milidetik. Nilai default adalah 500.

Type:	Int32
Position:	Named
Default value:	500
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

PSWorkflowExecutionOption

Catatan

Ketika nilai maksimum yang ditetapkan oleh opsi terlampaui, perintah untuk membuat instans lain dalam sesi gagal, kecuali disebutkan dalam deskripsi parameter. Misalnya, jika nilai Max Koneksi edSessions adalah 100. Perintah untuk membuat sesi ke-101 ke simpul jarak jauh (komputer target) gagal.

Properti objek konfigurasi sesi bervariasi menurut opsi yang diatur untuk konfigurasi sesi dan nilai opsi tersebut. Selain itu, konfigurasi sesi yang menggunakan file konfigurasi sesi memiliki properti tambahan.

Secara khusus, properti konfigurasi sesi yang menyertakan objek PSWorkflowExecutionOptions bervariasi berdasarkan nilai opsi alur kerja. Misalnya, jika konfigurasi sesi menyertakan objek PSWorkflowExecutionOptions yang menetapkan nilai non-default untuk properti SessionThrottleLimit, konfigurasi sesi memiliki properti SessionThrottleLimit. Jika tidak, itu tidak.

Bagikan melalui

New-PSWorkflowExecutionOption

Sintaks

Deskripsi

Contoh

Contoh 1: Membuat Objek Opsi Alur Kerja

Contoh 2: Menggunakan Objek Opsi Alur Kerja

Parameter

-ActivityProcessIdleTimeoutSec

-AllowedActivity

-EnableValidation

-MaxActivityProcesses

-MaxConnectedSessions

-MaxDisconnectedSessions

-MaxPersistenceStoreSizeGB

-MaxRunningWorkflows

-MaxSessionsPerRemoteNode

-MaxSessionsPerWorkflow

-OutOfProcessActivity

-PersistencePath

-PersistWithEncryption

-RemoteNodeSessionIdleTimeoutSec

-SessionThrottleLimit

-WorkflowShutdownTimeoutMSec

Input

Output

Catatan

Saran dan Komentar

Sumber Daya Tambahan:

Bagikan melalui

New-PSWorkflowExecutionOption

Sintaks

Deskripsi

Contoh

Contoh 1: Membuat Objek Opsi Alur Kerja

Contoh 2: Menggunakan Objek Opsi Alur Kerja

Parameter

-ActivityProcessIdleTimeoutSec

-AllowedActivity

-EnableValidation

-MaxActivityProcesses

-MaxConnectedSessions

-MaxDisconnectedSessions

-MaxPersistenceStoreSizeGB

-MaxRunningWorkflows

-MaxSessionsPerRemoteNode

-MaxSessionsPerWorkflow

-OutOfProcessActivity

-PersistencePath

-PersistWithEncryption

-RemoteNodeSessionIdleTimeoutSec

-SessionThrottleLimit

-WorkflowShutdownTimeoutMSec

Input

Output

Catatan

Link Terkait

Saran dan Komentar

Sumber Daya Tambahan: