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 ketika 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 yang sesuai di Penjadwal Tugas, memengaruhi penjadwalan dan waktu pekerjaan terjadwal.
New-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: Jadwal Sekali
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 dikonversi Windows PowerShell menjadi objek DateTime .
Nilai Pada parameter menyertakan tanggal eksplisit, bukan hanya waktu. Jika tanggal dihilangkan, pemicu akan dibuat dengan tanggal saat ini dan pukul 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 3Perintah ini membuat pemicu pekerjaan yang memulai pekerjaan terjadwal setiap 3 hari pada pukul 04.15.
Karena nilai parameter At tidak menyertakan tanggal, tanggal saat ini digunakan sebagai nilai tanggal dalam objek DateTime . Jika tanggal dan waktu ada 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 yang ditentukan 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} TruePerintah 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\Admin01Perintah 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:00Perintah 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 $tPerintah 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 saat 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:00Perintah 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 Get-Date yang dikembalikan cmdlet, atau string yang dapat dikonversi ke tanggal dan waktu, seperti April 19, 2012 15:00, , 12/31atau 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 dalam Panel Kontrol.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AtStartup
Memulai pekerjaan terjadwal ketika Windows dimulai.
| Type: | SwitchParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| 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 |
| Required: | True |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DaysOfWeek
Menentukan hari dalam seminggu tempat pekerjaan terjadwal mingguan berjalan. Masukkan nama hari, seperti Monday atau bilangan60- bulat , di mana 0 mewakili Hari Minggu. Parameter ini diperlukan dalam set 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 beberapa nama 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 |
| Required: | True |
| 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 |
| Required: | True |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RepeatIndefinitely
Parameter ini, tersedia mulai dari Windows PowerShell 4.0, menghilangkan keharusan 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 |
| Required: | False |
| 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 ke 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 |
| Required: | False |
| 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 ke objek rentang waktu, seperti 1:05:30.
Parameter ini hanya valid ketika parameter Once, At, dan RepetitionDuration digunakan dalam perintah .
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | True |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.
Output
Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger
Cmdlet ini mengembalikan objek ScheduledJobTrigger yang mewakili pemicu yang dibuat.
Catatan
Pemicu pekerjaan tidak disimpan ke disk. Namun, pekerjaan terjadwal disimpan ke disk, dan Anda dapat menggunakan
Get-JobTriggeruntuk mendapatkan pemicu pekerjaan dari pekerjaan terjadwal apa pun.New-JobTriggertidak mencegah Anda membuat pemicu pekerjaan yang tidak akan menjalankan pekerjaan terjadwal, seperti pemicu satu kali untuk tanggal di masa lalu.Register-ScheduledJobCmdlet menerima objek ScheduledJobTrigger, seperti yang dikembalikan olehNew-JobTriggercmdlet atauGet-JobTrigger, atau tabel hash dengan nilai pemicu.Untuk mengirimkan tabel hash, gunakan kunci berikut.
- Frekuensi:
Once, ,WeeklyDaily,AtStartup, atauAtLogon - 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
- Frekuensi:
Link Terkait
- Add-JobTrigger
- Disable-JobTrigger
- Disable-ScheduledJob
- Enable-JobTrigger
- Enable-ScheduledJob
- Get-JobTrigger
- Get-ScheduledJob
- Get-ScheduledJobOption
- New-JobTrigger
- New-ScheduledJobOption
- Register-ScheduledJob
- Remove-JobTrigger
- Set-JobTrigger
- Set-ScheduledJob
- Set-ScheduledJobOption
- Unregister-ScheduledJob
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk