Add-JobTrigger

Menambahkan pemicu pekerjaan ke pekerjaan terjadwal.

Sintaks

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-InputObject] <ScheduledJobDefinition[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Name] <String[]>
   [<CommonParameters>]

Deskripsi

Add-JobTrigger Cmdlet menambahkan pemicu pekerjaan ke pekerjaan terjadwal. Anda dapat menggunakannya untuk menambahkan beberapa pemicu ke beberapa pekerjaan terjadwal.

Pemicu pekerjaan memulai pekerjaan terjadwal pada jadwal satu kali atau berulang atau saat peristiwa terjadi.

Gunakan parameter Pemicu untuk Add-JobTrigger mengidentifikasi pemicu pekerjaan yang akan ditambahkan. Gunakan parameter Add-JobTriggerNama, ID, atau InputObject untuk mengidentifikasi pekerjaan terjadwal tempat pemicu ditambahkan.

Untuk membuat pemicu pekerjaan untuk nilai parameter Pemicu , gunakan New-JobTrigger cmdlet atau gunakan tabel hash untuk menentukan pemicu pekerjaan.

Add-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 di Windows PowerShell 3.0.

Contoh

Contoh 1: Menambahkan pemicu pekerjaan ke pekerjaan terjadwal

$Daily = New-JobTrigger -Daily -At 3AMPS
Add-JobTrigger -Trigger $Daily -Name "TestJob"

Perintah ini menambahkan pemicu pekerjaan Harian ke pekerjaan terjadwal TestJob.

Perintah pertama menggunakan New-JobTrigger cmdlet untuk membuat pemicu pekerjaan yang memulai pekerjaan terjadwal setiap hari pada pukul 3:00 pagi. Perintah menyimpan pemicu pekerjaan dalam $Daily variabel .

Perintah kedua menggunakan Add-JobTrigger cmdlet untuk menambahkan pemicu pekerjaan dalam variabel $Startup ke pekerjaan terjadwal TestJob.

Contoh 2: Menambahkan pemicu pekerjaan ke beberapa pekerjaan terjadwal

Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

Perintah ini menambahkan pemicu pekerjaan AtStartup ke semua pekerjaan terjadwal di komputer lokal. Ini menggunakan Get-ScheduledJob untuk mendapatkan semua pekerjaan terjadwal di komputer. Ini menggunakan operator alur (|) untuk mengirim pekerjaan ke Add-JobTrigger cmdlet, yang menambahkan pemicu pekerjaan ke setiap pekerjaan terjadwal. Nilai parameter Pemicu adalah New-JobTrigger perintah yang membuat pemicu pekerjaan AtStartup.

Contoh 3: Menyalin pemicu pekerjaan

$T = Get-JobTrigger -Name "BackupArchives"
Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

Perintah ini menyalin pemicu pekerjaan dari pekerjaan terjadwal BackupArchives dan menambahkannya ke pekerjaan terjadwal TestBackup dan BackupLogs.

Perintah pertama menggunakan Get-JobTrigger cmdlet untuk mendapatkan pemicu pekerjaan dari pekerjaan terjadwal BackupArchives. Perintah menyimpan pemicu dalam variabel $t.

Perintah kedua menggunakan Add-JobTrigger cmdlet untuk menambahkan pemicu pekerjaan di $t ke pekerjaan terjadwal TestBackup dan BackupLogs.

Parameter

-Id

Menentukan nomor identifikasi pekerjaan terjadwal. Add-JobTrigger menambahkan pemicu pekerjaan ke 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 Add-JobTrigger.

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Menentukan nama pekerjaan terjadwal. Add-JobTrigger menambahkan pemicu pekerjaan ke 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

-Trigger

Menentukan pemicu pekerjaan yang akan ditambahkan. Masukkan tabel hash yang menentukan pemicu pekerjaan atau variabel yang berisi objek ScheduledJobTrigger , atau ketik perintah atau ekspresi yang mendapatkan objek ScheduledJobTrigger , seperti Get-JobTrigger perintah. Anda juga dapat menyalurkan objek ScheduledJobTrigger ke Add-JobTrigger.

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger[]
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

Input

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger, Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Anda dapat menyalurkan pemicu pekerjaan atau pekerjaan terjadwal ke Add-JobTrigger.

Output

None

Cmdlet ini tidak mengembalikan output apa pun.