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	CIMWin32.mof
DLL	CIMWin32.dll

Lihat juga

Kelas Sistem Operasi

Win32_ScheduledJob