classe Win32_ScheduledJob

  • Articolo

La classe WMIWin32_ScheduledJob rappresenta un processo creato con il comando AT.

Nota

La classe Win32_ScheduledJob non rappresenta un processo creato con la Creazione guidata attività pianificata dall'Pannello di controllo. Non è possibile modificare un'attività creata da WMI nell'interfaccia utente attività pianificata. Per altre informazioni, vedere la sezione Osservazioni.

 

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà e i metodi sono in ordine alfabetico, non in ordine MOF.

Sintassi

[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;
};

Members

La classe Win32_ScheduledJob include questi tipi di membri:

Metodi

La classe Win32_ScheduledJob include questi metodi.

Metodo Descrizione
Creare Metodo di classe che invia un processo al sistema operativo per l'esecuzione in un'ora e una data futura specificati.
Elimina Metodo di classe che elimina un processo pianificato.

 

Proprietà

La classe Win32_ScheduledJob include queste proprietà.

Didascalia

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64), DisplayName ("Didascalia")

Breve descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Comando

Tipo di dati: stringa

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di gestione della rete | | AT_INFO Comando")

Nome del comando, del programma batch o del file binario (e degli argomenti della riga di comando) usati dal servizio di pianificazione per richiamare il processo.

Esempio: "defrag/q/f"

DaysOfMonth

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di gestione della rete | | AT_INFO DaysOfMonth")

Giorni del mese in cui il processo è pianificato per l'esecuzione. Se un processo è pianificato per l'esecuzione in più giorni del mese, questi valori possono essere aggiunti a un or logico. Ad esempio, se un processo deve essere eseguito il 1° e il 16° mese, il valore della proprietà DaysOfMonth sarà 1 OR 32768.

1 (1 )

1°

2 (2 )

2°

3 (4)

3°

4 (8)

4°

5 (16)

5°

6 (32)

6°

7 (64)

7°

8 (128)

8°

9 (256)

9°

10 (512 )

10°

11 (1024)

11°

12 (2048)

12°

13 (4096)

13°

14 (8192 )

14°

15 (16384)

15°

16 (32768)

16°

17 (65536)

17°

18 (131072)

18°

19 (262144)

19°

20 (524288)

20°

21 (1048576)

21°

22 (2097152)

22°

23 (4194304)

23°

24 (8388608)

24°

25 (16777216)

25°

26 (33554432)

26°

27 (67108864)

27°

28 (134217728)

28°

29 (268435456)

29th

30 (536870912)

30°

31 (1073741824)

31°

DaysOfWeek

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di gestione di rete | | AT_INFO DaysOfWeek")

Giorni della settimana in cui viene pianificato l'esecuzione di un processo. Se un processo è pianificato per l'esecuzione in più giorni della settimana, i valori possono essere uniti in un or logico. Ad esempio, se un processo è pianificato per l'esecuzione di lunedì, mercoledì e venerdì, il valore della proprietà DaysOfWeek sarà 1 O 4 O 16.

Lunedì (1)

Martedì (2)

Mercoledì (4)

Giovedì (8)

Venerdì (16)

Sabato (32)

Domenica (64)

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Description")

Descrizione testuale dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

ElapsedTime

Tipo di dati: datetime

Tipo di accesso: sola lettura

Durata dell'esecuzione del processo.

Questa proprietà viene ereditata da CIM_Job.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data di installazione")

Indica quando l'oggetto è stato installato. La mancanza di un valore non indica che l'oggetto non è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

InteractWithDesktop

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di gestione di rete | | AT_INFO Bandiere|JOB_NONINTERACTIVE")

Il processo specificato è interattivo, il che significa che un utente può fornire input a un processo pianificato durante l'esecuzione.

Jobid

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: Chiave, MappingStrings ("Win32API| Strutture di gestione di rete | | AT_ENUM JobId")

Identificazione del numero del processo. Viene usato dai metodi come handle per un processo pianificato in questo computer.

Stato processo

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Override ("JobStatus"), MappingStrings ("Win32API| Strutture di gestione di rete | | AT_ENUM Bandiere|JOB_EXEC_ERROR")

Stato dell'esecuzione l'ultima volta che il processo è stato pianificato per l'esecuzione.

Operazione riuscita ("Operazione riuscita")

Errore ("Errore ")

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Name")

Etichetta in base alla quale l'oggetto è noto. Quando viene sottoclassata, è possibile eseguire l'override di questa proprietà come proprietà chiave.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Notificare

Tipo di dati: string

Tipo di accesso: sola lettura

L'utente riceve una notifica al completamento o all'esito negativo del processo.

Questa proprietà viene ereditata da CIM_Job.

Proprietario

Tipo di dati: string

Tipo di accesso: sola lettura

Utente che ha inviato il processo.

Questa proprietà viene ereditata da CIM_Job.

Priorità

Tipo di dati: uint32

Tipo di accesso: sola lettura

Importanza dell'esecuzione di un processo.

Questa proprietà viene ereditata da CIM_Job.

RunRepeatedly

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API| Strutture di gestione di rete | | AT_INFO Bandiere|JOB_RUN_PERIODICALLY")

Il processo pianificato viene eseguito ripetutamente nei giorni in cui è pianificato il processo. Se False, il processo viene eseguito una sola volta.

StartTime

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: Override ("StartTime"), MappingStrings ("Win32API| Strutture di gestione di rete | | AT_ENUM JobTime")

Ora UTC per eseguire il processo, sotto forma di "AAAAMMGGHHMMSS. MMMMMM(+-)OOO", dove "AAAAMMGG" deve essere sostituito da "_____!". La sostituzione è necessaria perché il servizio di pianificazione consente di configurare solo i processi per l'esecuzione una sola volta o l'esecuzione in un giorno del mese o della settimana. Un processo non può essere eseguito in una data specifica.

La sezione "(+-)OOO" del valore della proprietà StartTime è la distorsione corrente per la traduzione dell'ora locale. La distorsione è la differenza tra l'ora UTC e l'ora locale. Per calcolare la distorsione per il fuso orario, moltiplicare il numero di ore che il fuso orario è in anticipo o dietro l'ora di Greenwich (GMT) per 60 (usare un numero positivo per il numero di ore se il fuso orario è in anticipo GMT e un numero negativo se il fuso orario è dietro GMT). Aggiungere altri 60 al calcolo se il fuso orario usa l'ora legale. Ad esempio, il fuso orario standard del Pacifico è di otto ore dietro gmt, pertanto la distorsione è uguale a -420 (-8 * 60 + 60) quando l'ora legale è in uso e -480 (-8 * 60) quando l'ora legale non è in uso. È anche possibile determinare il valore della distorsione eseguendo una query sulla proprietà bias della classe Win32_TimeZone .

Ad esempio: "_____123000.00000-420" specifica 14.30 (2:30 P.M.) PST con ora legale in vigore.

Status

Tipo di dati: string

Tipo di accesso: sola lettura

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

Stringa che indica lo stato corrente dell'oggetto. È possibile definire lo stato operativo e non operativo. Lo stato operativo può includere "OK", "Degraded" e "Pred Fail". "Pred Fail" indica che un elemento funziona correttamente, ma prevede un errore (ad esempio, un disco rigido abilitato per SMART).

Lo stato non operativo può includere "Error", "Starting", "Arresta" e "Servizio". "Servizio" può essere applicato durante il mirror-resilvering del disco, ricaricando un elenco di autorizzazioni utente o altri lavori amministrativi. Non tutti questi lavori sono online, ma l'elemento gestito non è "OK" né in uno degli altri stati.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK ")

Errore ("Errore")

Degradato ("degradato ")

Sconosciuto ("sconosciuto ")

Pred Fail ("Pred Fail ")

Avvio ("Avvio ")

Arresto ("Arresto")

Servizio ("Servizio ")

Sottolineato ("stressato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

TimeSubmitted

Tipo di dati: datetime

Tipo di accesso: sola lettura

Ora di invio del processo.

Questa proprietà viene ereditata da CIM_Job.

UntilTime

Tipo di dati: datetime

Tipo di accesso: sola lettura

Ora in cui il processo non è valido o deve essere arrestato.

Questa proprietà viene ereditata da CIM_Job.

Commenti

Ogni processo pianificato rispetto al servizio di pianificazione viene archiviato in modo permanente (l'utilità di pianificazione può avviare un processo dopo un riavvio) e viene eseguito all'ora e al giorno specificato della settimana o del mese. Se il computer non è attivo o se il servizio pianificato non è in esecuzione al momento del processo specificato, il servizio di pianificazione esegue il processo specificato al giorno successivo al momento specificato.

I processi vengono pianificati in base all'ora UTC (Coordinated Universal Time) con offset di pregiudizio da Greenwich Mean Time (GMT), il che significa che un processo può essere specificato usando qualsiasi fuso orario. La classe Win32_ScheduledJob restituisce l'ora locale con offset UTC durante l'enumerazione di un oggetto e converte in ora locale durante la creazione di nuovi processi. Ad esempio, un processo specificato per l'esecuzione in un computer a Boston alle 10:30 di lunedì l'ora PST di lunedì sarà pianificata per l'esecuzione in locale alle 1:30 A.M. Martedì EST.

Nota

Un client deve prendere in considerazione se l'ora legale è in esecuzione nel computer locale e, se è, sottraere un pregiudizio di 60 minuti dall'offset UTC.

 

La classe Win32_ScheduledJob deriva da CIM_Job. È necessario essere un membro del gruppo administrators per creare un processo pianificato usando questa classe.

La classe Win32_ScheduledJob usa internamente il protocollo AT, associato alla deprecazione a partire da Windows 8 e Windows Server 2012. Come primo passaggio il protocollo AT è disabilitato per impostazione predefinita. Se il protocollo è disabilitato, ad esempio la chiamata al metodo Create in un oggetto Win32_ScheduledJob avrà esito negativo con errore 0x8. È possibile riattivare il protocollo AT aggiungendo la voce del Registro di sistema seguente:

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

Potrebbe essere necessario riavviare il computer per rendere effettiva l'impostazione.

Poiché Win32_ScheduledJob si basa sull'API NetScheduleJobGetInfo Win32, non è possibile usare questa classe insieme all'Utilità di pianificazione. Se si vuole usare Utilità di pianificazione, usare l'API Utilità di pianificazione. Per altre informazioni, vedere Informazioni di riferimento sull'utilità di pianificazione.

Esempio

L'esempio di codice VBScript seguente pianifica Notepad.exe per l'esecuzione interattiva alle 1:25 dal computer locale ogni mercoledì.

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

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista
Server minimo supportato
 Windows Server 2008
Spazio dei nomi
 Radice\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Vedi anche

CIM_Job

Classi del sistema operativo

Attività WMI: Attività pianificate