Resume-Job

Modul:: Microsoft.PowerShell.Core Module

Memulai ulang pekerjaan yang ditangguhkan.

Sintaks

SessionIdParameterSet (Default)

Resume-Job
    [-Id] <Int32[]>
    [-Wait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

JobParameterSet

Resume-Job
    [-Job] <Job[]>
    [-Wait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameParameterSet

Resume-Job
    [-Name] <String[]>
    [-Wait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InstanceIdParameterSet

Resume-Job
    [-InstanceId] <Guid[]>
    [-Wait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

StateParameterSet

Resume-Job
    [-State] <JobState>
    [-Wait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FilterParameterSet

Resume-Job
    [-Filter] <Hashtable>
    [-Wait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Cmdlet Resume-Job melanjutkan pekerjaan alur kerja yang ditangguhkan, seperti dengan menggunakan cmdlet Suspend-Job atau aktivitas Alur Kerja about_Suspend. Saat pekerjaan alur kerja dilanjutkan, mesin pekerjaan membangun kembali status, metadata, dan output dari sumber daya yang disimpan, seperti titik pemeriksaan. Pekerjaan dimulai ulang tanpa kehilangan status atau data. Status pekerjaan diubah dari Ditangguhkan menjadi Menjalankan.

Gunakan parameter Resume-Job untuk memilih pekerjaan berdasarkan nama, ID, ID instans, atau menyalurkan objek pekerjaan, seperti yang dikembalikan oleh cmdlet Get-Job, untuk Resume-Job. Anda juga dapat menggunakan filter properti untuk memilih pekerjaan yang akan dilanjutkan.

Secara default, Resume-Job segera kembali, meskipun semua pekerjaan mungkin belum dilanjutkan. Untuk menekan prompt perintah hingga semua pekerjaan yang ditentukan dilanjutkan, gunakan parameter Tunggu.

Cmdlet Resume-Job hanya berfungsi pada jenis pekerjaan kustom, seperti pekerjaan alur kerja. Ini tidak berfungsi pada pekerjaan latar belakang standar, seperti yang dimulai dengan menggunakan cmdlet Start-Job. Jika Anda mengirimkan pekerjaan dengan jenis yang tidak didukung, Resume-Job menghasilkan kesalahan penghentian dan berhenti berjalan.

Untuk mengidentifikasi pekerjaan alur kerja, cari nilai PSWorkflowJob di properti PSJobTypeName pekerjaan. Untuk menentukan apakah jenis pekerjaan kustom tertentu mendukung cmdlet Resume-Job, lihat topik bantuan untuk jenis pekerjaan kustom.

Sebelum menggunakan cmdlet Pekerjaan pada jenis pekerjaan kustom, impor modul yang mendukung jenis pekerjaan kustom, baik dengan menggunakan cmdlet Import-Module atau mendapatkan atau menggunakan cmdlet dalam modul.

Cmdlet ini diperkenalkan di Windows PowerShell 3.0.

Contoh

Contoh 1: Melanjutkan pekerjaan berdasarkan ID

Perintah dalam contoh ini memverifikasi bahwa pekerjaan adalah pekerjaan alur kerja yang ditangguhkan lalu melanjutkan pekerjaan. Perintah pertama menggunakan cmdlet Get-Job untuk mendapatkan pekerjaan. Output menunjukkan bahwa pekerjaan adalah pekerjaan alur kerja yang ditangguhkan. Perintah kedua menggunakan parameter Id cmdlet Resume-Job untuk melanjutkan pekerjaan dengan nilai Id 4.

PS C:\> Get-Job EventJob
Id     Name            PSJobTypeName   State         HasMoreData     Location   Command
--     ----            -------------   -----         -----------     --------   -------
4      EventJob        PSWorkflowJob   Suspended     True            Server01   \\Script\Share\Event.ps1

PS C:\> Resume-Job -Id 4

Contoh 2: Melanjutkan pekerjaan berdasarkan nama

Perintah ini menggunakan parameter Nama untuk melanjutkan beberapa pekerjaan alur kerja di komputer lokal.

PS C:\> Resume-Job -Name WorkflowJob, InventoryWorkflow, WFTest*

Contoh 3: Menggunakan nilai properti kustom

Perintah ini menggunakan nilai properti kustom untuk mengidentifikasi pekerjaan alur kerja yang akan dilanjutkan. Ini menggunakan parameter Filter untuk mengidentifikasi pekerjaan alur kerja dengan properti customID . Ini juga menggunakan parameter Status untuk memverifikasi bahwa pekerjaan alur kerja ditangguhkan, sebelum mencoba melanjutkannya.

PS C:\> Resume-Job -Filter @{CustomID="T091291"} -State Suspended

Contoh 4: Melanjutkan semua pekerjaan yang ditangguhkan di komputer jarak jauh

Perintah ini melanjutkan semua pekerjaan yang ditangguhkan pada komputer jarak jauh Srv01.

PS C:\> Invoke-Command -ComputerName Srv01 -ScriptBlock {Get-Job -State Suspended | Resume-Job}

Perintah menggunakan cmdlet Invoke-Command untuk menjalankan perintah pada komputer Srv01. Perintah jarak jauh menggunakan parameter Status cmdlet Get-Job untuk mendapatkan semua pekerjaan yang ditangguhkan di komputer. Operator alur (|) mengirim pekerjaan yang ditangguhkan ke cmdlet Resume-Job, yang melanjutkannya.

Contoh 5: Tunggu pekerjaan dilanjutkan

Perintah ini menggunakan parameter Tunggu untuk mengarahkan Resume-Job kembali hanya setelah semua pekerjaan yang ditentukan dilanjutkan. Parameter Wait sangat berguna dalam skrip yang mengasumsikan bahwa pekerjaan dilanjutkan sebelum skrip berlanjut.

PS C:\> Resume-Job -Name WorkflowJob, InventoryWorkflow, WFTest* -Wait

Contoh 6: Melanjutkan alur kerja yang menangguhkan dirinya sendiri

Sampel kode ini memperlihatkan aktivitas Suspend-Workflow dalam alur kerja.

Alur kerja Test-Suspend di komputer Server01. Saat Anda menjalankan alur kerja, alur kerja menjalankan aktivitas Get-Date dan menyimpan hasilnya dalam variabel $a. Kemudian menjalankan aktivitas Suspend-Workflow. Sebagai respons, dibutuhkan titik pemeriksaan, menangguhkan alur kerja, dan mengembalikan objek pekerjaan alur kerja. Suspend-Workflow mengembalikan objek pekerjaan alur kerja meskipun alur kerja tidak dijalankan secara eksplisit sebagai pekerjaan.

Resume-Job melanjutkan alur kerja Test-Suspend di Job8. Ini menggunakan parameter Tunggu untuk menahan prompt perintah hingga pekerjaan dilanjutkan.

Cmdlet Receive-Job mendapatkan hasil alur kerja Test-Suspend. Perintah akhir dalam alur kerja mengembalikan objek TimeSpan yang mewakili waktu yang berlalu antara tanggal dan waktu saat ini dan tanggal dan waktu yang disimpan dalam variabel $a sebelum alur kerja ditangguhkan.

#SampleWorkflow
workflow Test-Suspend
{
    $a = Get-Date
    Suspend-Workflow
    (Get-Date)- $a
}

PS C:\> Test-Suspend -PSComputerName Server01
Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
8      Job8            PSWorkflowJob   Suspended     True            Server01             Test-Suspend

PS C:\> Resume-Job -Name "Job8" -Wait
Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
8      Job8            PSWorkflowJob   Running       True            Server01             Test-Suspend

PS C:\> Receive-Job -Name Job8
        Days              : 0
        Hours             : 0
        Minutes           : 0
        Seconds           : 19
        Milliseconds      : 823
        Ticks             : 198230041
        TotalDays         : 0.000229432917824074
        TotalHours        : 0.00550639002777778
        TotalMinutes      : 0.330383401666667
        TotalSeconds      : 19.8230041
        TotalMilliseconds : 19823.0041
        PSComputerName    : Server01

Cmdlet Resume-Job memungkinkan Anda melanjutkan pekerjaan alur kerja yang ditangguhkan dengan menggunakan aktivitas Suspend-Workflow. Aktivitas ini menangguhkan alur kerja dari dalam alur kerja. Ini hanya valid dalam alur kerja.

Untuk informasi tentang Suspend-Workflow, lihat alur kerja about_Suspend](.. . /PSWorkflow/about/about_Suspend-Workflow.md).

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Filter

Menentukan tabel hash dari kondisi. Cmdlet ini melanjutkan pekerjaan yang memenuhi semua kondisi dalam tabel hash. Masukkan tabel hash di mana kunci adalah properti pekerjaan dan nilainya adalah nilai properti pekerjaan.

Properti parameter

Jenis:	Hashtable
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

FilterParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Id

Menentukan array ID untuk pekerjaan yang dilanjutkan cmdlet ini.

ID adalah bilangan bulat yang secara unik mengidentifikasi pekerjaan dalam sesi saat ini. Lebih mudah diingat dan dititik daripada ID instans, tetapi hanya unik dalam sesi saat ini. Anda dapat mengetik satu atau beberapa ID, dipisahkan oleh koma. Untuk menemukan ID pekerjaan, jalankan Get-Job.

Properti parameter

Jenis:	Int32[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SessionIdParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-InstanceId

Menentukan array ID instans pekerjaan yang dilanjutkan cmdlet ini. Defaultnya adalah semua pekerjaan.

ID instans adalah GUID yang secara unik mengidentifikasi tugas pada komputer. Untuk menemukan ID instans pekerjaan, jalankan Get-Job.

Properti parameter

Jenis:	Guid[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

InstanceIdParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Job

Menentukan pekerjaan yang akan dilanjutkan. Masukkan variabel yang berisi daftar pekerjaan atau perintah yang mengambil pekerjaan tersebut. Anda juga dapat menyalurkan pekerjaan ke cmdlet Resume-Job.

Properti parameter

Jenis:	Job[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

JobParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Name

Menentukan array nama pekerjaan ramah yang dilanjutkan cmdlet ini. Masukkan satu atau beberapa nama pekerjaan. Karakter pengganti diizinkan.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

NameParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-State

Menentukan status pekerjaan yang akan dilanjutkan. Nilai yang dapat diterima untuk parameter ini adalah:

Belum Mulai
Berlari
Selesai
Kegagalan
Dihentikan
Diblokir
Ditangguhkan
Terputus
Menangguhkan
Berhenti

Cmdlet ini hanya melanjutkan pekerjaan dalam status Ditangguhkan.

Untuk informasi selengkapnya tentang status tugas, lihat Enumerasi JobState.

Properti parameter

Jenis:	JobState
Nilai default:	None
Nilai yang diterima:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

StateParameterSet

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Wait

Menunjukkan bahwa cmdlet ini menekan prompt perintah hingga semua hasil pekerjaan dimulai ulang. Secara default, cmdlet ini segera mengembalikan hasil yang tersedia.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	False
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

Job

Anda dapat menyalurkan semua jenis pekerjaan ke cmdlet ini. Jika Resume-Job mendapatkan pekerjaan dengan jenis yang tidak didukung, maka akan mengembalikan kesalahan yang mengakhiri.

Output

None, System.Management.Automation.Job

Cmdlet ini mengembalikan pekerjaan yang coba dilanjutkan, jika Anda menggunakan parameter PassThru. Jika tidak, cmdlet ini tidak menghasilkan output apa pun.

Catatan

Windows PowerShell menyertakan alias berikut untuk Resume-Job:

rujb
Resume-Job hanya dapat melanjutkan pekerjaan yang ditangguhkan. Jika Anda mengirimkan pekerjaan dalam status yang berbeda, Resume-Job menjalankan operasi resume pada pekerjaan, tetapi menghasilkan peringatan untuk memberi tahu Anda bahwa pekerjaan tidak dapat dilanjutkan. Untuk menekan peringatan, gunakan parameter WarningAction umum dengan nilai SilentlyContinue.
Jika pekerjaan bukan jenis yang mendukung dilanjutkan, seperti pekerjaan alur kerja (PSWorkflowJob), Resume-Job mengembalikan kesalahan yang mengakhiri.
Mekanisme dan lokasi untuk menyimpan pekerjaan yang ditangguhkan mungkin bervariasi tergantung pada jenis pekerjaan. Misalnya, pekerjaan alur kerja yang ditangguhkan disimpan di penyimpanan file datar secara default, tetapi juga dapat disimpan dalam database SQL.
Saat Anda melanjutkan pekerjaan, status pekerjaan berubah dari Ditangguhkan menjadi Menjalankan. Untuk menemukan pekerjaan yang berjalan, termasuk yang dilanjutkan oleh cmdlet ini, gunakan parameter Status cmdlet Get-Job untuk mendapatkan pekerjaan dalam status berjalan.
Beberapa jenis pekerjaan memiliki opsi atau properti yang mencegah Windows PowerShell menangguhkan pekerjaan. Jika upaya untuk menangguhkan pekerjaan gagal, verifikasi bahwa opsi pekerjaan dan properti memungkinkan penangguhan.

Saran dan Komentar

Apakah halaman ini membantu?

Resume-Job

Sintaks

SessionIdParameterSet (Default)

JobParameterSet

NameParameterSet

InstanceIdParameterSet

StateParameterSet

FilterParameterSet

Deskripsi

Contoh

Contoh 1: Melanjutkan pekerjaan berdasarkan ID

Contoh 2: Melanjutkan pekerjaan berdasarkan nama

Contoh 3: Menggunakan nilai properti kustom

Contoh 4: Melanjutkan semua pekerjaan yang ditangguhkan di komputer jarak jauh

Contoh 5: Tunggu pekerjaan dilanjutkan

Contoh 6: Melanjutkan alur kerja yang menangguhkan dirinya sendiri

Parameter

-Confirm

Properti parameter

Kumpulan parameter

-Filter

Properti parameter

Kumpulan parameter

-Id

Properti parameter

Kumpulan parameter

-InstanceId

Properti parameter

Kumpulan parameter

-Job

Properti parameter

Kumpulan parameter

-Name

Properti parameter

Kumpulan parameter

-State

Properti parameter

Kumpulan parameter

-Wait

Properti parameter

Kumpulan parameter

-WhatIf

Properti parameter

Kumpulan parameter

CommonParameters

Input

Job

Output

None, System.Management.Automation.Job

Catatan

Link Terkait

Saran dan Komentar