Bagikan melalui

New-JobTrigger

Modul:
PSScheduledJob Module

Membuat pemicu pekerjaan untuk pekerjaan terjadwal.

Sintaks

Once (Default) 

New-JobTrigger
    -At <DateTime>
    [-RandomDelay <TimeSpan>]
    [-Once]
    [-RepetitionInterval <TimeSpan>]
    [-RepetitionDuration <TimeSpan>]
    [-RepeatIndefinitely]
    [<CommonParameters>]

Daily 

New-JobTrigger
    -At <DateTime>
    [-DaysInterval <Int32>]
    [-RandomDelay <TimeSpan>]
    [-Daily]
    [<CommonParameters>]

Weekly 

New-JobTrigger
    -At <DateTime>
    -DaysOfWeek <DayOfWeek[]>
    [-WeeksInterval <Int32>]
    [-RandomDelay <TimeSpan>]
    [-Weekly]
    [<CommonParameters>]

AtStartup 

New-JobTrigger
    [-RandomDelay <TimeSpan>]
    [-AtStartup]
    [<CommonParameters>]

AtLogon 

New-JobTrigger
    [-RandomDelay <TimeSpan>]
    [-User <String>]
    [-AtLogOn]
    [<CommonParameters>]

Deskripsi

cmdlet New-JobTrigger 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 cmdlet Get-JobTrigger 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 cmdlet New-ScheduledJobOption. Opsi ini, yang memiliki nilai valid dan default yang sama dengan opsi yang sesuai di Task Scheduler, 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"

cmdlet New-JobTrigger untuk membuat pemicu pekerjaan yang memulai pekerjaan terjadwal hanya satu kali. Nilai parameter Pada adalah string yang dikonversi Windows PowerShell menjadi objek DateTime .

Nilai parameter Pada mencakup 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 3

Perintah ini membuat pemicu pekerjaan yang memulai pekerjaan terjadwal setiap 3 hari pada pukul 04.15.

Karena nilai parameter Pada 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 Pada.

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} 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 efektif dan default cmdlet New-ScheduledJobOption 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 cmdlet New-JobTrigger 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 cmdlet Register-ScheduledJob untuk membuat pekerjaan terjadwal yang memulai pekerjaan setiap Senin, Rabu, dan Jumat pukul 12.01. Nilai parameter Pemicu adalah pemicu yang disimpan dalam variabel $t.

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 cmdlet Add-JobTrigger untuk menambahkan pemicu pekerjaan ke pekerjaan terjadwal SynchronizeApps. Nilai parameter Pemicu adalah perintah New-JobTrigger 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.

$newJobTriggerSplat = @{
    Once = -Once
    At = "09/12/2013 1:00:00"
    RepetitionInterval = (New-TimeSpan -Hours 1)
    RepetitionDuration = (New-TimeSpan -Hours 48)
}
New-JobTrigger @newJobTriggerSplat

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 dari pekerjaan SecurityCheck dan cmdlet Set-JobTrigger 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.

$newJobTriggerSplat = @{
    Once = -Once
    At = "9/21/2012 0am"
    RepetitionInterval = (New-TimeSpan -Hour 12)
    RepetitionDuration = ([timespan]::MaxValue)
}
New-JobTrigger @newJobTriggerSplat

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 dikembalikan cmdlet Get-Date, atau string yang dapat dikonversi ke 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 Pada 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.

Properti parameter

Jenis:DateTime
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

Once
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
Daily
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False
Weekly
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-AtLogOn

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

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

AtLogon
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-AtStartup

Memulai pekerjaan terjadwal ketika Windows dimulai.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

AtStartup
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Daily

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

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

Daily
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

Daily
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-DaysOfWeek

Menentukan hari dalam seminggu tempat pekerjaan terjadwal mingguan berjalan. Masukkan nama hari, seperti Monday atau bilangan bulat 0-6, 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).

Properti parameter

Jenis:

DayOfWeek[]

Nilai default:None
Nilai yang diterima:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Mendukung wildcard:False
DontShow:False

Set parameter

Weekly
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Once

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

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

Once
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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 cmdlet New-TimeSpan, atau masukkan nilai dalam format <hours>:<minutes>:<seconds>, yang secara otomatis dikonversi ke objek TimeSpan.

Properti parameter

Jenis:TimeSpan
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

Once
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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 cmdlet Set-JobTrigger untuk mengatur nilai Pengulangan ke nol (0).

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

Properti parameter

Jenis:TimeSpan
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

Once
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:TimeSpan
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

Once
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

AtLogon
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Weekly

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

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

Weekly
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:Int32
Nilai default:None
Mendukung wildcard:False
DontShow:False

Set parameter

Weekly
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

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-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.

  • Cmdlet Register-ScheduledJob menerima objek ScheduledJobTrigger, seperti yang dikembalikan oleh cmdlet New-JobTrigger 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