Bagikan melalui

Remove-JobTrigger

Modul:
PSScheduledJob Module

Menghapus pemicu pekerjaan dari pekerjaan terjadwal.

Sintaks

JobDefinition (Default) 

Remove-JobTrigger
    [-InputObject] <ScheduledJobDefinition[]>
    [-TriggerId <Int32[]>]
    [<CommonParameters>]

JobDefinitionId 

Remove-JobTrigger
    [-Id] <Int32[]>
    [-TriggerId <Int32[]>]
    [<CommonParameters>]

JobDefinitionName 

Remove-JobTrigger
    [-Name] <String[]>
    [-TriggerId <Int32[]>]
    [<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 parameter Name, Id, atau 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.

Properti parameter

Jenis:

Int32[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

JobDefinitionId
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:

ScheduledJobDefinition[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

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

-Name

Menentukan nama pekerjaan terjadwal. Remove-JobTrigger menghapus pemicu pekerjaan dari pekerjaan terjadwal yang ditentukan. Penggunaan wildcard didukung.

Untuk mendapatkan nama pekerjaan terjadwal di komputer lokal atau komputer jarak jauh, gunakan cmdlet Get-ScheduledJob.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

JobDefinitionName
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:

Int32[]

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

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

ScheduledJobDefinition

Anda dapat menyalurkan pekerjaan terjadwal ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.