Unregister-ScheduledJob

  • Referensi
Modul:
PSScheduledJob

Menghapus pekerjaan terjadwal pada komputer lokal.

Sintaks

Unregister-ScheduledJob
          [-InputObject] <ScheduledJobDefinition[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Id] <Int32[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Name] <String[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Deskripsi

Unregister-ScheduledJob Cmdlet menghapus pekerjaan terjadwal dari komputer lokal.

Ketika menghapus atau membatalkan pendaftaran pekerjaan terjadwal, Unregister-ScheduledJob menghapus direktori untuk pekerjaan terjadwal (dalam $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directory), yang berisi file XML yang menentukan pekerjaan terjadwal, riwayat eksekusi pekerjaan, dan semua hasil pekerjaan. Tindakan ini juga menghapus pekerjaan dari Task Scheduler.

Unregister-ScheduledJob hanya menghapus pekerjaan terjadwal yang dibuat dengan menggunakan Register-ScheduledJob cmdlet. Ini tidak menghapus pekerjaan terjadwal yang dibuat di Task Scheduler.

Anda dapat menggunakan parameter Unregister-ScheduledJob untuk menghapus pekerjaan terjadwal berdasarkan ID atau nama, atau pekerjaan terjadwal pipa dari Get-ScheduledJob ke Unregister-ScheduledJob.

Unregister-ScheduledJob adalah salah satu kumpulan cmdlet penjadwalan pekerjaan dalam modul PSScheduledJob yang disertakan dalam Windows PowerShell.

Untuk informasi selengkapnya tentang Pekerjaan Terjadwal, lihat topik Tentang dalam modul PSScheduledJob. Impor modul PSScheduledJob lalu ketik: Get-Help about_Scheduled* atau lihat about_Scheduled_Jobs.

Cmdlet ini diperkenalkan di Windows PowerShell 3.0.

Contoh

Contoh 1: Menghapus pekerjaan terjadwal

Unregister-ScheduledJob TestJob

Perintah ini menghapus pekerjaan terjadwal TestJob di komputer lokal.

Contoh 2: Menghapus semua pekerjaan terjadwal

Get-ScheduledJob | Unregister-ScheduledJob -Force
Unregister-ScheduledJob -Name "*" -Force

Contoh ini menunjukkan dua perintah berbeda yang menghapus semua pekerjaan terjadwal di komputer lokal.

Perintah pertama menggunakan Get-ScheduledJob cmdlet untuk mendapatkan semua pekerjaan terjadwal di komputer lokal. Operator alur (|) mengirim pekerjaan terjadwal ke Unregister-ScheduleJob, yang menghapusnya.

Perintah kedua menggunakan parameter Unregister-ScheduledJob Nama dengan nilai semua (*) untuk menghapus semua pekerjaan terjadwal.

Kedua perintah menggunakan parameter Force , yang menghapus pekerjaan terjadwal bahkan jika instans pekerjaan sedang berjalan.

Contoh 3: Menghapus pekerjaan terjadwal di komputer jarak jauh

Invoke-Command -ComputerName "Server01" { Unregister-ScheduledJob -Name "Test*"}

Perintah ini menghapus pekerjaan terjadwal dengan nama yang dimulai dengan Uji pada komputer jarak jauh Server01. Perintah menggunakan Invoke-Command cmdlet untuk menjalankan Unregister-ScheduledJob perintah di komputer Server02.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Force

Menghapus pekerjaan terjadwal meskipun instans pekerjaan sedang berjalan. Secara default, Unregister-ScheduledJob tidak mengganggu pekerjaan yang sedang berjalan.

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

-Id

Menghapus pekerjaan terjadwal dengan nomor identifikasi (ID) yang ditentukan. Masukkan ID pekerjaan terjadwal di komputer.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Menentukan pekerjaan terjadwal. Masukkan variabel yang berisi objek ScheduledJob atau ketik perintah atau ekspresi yang mendapatkan objek ScheduledJob , seperti Get-ScheduledJob perintah. Anda juga dapat menyalurkan objek ScheduledJob ke Unregister-JobTrigger.

Type:ScheduledJobDefinition[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Menghapus pekerjaan terjadwal dengan nama yang ditentukan. Masukkan nama satu atau beberapa pekerjaan terjadwal pada komputer. Penggunaan wildcard didukung.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

ScheduledJobDefinition

Anda dapat menyalurkan pekerjaan terjadwal ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.