Remove-JobTrigger
Menghapus pemicu pekerjaan dari pekerjaan terjadwal.
Sintaks
Remove-JobTrigger
[-TriggerId <Int32[]>]
[-InputObject] <ScheduledJobDefinition[]>
[<CommonParameters>]
Remove-JobTrigger
[-TriggerId <Int32[]>]
[-Id] <Int32[]>
[<CommonParameters>]
Remove-JobTrigger
[-TriggerId <Int32[]>]
[-Name] <String[]>
[<CommonParameters>]
Deskripsi
cmdlet Remove-JobTrigger
menghapus pemicu pekerjaan dari pekerjaan terjadwal.
Pemicu pekerjaan menentukan jadwal atau kondisi berulang untuk memulai pekerjaan terjadwal. Untuk mengelola pemicu pekerjaan, gunakan cmdlet New-JobTrigger, Add-JobTrigger, Set-JobTrigger, dan Set-ScheduledJob
.
Gunakan Nama, ID , atau parameter InputObjectRemove-JobTrigger
untuk mengidentifikasi pekerjaan terjadwal tempat pemicu dihapus. Gunakan parameter triggerID untuk mengidentifikasi pemicu pekerjaan yang akan dihapus. Secara default, Remove-JobTrigger
menghapus semua pemicu pekerjaan dari pekerjaan terjadwal.
Remove-JobTrigger
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 semua pemicu pekerjaan
Remove-JobTrigger -Name "Test*"
Perintah ini menghapus semua pemicu pekerjaan dari pekerjaan terjadwal yang memiliki nama yang dimulai dengan Uji.
Contoh 2: Menghapus pemicu pekerjaan yang dipilih
Remove-JobTrigger -Name "BackupArchive" -TriggerID 3
Perintah ini hanya menghapus pemicu ketiga (ID = 3) dari pekerjaan terjadwal BackupArchive.
Contoh 3: Menghapus pemicu pekerjaan AtStartup dari semua pekerjaan terjadwal
function Delete-AtStartup
{
Get-ScheduledJob | Get-JobTrigger | Where-Object {$_.Frequency -eq "AtStartup"} | ForEach-Object { Remove-JobTrigger -InputObject $_.JobDefinition -TriggerID $_.ID}
}
Fungsi ini menghapus semua pemicu pekerjaan AtStartup dari semua pekerjaan di komputer lokal.
Untuk menggunakan fungsi , jalankan fungsi dalam sesi Anda lalu ketik Delete-AtStartup
.
Fungsi Delete-AtStartup
berisi satu perintah. Perintah menggunakan cmdlet Get-ScheduledJob
untuk mendapatkan pekerjaan terjadwal di komputer lokal. Operator alur (|
) mengirim pekerjaan terjadwal ke cmdlet Get-JobTrigger
, yang mendapatkan semua pemicu pekerjaan dari setiap pekerjaan terjadwal. Operator alur mengirimkan pemicu pekerjaan ke cmdlet Where-Object
, yang memilih pemicu pekerjaan di mana nilai properti Frekuensi pemicu pekerjaan sama dengan AtStartup.
objek JobTrigger memiliki properti JobDefinition yang berisi pekerjaan terjadwal yang dipicunya. Sisa perintah menggunakan fitur berharga tersebut.
Operator alur mengirimkan pemicu pekerjaan AtStartup ke cmdlet ForEach-Object
, yang menjalankan perintah Remove-JobTrigger
pada setiap pemicu AtStartup. Nilai parameter InputObject Remove-JobTrigger
adalah pekerjaan terjadwal di properti JobDefinition dari pemicu pekerjaan. Nilai parameter TriggerID adalah pengidentifikasi dalam properti ID pemicu pekerjaan.
Contoh 4: Menghapus pemicu pekerjaan dari pekerjaan terjadwal jarak jauh
Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }
Perintah ini menghapus pemicu pekerjaan pertama dari pekerjaan Inventori di komputer Server01.
Perintah menggunakan cmdlet Invoke-Command
untuk menjalankan cmdlet Remove-JobTrigger
pada komputer Server01. Cmdlet Remove-JobTrigger
menggunakan parameter ID untuk mengidentifikasi pekerjaan terjadwal Inventori dan parameter TriggerID untuk menentukan pemicu pertama. Parameter ID sangat berguna ketika beberapa pekerjaan terjadwal memiliki nama yang sama atau serupa.
Parameter
-Id
Menentukan nomor identifikasi pekerjaan terjadwal.
Remove-JobTrigger
menghapus pemicu pekerjaan dari pekerjaan terjadwal yang ditentukan.
Untuk mendapatkan jumlah identifikasi pekerjaan terjadwal di komputer lokal atau komputer jarak jauh, gunakan cmdlet Get-ScheduledJob
.
Jenis: | Int32[] |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-InputObject
Menentukan pekerjaan terjadwal. Masukkan variabel yang berisi objek ScheduledJob atau ketik perintah atau ekspresi yang mendapatkan objek ScheduledJob, seperti perintah Get-ScheduledJob
. Anda juga dapat menyalurkan objek ScheduledJob ke Remove-JobTrigger
.
Jenis: | ScheduledJobDefinition[] |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Name
Menentukan nama pekerjaan terjadwal.
Remove-JobTrigger
menghapus pemicu pekerjaan dari pekerjaan terjadwal yang ditentukan. Kartubebas didukung.
Untuk mendapatkan nama pekerjaan terjadwal di komputer lokal atau komputer jarak jauh, gunakan cmdlet Get-ScheduledJob
.
Jenis: | String[] |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | False |
-TriggerId
Hanya menghapus pemicu pekerjaan yang ditentukan. Secara default, Remove-JobTrigger
menghapus semua pemicu dari pekerjaan terjadwal. Gunakan parameter ini saat pekerjaan terjadwal memiliki beberapa pemicu pekerjaan.
Masukkan ID pemicu dari satu atau beberapa pemicu pekerjaan dari pekerjaan terjadwal. Jika Anda menentukan beberapa pekerjaan terjadwal, Remove-JobTrigger
menghapus pemicu pekerjaan dengan ID yang ditentukan dari semua pekerjaan terjadwal.
Jenis: | Int32[] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
Input
Anda dapat menyalurkan pekerjaan terjadwal ke cmdlet ini.
Output
None
Cmdlet ini tidak mengembalikan output.
Link Terkait
- Add-JobTrigger
- Disable-JobTrigger
- Disable-ScheduledJob
- Enable-JobTrigger
- Enable-ScheduledJob
- Get-JobTrigger
- Get-ScheduledJob
- Get-ScheduledJobOption
- New-JobTrigger
- New-ScheduledJobOption
- Register-ScheduledJob
- Remove-JobTrigger
- Set-JobTrigger
- Set-ScheduledJob
- Set-ScheduledJobOption
- Unregister-ScheduledJob