Bagikan melalui

Disable-JobTrigger

  • Referensi
Modul:
PSScheduledJob

Menonaktifkan pemicu pekerjaan pekerjaan terjadwal.

Sintaks

Disable-JobTrigger
       [-InputObject] <ScheduledJobTrigger[]>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Deskripsi

cmdlet Disable-JobTrigger untuk sementara menonaktifkan pemicu pekerjaan pekerjaan terjadwal. Menonaktifkan mempertahankan semua properti pemicu pekerjaan, tetapi mencegah pemicu pekerjaan memulai pekerjaan terjadwal.

Untuk menggunakan cmdlet ini, gunakan cmdlet Get-JobTrigger untuk mendapatkan pemicu pekerjaan. Kemudian pipa pemicu pekerjaan untuk Disable-JobTrigger atau menggunakan parameter InputObject.

Untuk menonaktifkan pemicu pekerjaan, cmdlet Disable-JobTrigger mengatur properti Diaktifkan dari pemicu pekerjaan ke $False. Untuk mengaktifkan kembali pemicu pekerjaan, gunakan cmdlet Enable-JobTrigger, yang mengatur properti Diaktifkan dari pemicu pekerjaan ke $True. Menonaktifkan pemicu pekerjaan tidak menonaktifkan pekerjaan terjadwal, seperti dilakukan oleh cmdlet Disable-ScheduledJob, tetapi jika Anda menonaktifkan semua pemicu pekerjaan, efeknya sama dengan menonaktifkan pekerjaan terjadwal.

Jika Anda menonaktifkan pekerjaan terjadwal atau menonaktifkan semua pemicu pekerjaan pekerjaan terjadwal, Anda masih dapat memulai pekerjaan dengan menggunakan cmdlet Start-Job atau menggunakan pekerjaan terjadwal yang dinonaktifkan sebagai templat.

Disable-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: Menonaktifkan pemicu pekerjaan

Contoh ini menonaktifkan pemicu pertama pekerjaan terjadwal di komputer lokal.

PS C:\> Get-JobTrigger -Name "Backup-Archives" -TriggerID 1 | Disable-JobTrigger

Perintah menggunakan cmdlet Get-JobTrigger untuk mendapatkan pemicu pekerjaan. Operator alur (|)mengirim pemicu pekerjaan ke cmdlet Disable-JobTrigger, yang menonaktifkannya.

Contoh 2: Menonaktifkan semua pemicu pekerjaan

Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger
Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger |
    Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}} -AutoSize

Id Frequency At                     DaysOfWeek Enabled JobName
-- --------- --                     ---------- ------- -------
1  Weekly    9/28/2011 3:00:00 AM   {Monday}   False   Backup-Archive
2  Daily     9/29/2011 1:00:00 AM              False   Backup-Archive
1  Weekly    10/20/2011 11:00:00 PM {Friday}   False   Inventory
1  Weekly    11/2/2011 2:00:00 PM   {Monday}   False   Inventory

Perintah pertama menggunakan cmdlet Get-ScheduledJob untuk mendapatkan pekerjaan terjadwal Backup-Archives dan Inventori. Operator alur (|) mengirim pekerjaan terjadwal ke cmdlet Get-JobTrigger, yang mendapatkan semua pemicu pekerjaan dari pekerjaan terjadwal. Operator alur lain mengirim pemicu pekerjaan ke cmdlet Disable-JobTrigger, yang menonaktifkannya. Perintah pertama menggunakan cmdlet Get-ScheduledJob untuk mendapatkan pekerjaan, karena parameter Nama mengambil beberapa nama.

Perintah kedua menampilkan hasilnya. Perintah mengulangi perintah Get-ScheduledJob dan Get-JobTrigger. Operator alur mengirimkan pemicu pekerjaan ke cmdlet Format-Table, yang menampilkan pemicu pekerjaan dalam tabel. Perintah Format-Table menambahkan properti JobName yang menampilkan nilai properti Nama dari pekerjaan terjadwal di properti JobDefinition dari objek pemicu pekerjaan.

Perintah ini menonaktifkan semua pemicu pekerjaan pada dua pekerjaan terjadwal dan menampilkan hasilnya.

Contoh 3: Menonaktifkan pemicu pekerjaan pekerjaan terjadwal di komputer jarak jauh

Contoh ini menonaktifkan pemicu pekerjaan harian untuk pekerjaan terjadwal di komputer jarak jauh

Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "Daily"} | Disable-JobTrigger}

Perintah menggunakan cmdlet Invoke-Command untuk menjalankan perintah di komputer Server01. Perintah jarak jauh menggunakan cmdlet Get-JobTrigger untuk mendapatkan pemicu pekerjaan dari pekerjaan terjadwal DeployPackage. Operator alur mengirimkan pemicu pekerjaan ke cmdlet Where-Object, yang hanya mengembalikan pemicu pekerjaan harian. Operator alur mengirimkan pemicu pekerjaan harian ke cmdlet Disable-JobTrigger, yang menonaktifkannya.

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-InputObject

Menentukan pemicu pekerjaan yang akan dinonaktifkan. Masukkan variabel yang berisi objek ScheduledJobTrigger atau ketik perintah atau ekspresi yang mendapatkan objek ScheduledJobTrigger, seperti perintah Get-JobTrigger. Anda juga dapat menyalurkan objek ScheduledJobTrigger ke Disable-JobTrigger.

Jenis:ScheduledJobTrigger[]
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-PassThru

Mengembalikan objek yang mewakili item tempat Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-WhatIf

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

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

ScheduledJobTrigger

Anda dapat menyalurkan pemicu pekerjaan ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

  • Disable-JobTrigger tidak menghasilkan kesalahan atau peringatan jika Anda menonaktifkan pemicu pekerjaan yang sudah dinonaktifkan.