New-JobTrigger

Membuat pemicu pekerjaan untuk pekerjaan terjadwal.

Sintaks

New-JobTrigger
   [-RandomDelay <TimeSpan>]
   -At <DateTime>
   [-Once]
   [-RepetitionInterval <TimeSpan>]
   [-RepetitionDuration <TimeSpan>]
   [-RepeatIndefinitely]
   [<CommonParameters>]
New-JobTrigger
   [-DaysInterval <Int32>]
   [-RandomDelay <TimeSpan>]
   -At <DateTime>
   [-Daily]
   [<CommonParameters>]
New-JobTrigger
   [-WeeksInterval <Int32>]
   [-RandomDelay <TimeSpan>]
   -At <DateTime>
   -DaysOfWeek<DayOfWeek[]>
   [-Weekly]
   [<CommonParameters>]
New-JobTrigger
   [-RandomDelay <TimeSpan>]
   [-AtStartup]
   [<CommonParameters>]
New-JobTrigger
   [-RandomDelay <TimeSpan>]
   [-User <String>]
   [-AtLogOn]
   [<CommonParameters>]

Deskripsi

New-JobTrigger Cmdlet membuat pemicu pekerjaan yang memulai pekerjaan terjadwal pada jadwal satu kali atau berulang, atau saat peristiwa terjadi.

Anda dapat menggunakan objek ScheduledJobTrigger yang New-JobTrigger kembali untuk mengatur pemicu pekerjaan untuk pekerjaan terjadwal baru atau yang sudah ada. Anda juga dapat membuat pemicu pekerjaan dengan Get-JobTrigger cmdlet untuk mendapatkan pemicu pekerjaan dari pekerjaan terjadwal yang ada, atau dengan nilai tabel hash untuk mewakili pemicu pekerjaan.

Saat membuat pemicu pekerjaan, tinjau nilai default opsi yang ditentukan oleh New-ScheduledJobOption cmdlet . Opsi ini, yang memiliki nilai valid dan default yang sama dengan opsi terkait di Penjadwal Tugas, memengaruhi penjadwalan dan waktu pekerjaan terjadwal.

New-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: Sekali Jadwal

Contoh ini membuat pemicu pekerjaan untuk memulai pekerjaan terjadwal hanya sekali.

New-JobTrigger -Once -At "1/20/2012 3:00 AM"

New-JobTrigger Cmdlet untuk membuat pemicu pekerjaan yang memulai pekerjaan terjadwal hanya satu kali. Nilai parameter At adalah string yang Windows PowerShell konversi menjadi objek DateTime.

Nilai Pada parameter menyertakan tanggal eksplisit, bukan hanya waktu. Jika tanggal dihilangkan, pemicu akan dibuat dengan tanggal saat ini dan 03.00 waktu, yang kemungkinan mewakili waktu di masa lalu.

Contoh 2: Jadwal Harian

Contoh ini membuat pemicu pekerjaan baru untuk memulai pekerjaan terjadwal setiap hari ketiga.

New-JobTrigger -Daily -At "4:15 AM" -DaysInterval 3

Perintah ini membuat pemicu pekerjaan yang memulai pekerjaan terjadwal setiap 3 hari pada pukul 4:15 pagi.

Karena nilai parameter At tidak menyertakan tanggal, tanggal saat ini digunakan sebagai nilai tanggal dalam objek DateTime . Jika tanggal dan waktu di masa lalu, pekerjaan terjadwal dimulai pada kemunculan berikutnya, yaitu 3 hari kemudian dari nilai Parameter at .

Contoh 3: Jadwal Mingguan

Contoh ini membuat pemicu pekerjaan yang memulai pekerjaan terjadwal setiap minggu keempat pada hari-hari tertentu dalam minggu tersebut.

New-JobTrigger -Weekly -DaysOfWeek Monday, Wednesday, Friday -At "23:00" -WeeksInterval 4

Id Frequency Time                  DaysOfWeek                  Enabled
-- --------- ----                  ----------                  -------
0  Weekly    9/21/2012 11:00:00 PM {Monday, Wednesday, Friday} True

Perintah ini membuat pemicu pekerjaan untuk memulai pekerjaan terjadwal pada hari Senin, Rabu, dan Jumat pukul 23.00 (23.00) setiap 4 minggu.

Anda juga dapat memasukkan nilai parameter DaysOfWeek dalam bilangan bulat, seperti -DaysOfWeek 1, 5.

Contoh 4: Jadwal Masuk

Contoh ini membuat pemicu pekerjaan untuk memulai pekerjaan terjadwal saat masuk dari pengguna tertentu.

New-JobTrigger -AtLogOn -User Domain01\Admin01

Perintah ini membuat pemicu pekerjaan untuk memulai pekerjaan terjadwal setiap kali administrator domain masuk ke komputer.

Contoh 5: Menggunakan Penundaan Acak

Contoh ini membuat pemicu pekerjaan baru dengan penundaan rentang waktu acak.

New-JobTrigger -Daily -At 1:00 -RandomDelay 00:20:00

Perintah ini membuat pemicu pekerjaan untuk memulai pekerjaan terjadwal setiap hari pukul 01.00 di pagi hari. Perintah menggunakan parameter RandomDelay untuk mengatur penundaan maksimum menjadi 20 menit. Akibatnya, pekerjaan berjalan setiap hari antara pukul 01.00 dan 01.20, dengan interval bervariasi secara acak semu.

Anda dapat menggunakan penundaan acak untuk pengambilan sampel, penyeimbangan beban, dan tugas administratif lainnya. Saat mengatur nilai penundaan, tinjau nilai New-ScheduledJobOption efektif dan default cmdlet dan koordinasikan penundaan dengan pengaturan opsi.

Contoh 6: Membuat Pemicu Pekerjaan untuk Pekerjaan Terjadwal Baru

Contoh ini menggunakan pemicu pekerjaan untuk membuat pekerjaan terjadwal baru.

$t = New-JobTrigger -Weekly -DaysOfWeek 1,3,5 -At 12:01AM
Register-ScheduledJob -Name Test-HelpFiles -FilePath C:\Scripts\Test-HelpFiles.ps1 -Trigger $t

Perintah pertama menggunakan New-JobTrigger cmdlet untuk membuat pemicu pekerjaan yang memulai pekerjaan setiap Senin, Rabu, dan Jumat pukul 12.01. Perintah menyimpan pemicu pekerjaan dalam $t variabel .

Perintah kedua menggunakan Register-ScheduledJob cmdlet untuk membuat pekerjaan terjadwal yang memulai pekerjaan setiap Senin, Rabu, dan Jumat pukul 12.01. Nilai parameter Pemicu adalah pemicu yang disimpan dalam $t variabel .

Contoh 7: Menambahkan Pemicu Pekerjaan ke Pekerjaan Terjadwal

Contoh ini menunjukkan cara menambahkan pemicu pekerjaan ke pekerjaan terjadwal yang ada.

Add-JobTrigger -Name SynchronizeApps -Trigger (New-JobTrigger -Daily -At 3:10AM)

Anda dapat menambahkan beberapa pemicu pekerjaan ke pekerjaan terjadwal apa pun.

Perintah menggunakan Add-JobTrigger cmdlet untuk menambahkan pemicu pekerjaan ke pekerjaan terjadwal SynchronizeApps . Nilai parameter Pemicu adalah New-JobTrigger perintah yang menjalankan pekerjaan setiap hari pada pukul 03.10.

Ketika perintah selesai, SynchronizeApps adalah pekerjaan terjadwal yang berjalan pada waktu yang ditentukan oleh pemicu pekerjaan.

Contoh 8: Membuat pemicu pekerjaan berulang

Contoh ini membuat pemicu pekerjaan berulang untuk hanya berjalan selama jangka waktu tertentu.

New-JobTrigger -Once -At "09/12/2013 1:00:00" -RepetitionInterval (New-TimeSpan -Hours 1) -RepetitionDuration (New-Timespan -Hours 48)

Perintah ini membuat pemicu pekerjaan yang menjalankan pekerjaan setiap 60 menit selama 48 jam yang dimulai pada 12 September 2013 pukul 01.00.

Contoh 9: Menghentikan pemicu pekerjaan berulang

Contoh ini menghentikan pemicu pekerjaan berulang.

Get-JobTrigger -Name SecurityCheck | Set-JobTrigger -RepetitionInterval 0:00 -RepetitionDuration 0:00

Perintah ini secara paksa menghentikan pekerjaan SecurityCheck , yang dipicu untuk berjalan setiap 60 menit sampai pemicu pekerjaannya kedaluwarsa.

Untuk mencegah pekerjaan berulang, perintah menggunakan Get-JobTrigger untuk mendapatkan pemicu pekerjaan pekerjaan SecurityCheck dan Set-JobTrigger cmdlet untuk mengubah interval pengulangan dan durasi pengulangan pemicu pekerjaan menjadi nol (0).

Contoh 10: Membuat pemicu pekerjaan per jam

Contoh ini membuat pemicu pekerjaan berulang yang berjalan tanpa batas waktu.

New-JobTrigger -Once -At "9/21/2012 0am" -RepetitionInterval (New-TimeSpan -Hour 12) -RepetitionDuration ([TimeSpan]::MaxValue)

Perintah berikut membuat pemicu pekerjaan yang menjalankan pekerjaan terjadwal setiap 12 jam sekali untuk jangka waktu yang tidak terbatas. Jadwal dimulai besok (21/9/2012) tengah malam (0:00).

Parameter

-At

Memulai pekerjaan pada tanggal dan waktu yang ditentukan. Masukkan objek DateTime , seperti yang Get-Date dikembalikan cmdlet, atau string yang dapat dikonversi menjadi tanggal dan waktu, seperti April 19, 2012 15:00, 12/31, atau 3am. Jika Anda tidak menentukan elemen tanggal, seperti tahun, tanggal dalam pemicu memiliki elemen yang sesuai dari tanggal saat ini.

Saat menggunakan parameter Once , atur nilai parameter At ke tanggal dan waktu mendatang. Karena tanggal default dalam objek DateTime adalah tanggal saat ini, jika Anda menentukan waktu sebelum waktu saat ini tanpa tanggal eksplisit, pemicu pekerjaan dibuat untuk waktu di masa lalu.

Objek DateTime, dan string yang dikonversi ke objek DateTime, secara otomatis disesuaikan agar kompatibel dengan format tanggal dan waktu yang dipilih untuk komputer lokal di Wilayah dan Bahasa di Panel Kontrol.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AtLogOn

Memulai pekerjaan terjadwal ketika pengguna yang ditentukan masuk ke komputer. Untuk menentukan pengguna, gunakan parameter Pengguna .

Type:SwitchParameter
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AtStartup

Memulai pekerjaan terjadwal ketika Windows dimulai.

Type:SwitchParameter
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Daily

Menentukan jadwal pekerjaan harian berulang. Gunakan parameter lain dalam parameter Harian yang diatur untuk menentukan detail jadwal.

Type:SwitchParameter
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DaysInterval

Menentukan jumlah hari antara kemunculan pada jadwal harian. Misalnya, nilai 3 memulai pekerjaan terjadwal pada hari 1, , 47 dan sebagainya. Nilai defaultnya adalah 1.

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

-DaysOfWeek

Menentukan hari dalam seminggu di mana pekerjaan terjadwal mingguan berjalan. Masukkan nama hari, seperti Monday atau bilangan60- bulat , di mana 0 mewakili Hari Minggu. Parameter ini diperlukan dalam kumpulan parameter Mingguan .

Nama hari dikonversi ke nilai bilangan bulatnya dalam pemicu pekerjaan. Saat Anda mengapit nama hari dalam tanda kutip dalam perintah, sertakan setiap nama hari dalam tanda kutip terpisah, seperti "Monday", "Tuesday". Jika Anda mengapit nama beberapa hari dalam satu pasangan tanda kutip, nilai bilangan bulat yang sesuai akan dijumlahkan. Misalnya, "Monday, Tuesday" (1 + 2) menghasilkan nilai Wednesday (3).

Type:DayOfWeek[]
Accepted values:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Once

Menentukan jadwal pengulangan yang tidak berulang (satu kali) atau kustom. Untuk membuat jadwal berulang, gunakan parameter Once dengan parameter RepetitionDuration dan RepetitionInterval .

Type:SwitchParameter
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RandomDelay

Mengaktifkan penundaan acak yang dimulai pada waktu mulai terjadwal, dan mengatur nilai penundaan maksimum. Panjang penundaan diatur secara acak pseudo untuk setiap awal dan bervariasi dari tidak ada penundaan hingga waktu yang ditentukan oleh nilai parameter ini. Nilai default, nol (00:00:00), menonaktifkan penundaan acak.

Masukkan objek rentang waktu, seperti objek yang dikembalikan oleh New-TimeSpan cmdlet, atau masukkan nilai dalam format, yang secara otomatis dikonversi <hours>:<minutes>:<seconds> ke objek TimeSpan .

Type:TimeSpan
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RepeatIndefinitely

Parameter ini, tersedia mulai Windows PowerShell 4.0, menghilangkan kebutuhan menentukan nilai TimeSpan.MaxValue untuk parameter RepetitionDuration untuk menjalankan pekerjaan terjadwal berulang kali, untuk periode yang tidak terbatas.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RepetitionDuration

Mengulangi pekerjaan hingga waktu yang ditentukan kedaluwarsa. Frekuensi pengulangan ditentukan oleh nilai parameter RepetitionInterval . Misalnya, jika nilai RepetitionInterval adalah 5 menit dan nilai RepetitionDuration adalah 2 jam, pekerjaan dipicu setiap lima menit selama dua jam.

Masukkan objek rentang waktu, seperti objek yang New-TimeSpan dikembalikan cmdlet atau string yang dapat dikonversi menjadi objek rentang waktu, seperti 1:05:30.

Untuk menjalankan pekerjaan tanpa batas waktu, tambahkan parameter RepeatIndefinitely sebagai gantinya.

Untuk menghentikan pekerjaan sebelum durasi pengulangan pemicu pekerjaan kedaluwarsa, gunakan Set-JobTrigger cmdlet untuk mengatur nilai RepetitionDuration ke nol (0).

Parameter ini hanya valid ketika parameter Once, At, dan RepetitionInterval digunakan dalam perintah .

Type:TimeSpan
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RepetitionInterval

Mengulangi pekerjaan pada interval waktu yang ditentukan. Misalnya, jika nilai parameter ini adalah 2 jam, pekerjaan dipicu setiap dua jam. Nilai default, 0, tidak mengulangi pekerjaan.

Masukkan objek rentang waktu, seperti objek yang New-TimeSpan dikembalikan cmdlet atau string yang dapat dikonversi menjadi objek rentang waktu, seperti 1:05:30.

Parameter ini hanya valid ketika parameter Sekali, At, dan RepetitionDuration digunakan dalam perintah .

Type:TimeSpan
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-User

Menentukan pengguna yang memicu AtLogon memulai pekerjaan terjadwal. Masukkan nama pengguna dalam <UserName> format atau <Domain\Username> masukkan tanda bintang (*) untuk mewakili semua pengguna. Nilai defaultnya adalah semua pengguna.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Weekly

Menentukan jadwal pekerjaan mingguan berulang. Gunakan parameter lain dalam parameter Mingguan yang diatur untuk menentukan detail jadwal.

Type:SwitchParameter
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WeeksInterval

Menentukan jumlah minggu antara kemunculan pada jadwal pekerjaan mingguan. Misalnya, nilai 3 memulai pekerjaan terjadwal pada minggu 1, , 47 dan sebagainya. Nilai defaultnya adalah 1.

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

Input

None

Anda tidak dapat menyalurkan input ke cmdlet ini.

Output

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Catatan

  • Pemicu pekerjaan tidak disimpan ke disk. Namun, pekerjaan terjadwal disimpan ke disk, dan Anda dapat menggunakan Get-JobTrigger untuk mendapatkan pemicu pekerjaan dari pekerjaan terjadwal apa pun.

  • New-JobTrigger tidak mencegah Anda membuat pemicu pekerjaan yang tidak akan menjalankan pekerjaan terjadwal, seperti pemicu satu kali untuk tanggal di masa lalu.

  • Register-ScheduledJob Cmdlet menerima objek ScheduledJobTrigger, seperti yang dikembalikan oleh New-JobTrigger cmdlet atau Get-JobTrigger , atau tabel hash dengan nilai pemicu.

    Untuk mengirimkan tabel hash, gunakan kunci berikut.

    • Frekuensi: Once, Daily, Weekly, AtStartup, atau AtLogon
    • Pada: string waktu yang valid, seperti 3am
    • DaysOfWeek: kombinasi nama hari apa pun sebagai string, seperti "Monday", "Wednesday"
    • Interval: interval frekuensi yang valid sebagai bilangan bulat
    • RandomDelay: string rentang waktu yang valid, seperti 30minutes
    • Pengguna: setiap pengguna yang valid, seperti Domain1\User01; hanya digunakan dengan nilai frekuensi AtLogon