Share via

kelas Win32_ScheduledJob

  • Artikel

Kelas WMI Win32_ScheduledJob mewakili pekerjaan yang dibuat dengan perintah AT.

Catatan

Kelas Win32_ScheduledJob tidak mewakili pekerjaan yang dibuat dengan Wizard Tugas Terjadwal dari Panel Kontrol. Anda tidak dapat mengubah tugas yang dibuat oleh WMI di UI Tugas Terjadwal. Untuk informasi lebih lanjut, lihat bagian Keterangan.

 

Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti dan metode dalam urutan alfabet, bukan urutan MOF.

Sintaks

[Dynamic, Provider("CIMWin32"), UUID("{8502C4E0-5FBB-11D2-AAC1-006008C78BC7}"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("Delete"), AMENDMENT]
class Win32_ScheduledJob : CIM_Job
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  datetime ElapsedTime;
  string   Notify;
  string   Owner;
  uint32   Priority;
  datetime TimeSubmitted;
  datetime UntilTime;
  string   Command;
  uint32   DaysOfMonth;
  uint32   DaysOfWeek;
  boolean  InteractWithDesktop;
  uint32   JobId;
  string   JobStatus;
  boolean  RunRepeatedly;
  datetime StartTime;
};

Anggota

Kelas Win32_ScheduledJob memiliki jenis anggota ini:

Metode

Kelas Win32_ScheduledJob memiliki metode ini.

Metode Deskripsi
Membuat Metode kelas yang mengirimkan pekerjaan ke sistem operasi untuk dieksekusi pada waktu dan tanggal mendatang yang ditentukan.
Hapus Metode kelas yang menghapus pekerjaan terjadwal.

 

Properti

Kelas Win32_ScheduledJob memiliki properti ini.

Keterangan

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: MaxLen (64), DisplayName ("Keterangan")

Deskripsi tekstual singkat dari objek .

Properti ini diwarisi dari CIM_ManagedSystemElement.

Perintah

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("Win32API| Struktur Manajemen Jaringan| | AT_INFO Perintah")

Nama perintah, program batch, atau file biner (dan argumen baris perintah) yang digunakan layanan jadwal untuk memanggil pekerjaan.

Contoh: "defrag/q/f"

DaysOfMonth

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("Win32API| Struktur Manajemen Jaringan| | AT_INFO DaysOfMonth")

Hari dalam sebulan ketika pekerjaan dijadwalkan untuk dijalankan. Jika pekerjaan dijadwalkan untuk berjalan pada beberapa hari dalam sebulan, nilai-nilai ini dapat digabungkan dalam OR logis. Misalnya, jika pekerjaan dijalankan pada tanggal 1 dan 16 setiap bulan, nilai properti DaysOfMonth adalah 1 ATAU 32768.

1 (1)

1st

2 (2)

Ke-2

3 (4)

Ke-3

4 (8)

Ke-4

5 (16)

Ke-5

6 (32)

Ke-6

7 (64)

Ke-7

8 (128)

Ke-8

9 (256)

Ke-9

10 (512)

Ke-10

11 (1024)

Ke-11

12 (2048)

Ke-12

13 (4096)

Ke-13

14 (8192)

Ke-14

15 (16384)

Ke-15

16 (32768)

Ke-16

17 (65536)

Ke-17

18 (131072)

Ke-18

19 (262144)

Ke-19

20 (524288)

Ke-20

21 (1048576)

Ke-21

22 (2097152)

Ke-22

23 (4194304)

Ke-23

24 (8388608)

Ke-24

25 (16777216)

Ke-25

26 (33554432)

Ke-26

27 (67108864)

Ke-27

28 (134217728)

Ke-28

29 (268435456)

Ke-29

30 (536870912)

Ke-30

31 (1073741824)

Ke-31

DaysOfWeek

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("Win32API| Struktur Manajemen Jaringan| | AT_INFO DaysOfWeek")

Hari dalam seminggu ketika pekerjaan dijadwalkan untuk dijalankan. Jika pekerjaan dijadwalkan untuk berjalan pada beberapa hari dalam seminggu, nilai dapat digabungkan dalam OR logis. Misalnya, jika pekerjaan dijadwalkan untuk berjalan pada hari Senin, Rabu, dan Jumat, nilai properti DaysOfWeek adalah 1 ATAU 4 ATAU 16.

Senin (1)

Selasa (2)

Rabu (4)

Kamis (8)

Jumat (16)

Sabtu (32)

Minggu (64)

Deskripsi

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: DisplayName ("Description")

Deskripsi tekstual objek.

Properti ini diwarisi dari CIM_ManagedSystemElement.

ElapsedTime

Jenis data: tanggalwaktu

Jenis akses: Baca-saja

Lamanya waktu pekerjaan telah dijalankan.

Properti ini diwarisi dari CIM_Job.

InstallDate

Jenis data: tanggalwaktu

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Tanggal Penginstalan")

Menunjukkan kapan objek diinstal. Kurangnya nilai tidak menunjukkan bahwa objek tidak diinstal.

Properti ini diwarisi dari CIM_ManagedSystemElement.

InteractWithDesktop

Jenis data: boolean

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("Win32API| Struktur Manajemen Jaringan| | AT_INFO Bendera|JOB_NONINTERACTIVE")

Pekerjaan yang ditentukan bersifat interaktif, yang berarti bahwa pengguna dapat memberikan input ke pekerjaan terjadwal saat dijalankan.

JobId

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: Kunci, MappingStrings ("Win32API| Struktur Manajemen Jaringan| | AT_ENUM JobId")

Mengidentifikasi jumlah pekerjaan. Ini digunakan oleh metode sebagai handel untuk satu pekerjaan yang dijadwalkan pada komputer ini.

JobStatus

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: Mengambil alih ("JobStatus"), MappingStrings ("Win32API| Struktur Manajemen Jaringan| | AT_ENUM Bendera|JOB_EXEC_ERROR")

Status eksekusi terakhir kali pekerjaan ini dijadwalkan untuk dijalankan.

Sukses ("Berhasil")

Kegagalan ("Kegagalan")

Nama

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: DisplayName ("Name")

Label tempat objek diketahui. Ketika disubkelas, properti ini dapat diganti menjadi properti kunci.

Properti ini diwarisi dari CIM_ManagedSystemElement.

Beri tahu

Jenis data: string

Jenis akses: Baca-saja

Pengguna diberi tahu setelah penyelesaian pekerjaan atau kegagalan.

Properti ini diwarisi dari CIM_Job.

Pemilik

Jenis data: string

Jenis akses: Baca-saja

Pengguna yang mengirimkan pekerjaan.

Properti ini diwarisi dari CIM_Job.

Prioritas

Jenis data: uint32

Jenis akses: Baca-saja

Pentingnya eksekusi pekerjaan.

Properti ini diwarisi dari CIM_Job.

RunRepeatedly

Jenis data: boolean

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("Win32API| Struktur Manajemen Jaringan| | AT_INFO Bendera|JOB_RUN_PERIODICALLY")

Pekerjaan terjadwal berjalan berulang kali pada hari-hari pekerjaan dijadwalkan. Jika False, maka pekerjaan dijalankan satu kali.

StartTime

Jenis data: tanggalwaktu

Jenis akses: Baca-saja

Kualifikasi: Mengambil alih ("StartTime"), MappingStrings ("Win32API| Struktur Manajemen Jaringan| | AT_ENUM JobTime")

Waktu UTC untuk menjalankan pekerjaan, dalam bentuk "YYYYMMDDHHMMSS. MMMMMM(+-)OOO", di mana "YYYYMMDD" harus digantikan oleh "********". Penggantian diperlukan karena layanan penjadwalan hanya memungkinkan pekerjaan dikonfigurasi untuk berjalan satu kali, atau berjalan pada hari dalam sebulan atau minggu. Pekerjaan tidak dapat dijalankan pada tanggal tertentu.

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 .

Misalnya: "********123000.000000-420" menentukan 14.30 (2:30 P.M.) PST dengan waktu musim panas berlaku.

Status

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: MaxLen (10), DisplayName ("Status")

String yang menunjukkan status objek saat ini. Status operasional dan non-operasional dapat ditentukan. Status operasional dapat mencakup "OK", "Degraded", dan "Pred Fail". "Pred Fail" menunjukkan bahwa elemen berfungsi dengan baik, tetapi memprediksi kegagalan (misalnya, hard disk drive berkemampuan SMART).

Status non-operasional dapat mencakup "Error", "Starting", "Stopping", dan "Service". "Layanan" dapat berlaku selama resilvering cermin disk, memuat ulang daftar izin pengguna, atau pekerjaan administratif lainnya. Tidak semua pekerjaan seperti itu online, tetapi elemen terkelola tidak "OK" atau di salah satu status lainnya.

Properti ini diwarisi dari CIM_ManagedSystemElement.

Nilai yang valid mencakup sebagai berikut:

OK ("OK")

Kesalahan ("Kesalahan")

Terdegradasi ("Terdegradasi")

Tidak diketahui ("Tidak Diketahui")

Pred Fail ("Pred Fail")

Memulai ("Memulai")

Menghentikan ("Berhenti")

Layanan ("Layanan")

Stres ("Stres")

NonRecover ("NonRecover")

Tidak Ada Kontak ("Tidak Ada Kontak")

Lost Comm ("Lost Comm")

TimeSubmitted

Jenis data: tanggalwaktu

Jenis akses: Baca-saja

Waktu pekerjaan dikirimkan.

Properti ini diwarisi dari CIM_Job.

UntilTime

Jenis data: tanggalwaktu

Jenis akses: Baca-saja

Waktu di mana pekerjaan tidak valid atau harus dihentikan.

Properti ini diwarisi dari CIM_Job.

Keterangan

Setiap pekerjaan yang dijadwalkan terhadap layanan jadwal disimpan secara persisten (penjadwal dapat memulai pekerjaan setelah reboot), dan dijalankan pada waktu dan hari yang ditentukan dalam seminggu atau bulan. Jika komputer tidak aktif, atau jika layanan terjadwal tidak berjalan pada waktu pekerjaan yang ditentukan, layanan jadwal menjalankan pekerjaan yang ditentukan pada hari berikutnya pada waktu yang ditentukan.

Pekerjaan dijadwalkan sesuai dengan Waktu Universal Terkoordinasi (UTC) dengan offset bias dari Greenwich Mean Time (GMT), yang berarti bahwa pekerjaan dapat ditentukan menggunakan zona waktu apa pun. Kelas Win32_ScheduledJob mengembalikan waktu lokal dengan offset UTC saat menghitung objek, dan dikonversi ke waktu lokal saat membuat pekerjaan baru. Misalnya, pekerjaan yang ditentukan untuk berjalan di komputer di Boston pada pukul 22.30 Senin waktu PST akan dijadwalkan untuk berjalan secara lokal pada pukul 01.30 Selasa EST.

Catatan

Klien harus mempertimbangkan apakah waktu musim panas beroperasi di komputer lokal atau tidak, dan jika ya, maka kurangi bias 60 menit dari offset UTC.

 

Kelas Win32_ScheduledJob berasal dari CIM_Job. Anda harus menjadi anggota grup administrator untuk membuat pekerjaan terjadwal menggunakan kelas ini.

Kelas Win32_ScheduledJob secara internal menggunakan protokol AT, yang terikat pada penghentian yang dimulai dengan Windows 8 dan Windows Server 2012. Sebagai langkah pertama, protokol AT dinonaktifkan secara default. Jika protokol dinonaktifkan, misalnya memanggil metode Buat pada objek Win32_ScheduledJob akan gagal dengan kesalahan 0x8. Anda dapat mengaktifkan kembali protokol AT dengan menambahkan entri registri berikut:

Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Schedule\Configuration 
Name: EnableAt 
Type: REG_DWORD
Value: 1

Anda mungkin perlu menghidupkan ulang komputer untuk membuat pengaturan efektif.

Karena Win32_ScheduledJob didasarkan pada NETScheduleJobGetInfo Win32 API, Anda tidak dapat menggunakan kelas ini bersama dengan Task Scheduler. Jika Anda ingin menggunakan Task Scheduler, gunakan TASK Scheduler API. Untuk informasi selengkapnya, lihat Referensi Penjadwal Tugas.

Contoh

Contoh kode VBScript berikut menjadwalkan Notepad.exe untuk berjalan secara interaktif pada pukul 1:25 oleh waktu komputer lokal setiap hari Rabu.

strComputer = "."
Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\Root\CIMv2")
Set objNewJob = objWMIService.Get("Win32_ScheduledJob")
errJobCreated = objNewJob.Create("Notepad.exe", "********012500.000000-420", True , 4, , True, JobId) 
If errJobCreated <> 0 Then
Wscript.Echo "Error on task creation"
Else
Wscript.Echo "Task created"
End If

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

CIM_Job

Kelas Sistem Operasi

Tugas WMI: Tugas Terjadwal