Bagikan melalui


Get-JobTrigger

Mendapatkan pemicu pekerjaan dari pekerjaan terjadwal.

Sintaks

Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-InputObject] <ScheduledJobDefinition>
   [<CommonParameters>]
Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Id] <Int32>
   [<CommonParameters>]
Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Name] <String>
   [<CommonParameters>]

Deskripsi

cmdlet Get-JobTrigger mendapatkan pemicu pekerjaan pekerjaan terjadwal. Anda dapat menggunakan perintah ini untuk memeriksa pemicu pekerjaan atau untuk menyalurkan pemicu pekerjaan ke cmdlet lain.

Pemicu pekerjaan menentukan jadwal atau kondisi berulang untuk memulai pekerjaan terjadwal. Pemicu pekerjaan tidak disimpan ke disk secara independen; mereka adalah bagian dari pekerjaan terjadwal. Untuk mendapatkan pemicu pekerjaan, tentukan pekerjaan terjadwal yang dimulai pemicunya.

Gunakan parameter cmdlet Get-JobTrigger untuk mengidentifikasi pekerjaan terjadwal. Anda dapat mengidentifikasi pekerjaan terjadwal berdasarkan nama atau nomor identifikasinya, atau dengan memasukkan atau mempipa objek ScheduledJob, seperti yang dikembalikan oleh cmdlet Get-ScheduledJob, untuk Get-JobTrigger.

Get-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: Dapatkan pemicu pekerjaan berdasarkan nama pekerjaan terjadwal

Get-JobTrigger -Name "BackupJob"

Perintah ini menggunakan parameter NamaGet-JobTrigger untuk mendapatkan pemicu pekerjaan dari pekerjaan terjadwal BackupJob.

Contoh 2: Mendapatkan pemicu pekerjaan berdasarkan ID

Contohnya menggunakan parameter IdGet-JobTrigger untuk mendapatkan pemicu pekerjaan dari pekerjaan terjadwal.

Get-ScheduledJob

Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProjects {1}             \\Server\Share\Archive-Projects.ps1      True
2          Backup          {1,2}           \\Server\Share\Run-Backup.ps1            True
3          Test-HelpFiles  {1}             \\Server\Share\Test-HelpFiles.ps1        True
4          TestJob         {}              \\Server\Share\Run-AllTests.ps1          True

Get-JobTrigger -Id 3

Perintah pertama menggunakan cmdlet Get-ScheduledJob untuk menampilkan pekerjaan terjadwal di komputer lokal. Tampilan mencakup ID pekerjaan terjadwal.

Perintah kedua menggunakan cmdlet Get-JobTrigger untuk mendapatkan pemicu pekerjaan untuk pekerjaan Test-HelpFiles (yang Id-nya 3).

Contoh 3: Mendapatkan pemicu pekerjaan dengan memicu pekerjaan

Contoh ini mendapatkan pemicu pekerjaan pekerjaan yang memiliki nama yang cocok.

Get-ScheduledJob -Name *Backup*, *Archive* | Get-JobTrigger

Perintah ini mendapatkan pemicu pekerjaan dari semua pekerjaan yang memiliki Backup atau Archive atas namanya.

Contoh 4: Mendapatkan pemicu pekerjaan pekerjaan di komputer jarak jauh

Contoh ini mendapatkan pemicu pekerjaan terjadwal di komputer jarak jauh.

Invoke-Command -ComputerName Server01 { Get-ScheduledJob Backup | Get-JobTrigger -TriggerId 2 }

Perintah menggunakan cmdlet Invoke-Command untuk menjalankan perintah di komputer Server01. Ini menggunakan cmdlet Get-ScheduledJob untuk mendapatkan pekerjaan terjadwal Backup, yang disalurkan ke cmdlet Get-JobTrigger. Ini menggunakan parameter TriggerId untuk mendapatkan hanya pemicu kedua.

Contoh 5: Mendapatkan semua pemicu pekerjaan

Contoh ini mendapatkan semua pemicu pekerjaan dari semua pekerjaan terjadwal di komputer lokal.

Get-ScheduledJob | Get-JobTrigger |
    Format-Table -Property Id, Frequency, At, DaysOfWeek, Enabled, @{Label="ScheduledJob";Expression={$_.JobDefinition.Name}} -AutoSize

Id Frequency At                    DaysOfWeek Enabled ScheduledJob
-- --------- --                    ---------- ------- ------------
1    Weekly  9/28/2011 3:00:00 AM  {Monday}   True    Backup
1    Daily   9/27/2011 11:00:00 PM            True    Test-HelpFiles

Perintah menggunakan Get-ScheduledJob untuk mendapatkan pekerjaan terjadwal di komputer lokal dan menyalurkannya ke Get-JobTrigger, yang mendapatkan pemicu pekerjaan dari setiap pekerjaan terjadwal (jika ada).

Untuk menambahkan nama pekerjaan terjadwal ke tampilan pemicu pekerjaan, perintah menggunakan fitur properti terhitung dari cmdlet Format-Table. Selain properti pemicu pekerjaan yang ditampilkan secara default, perintah membuat properti ScheduledJob baru yang menampilkan nama pekerjaan terjadwal.

Contoh 6: Mendapatkan properti pemicu pekerjaan dari pekerjaan terjadwal

Contoh ini menunjukkan metode yang berbeda untuk melihat properti JobTrigger dari pekerjaan terjadwal.

(Get-ScheduledJob Test-HelpFiles).JobTriggers
Get-ScheduledJob | foreach {$_.JobTriggers}

Perintah pertama menggunakan cmdlet Get-ScheduledJob untuk mendapatkan pekerjaan terjadwal Test-HelpFiles. Kemudian menggunakan metode titik (.) untuk mendapatkan properti JobTriggers dari pekerjaan terjadwal Test-HelpFiles.

Perintah kedua menggunakan cmdlet Get-ScheduledJob untuk mendapatkan semua pekerjaan terjadwal di komputer lokal. Ini menggunakan cmdlet ForEach-Object untuk mendapatkan nilai properti JobTriggers dari setiap pekerjaan terjadwal.

Pemicu pekerjaan dari pekerjaan terjadwal disimpan di properti JobTriggers pekerjaan. Contoh ini menunjukkan alternatif untuk menggunakan cmdlet Get-JobTrigger untuk mendapatkan pemicu pekerjaan. Hasilnya identik dengan menggunakan cmdlet Get-JobTrigger dan teknik dapat digunakan secara bergantian.

Contoh 7: Membandingkan pemicu pekerjaan

Get-ScheduledJob -Name ArchiveProjects | Get-JobTrigger | Tee-Object -Variable t1

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/26/2011 3:00:00 AM                           True

Get-ScheduledJob -Name "Test-HelpFiles" | Get-JobTrigger | Tee-Object -Variable t2

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/26/2011 3:00:00 AM                           True

$t1| Get-Member -Type Property | ForEach-Object { Compare-Object $t1 $t2 -Property $_.Name}

RandomDelay                                                 SideIndicator
-----------                                                 -------------
00:00:00                                                    =>
00:03:00                                                    <=

Perintah pertama mendapatkan pemicu pekerjaan dari pekerjaan terjadwal ArchiveProjects. Perintah menyalurkan pemicu pekerjaan ke cmdlet Tee-Object, yang menyimpan pemicu pekerjaan dalam variabel $t1 dan menampilkannya di baris perintah.

Perintah kedua mendapatkan pemicu pekerjaan dari pekerjaan terjadwal Test-HelpFiles. Perintah menyalurkan pemicu pekerjaan ke cmdlet Tee-Object, yang menyimpan pemicu pekerjaan dalam variabel $t2 dan menampilkannya di baris perintah.

Perintah ketiga membandingkan pemicu pekerjaan dalam variabel $t1 dan $t 2. Ini menggunakan cmdlet Get-Member untuk mendapatkan properti pemicu pekerjaan dalam variabel $t 1. Ini menyalurkan properti ke cmdlet ForEach-Object, yang membandingkan setiap properti dengan properti pemicu pekerjaan dalam variabel $t2 berdasarkan nama. Perintah kemudian menyalurkan properti yang berbeda ke cmdlet Format-List, yang menampilkannya dalam daftar. Output menunjukkan bahwa, meskipun pemicu pekerjaan tampaknya sama, pemicu pekerjaan HelpFiles mencakup penundaan acak tiga (3) menit.

Contoh ini menunjukkan cara membandingkan pemicu pekerjaan dari dua pekerjaan terjadwal.

Parameter

-Id

Menentukan nomor identifikasi pekerjaan terjadwal. Get-JobTrigger mendapatkan 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 Get-JobTrigger.

Jenis:ScheduledJobDefinition
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Name

Menentukan nama pekerjaan terjadwal. Get-JobTrigger mendapatkan 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

Mendapatkan pemicu pekerjaan yang ditentukan. Masukkan ID pemicu dari satu atau beberapa pemicu pekerjaan dari pekerjaan terjadwal. Gunakan parameter ini saat pekerjaan terjadwal yang ditentukan oleh Nama, Id , atau parameter InputObject memiliki beberapa pemicu pekerjaan.

Jenis:Int32[]
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

ScheduledJobDefinition

Anda dapat menyalurkan pekerjaan terjadwal ke cmdlet ini.

Output

ScheduledJobTrigger

Cmdlet ini mengembalikan pemicu pekerjaan terjadwal.