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

Remove-JobTrigger Cmdlet 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 parameter Remove-JobTriggerNama, ID, atau InputObject 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-JobTriggeradalah 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 pada 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 di sesi Anda lalu ketik Delete-AtStartup.

Fungsi ini Delete-AtStartup berisi satu perintah. Perintah menggunakan Get-ScheduledJob cmdlet untuk mendapatkan pekerjaan terjadwal di komputer lokal. Operator alur (|) mengirimkan pekerjaan terjadwal ke Get-JobTrigger cmdlet, yang mendapatkan semua pemicu pekerjaan dari setiap pekerjaan terjadwal. Operator alur mengirimkan pemicu pekerjaan ke Where-Object cmdlet, 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 ForEach-Object cmdlet, yang menjalankan Remove-JobTrigger perintah pada setiap pemicu AtStartup. Nilai parameter InputObject adalah Remove-JobTrigger pekerjaan terjadwal di properti JobDefinition pemicu pekerjaan. Nilai parameter TriggerID adalah pengidentifikasi di 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 Invoke-Command cmdlet untuk menjalankan Remove-JobTrigger cmdlet pada komputer Server01. Remove-JobTrigger Cmdlet 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 nomor identifikasi pekerjaan terjadwal di komputer lokal atau komputer jarak jauh, gunakan Get-ScheduledJob cmdlet .

Type:Int32[]
Position:0
Default value:None
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 Remove-JobTrigger.

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters: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 Get-ScheduledJob cmdlet .

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Input

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Anda dapat menyalurkan pekerjaan terjadwal ke Remove-JobTrigger cmdlet.

Output

None

Cmdlet tidak menghasilkan output apa pun.