Get-JobTrigger

  • Referensi
Modul:
PSScheduledJob

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

Get-JobTrigger Cmdlet 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 Get-JobTrigger cmdlet untuk mengidentifikasi pekerjaan terjadwal. Anda dapat mengidentifikasi pekerjaan terjadwal dengan nama atau nomor identifikasinya, atau dengan memasukkan atau mempipa objek ScheduledJob , seperti yang dikembalikan oleh Get-ScheduledJob cmdlet, ke 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 menggunakan parameter Get-JobTrigger Nama untuk mendapatkan pemicu pekerjaan dari pekerjaan terjadwalBackupJob.

Contoh 2: Mendapatkan pemicu pekerjaan berdasarkan ID

Contoh menggunakan parameter Get-JobTrigger ID 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 Get-ScheduledJob cmdlet untuk menampilkan pekerjaan terjadwal di komputer lokal. Tampilan mencakup ID pekerjaan terjadwal.

Perintah kedua menggunakan Get-JobTrigger cmdlet untuk mendapatkan pemicu pekerjaan untuk Test-HelpFiles pekerjaan (yang ID-nya adalah 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 Invoke-Command cmdlet untuk menjalankan perintah di komputer Server01. Ini menggunakan Get-ScheduledJob cmdlet untuk mendapatkan pekerjaan terjadwal Backup , yang disalurkan ke Get-JobTrigger cmdlet. 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 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 Get-ScheduledJob cmdlet untuk mendapatkan pekerjaan terjadwal Test-HelpFiles . Kemudian menggunakan metode titik (.) untuk mendapatkan properti JobTriggers dari pekerjaan terjadwal Test-HelpFiles .

Perintah kedua menggunakan Get-ScheduledJob cmdlet untuk mendapatkan semua pekerjaan terjadwal di komputer lokal. Ini menggunakan ForEach-Object cmdlet 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 Get-JobTrigger cmdlet untuk mendapatkan pemicu pekerjaan. Hasilnya identik dengan menggunakan Get-JobTrigger cmdlet 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 Tee-Object cmdlet, yang menyimpan pemicu pekerjaan dalam $t1 variabel dan menampilkannya di baris perintah.

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

Perintah ketiga membandingkan pemicu pekerjaan dalam $t1 variabel dan $t 2. Ini menggunakan Get-Member cmdlet untuk mendapatkan properti pemicu pekerjaan dalam variabel $t 1. Ini menyalurkan properti ke ForEach-Object cmdlet, yang membandingkan setiap properti dengan properti pemicu pekerjaan dalam $t2 variabel berdasarkan nama. Perintah kemudian menyalurkan properti yang berbeda ke Format-List cmdlet, yang menampilkannya dalam daftar. Output menunjukkan bahwa, meskipun pemicu pekerjaan tampaknya sama, HelpFiles pemicu pekerjaan 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 Get-ScheduledJob cmdlet .

Type:Int32
Position:0
Default value:None
Required:True
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 Get-JobTrigger.

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

-Name

Menentukan nama pekerjaan terjadwal. Get-JobTrigger mendapatkan pemicu pekerjaan dari pekerjaan terjadwal yang ditentukan. Penggunaan wildcard didukung.

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 parameter Nama, ID, atau InputObject memiliki beberapa pemicu pekerjaan.

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

Input

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Anda dapat menyalurkan pekerjaan terjadwal ke cmdlet ini.

Output

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Cmdlet ini mengembalikan pemicu pekerjaan terjadwal.