Membuat metode kelas Win32_ScheduledJob
Metode buatkelas WMI mengirimkan pekerjaan ke sistem operasi untuk dieksekusi pada waktu dan tanggal tertentu di masa mendatang. Metode ini mengharuskan layanan jadwal dimulai pada komputer tempat pekerjaan dikirimkan.
Topik ini menggunakan sintaks Managed Object Format (MOF). Untuk informasi selengkapnya tentang menggunakan metode ini, lihat Memanggil Metode.
Sintaks
uint32 Create(
[in] string Command,
[in] datetime StartTime,
[in, optional] boolean RunRepeatedly,
[in, optional] uint32 DaysOfWeek,
[in, optional] uint32 DaysOfMonth,
[in, optional] boolean InteractWithDesktop,
[out] uint32 JobId
);
Parameter
-
Perintah [in]
-
Nama perintah, program batch, atau file biner dan parameter baris perintah yang digunakan layanan jadwal untuk memanggil pekerjaan.
Contoh: "defrag /q /f".
-
StartTime [in]
-
Waktu Waktu Universal Terkoordinasi (UTC) untuk menjalankan pekerjaan. Formulir harus: "YYYYMMDDHHMMSS. MMMMMM(+-)OOO", di mana "YYYYMMDD" harus digantikan oleh "********". Misalnya: "******143000.000000-420" menentukan 14.30 (2:30 P.M.) PST dengan waktu musim panas berlaku.
Bagian "(+-)OOO" dari nilai properti StartTime adalah bias saat ini untuk terjemahan waktu lokal. Bias adalah perbedaan antara waktu UTC dan waktu setempat. Untuk menghitung bias untuk zona waktu Anda, kalikan jumlah jam zona waktu Anda di depan atau di belakang Greenwich Mean Time (GMT) dengan 60 (gunakan angka positif untuk jumlah jam jika zona waktu Anda lebih awal dari GMT dan angka negatif jika zona waktu Anda berada di belakang GMT). Tambahkan 60 tambahan ke perhitungan Anda jika zona waktu Anda menggunakan waktu musim panas. Misalnya, zona Waktu Standar Pasifik adalah delapan jam di belakang GMT, oleh karena itu bias sama dengan -420 (-8 * 60 + 60) ketika waktu musim panas sedang digunakan dan -480 (-8 * 60) ketika waktu musim panas tidak digunakan. Anda juga dapat menentukan nilai bias dengan mengkueri properti bias dari kelas Win32_TimeZone .
-
RunRepeatedly [in, opsional]
-
Jika True, pekerjaan terjadwal berjalan berulang kali pada hari-hari tertentu. Defaultnya adalah False.
-
DaysOfWeek [in, opsional]
-
Hari dalam seminggu ketika pekerjaan dijadwalkan untuk dijalankan; hanya digunakan ketika parameter RunRepeatedly adalah True. Untuk menjadwalkan pekerjaan selama lebih dari satu hari dalam seminggu, gabungkan nilai yang sesuai dalam OR logis. Misalnya, untuk menjadwalkan pekerjaan untuk Selasa dan Jumat, nilai DaysOfWeek adalah 2 ATAU 16.
-
Senin (1)
-
Selasa (2)
-
Rabu (4)
-
Kamis (8)
-
Jumat (16)
-
Sabtu (32)
-
Minggu (64)
DaysOfMonth [in, opsional]
Hari dalam sebulan ketika pekerjaan dijadwalkan untuk dijalankan; hanya digunakan ketika parameter RunRepeatedly adalah True.
1 (1)
Hari ke-1 dalam sebulan
2 (2)
Hari ke-2 dalam sebulan
3 (4)
Hari ke-3 dalam sebulan
4 (8)
Hari ke-4 dalam sebulan
5 (16)
Hari ke-5 dalam sebulan
6 (32)
Hari ke-6 dalam sebulan
7 (64)
Hari ke-7 dalam sebulan
8 (128)
Hari ke-8 dalam sebulan
9 (256)
Hari ke-9 dalam sebulan
10 (512)
Hari ke-10 dalam sebulan
11 (1024)
Hari ke-11 dalam sebulan
12 (2048)
Hari ke-12 dalam sebulan
13 (4096)
Hari ke-13 dalam sebulan
14 (8192)
Hari ke-14 dalam sebulan
15 (16384)
Hari ke-15 dalam sebulan
16 (32768)
Hari ke-16 dalam sebulan
17 (65536)
Hari ke-17 dalam sebulan
18 (131072)
Hari ke-18 dalam sebulan
19 (262144)
Hari ke-19 dalam sebulan
20 (524288)
Hari ke-20 dalam sebulan
21 (1048576)
Hari ke-21 dalam sebulan
22 (2097152)
Hari ke-22 dalam sebulan
23 (4194304)
Hari ke-23 dalam sebulan
24 (8388608)
Hari ke-24 dalam sebulan
25 (16777216)
Hari ke-25 dalam sebulan
26 (33554432)
Hari ke-26 dalam sebulan
27 (67108864)
Hari ke-27 dalam sebulan
28 (134217728)
Hari ke-28 dalam sebulan
29 (268435456)
Hari ke-29 dalam sebulan
30 (536870912)
Hari ke-30 dalam sebulan
31 (1073741824)
Hari ke-31 dalam sebulan
InteractWithDesktop [in, opsional]
Jika True, pekerjaan yang ditentukan harus interaktif, yang berarti bahwa pengguna dapat memberikan input ke pekerjaan terjadwal saat pekerjaan dijalankan. Defaultnya adalah False.
JobId [out]
Nomor pengidentifikasi pekerjaan. Parameter ini adalah handel untuk pekerjaan yang dijadwalkan pada komputer.
Mengembalikan nilai
Mengembalikan nilai 0 (nol) saat berhasil, dan angka yang berbeda untuk menunjukkan kesalahan. Untuk kode kesalahan tambahan, lihat Konstanta Kesalahan WMI atau WbemErrorEnum. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.
-
Penyelesaian berhasil
-
0
Permintaan diterima.
-
Tidak didukung
-
1
Permintaan tidak didukung.
-
Akses ditolak
-
2
Pengguna tidak memiliki akses yang diperlukan.
-
Kegagalan tidak diketahui
-
8
Proses interaktif.
-
Jalur tidak ditemukan
-
9
Jalur direktori ke file yang dapat dieksekusi layanan tidak dapat ditemukan.
-
Parameter tidak valid
-
21
Parameter yang tidak valid telah diteruskan ke layanan.
-
Layanan tidak dimulai
-
22
Akun yang dijalankan layanan ini tidak valid atau tidak memiliki izin untuk menjalankan layanan.
-
Lainnya
-
23 4294967295
Keterangan
Jika pekerjaan terjadwal Anda memulai program interaktif seperti Notepad, properti InteractWithDeskto harus diatur ke True atau layar program tidak terlihat. Proses masih muncul di Task Manager meskipun tidak muncul di layar.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista |
Server minimum yang didukung |
Windows Server 2008 |
Ruang nama |
Root\CIMV2 |
MOF |
|
DLL |
|