Metodo Create della classe Win32 _ ScheduledJob

Il metodo Crea classe WMI Invia un processo a un sistema operativo per l'esecuzione a una data e ora specificate in futuro. Questo metodo richiede che il servizio Schedule venga avviato nel computer a cui viene inviato il processo.

In questo argomento viene utilizzata la sintassi Managed Object Format (MOF). Per ulteriori informazioni sull'utilizzo di questo metodo, vedere chiamata a un metodo.

Sintassi

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
);

Parametri

Comando [ in]

Nome del comando, del programma batch o dei parametri del file binario e della riga di comando utilizzati dal servizio Schedule per richiamare il processo.

Esempio: "Defrag/q/f".

StartTime [ in]

Ora UTC (Coordinated Universal Time) per l'esecuzione di un processo. Il formato deve essere: "ad aaaammgghhmmss. MMMMMM (+-) OOO ", dove" AAAAMMGG "deve essere sostituito da" * * * * * * * * ". Ad esempio: " * * * * * * * * 143000.000000-420" specifica 14,30 (2:30) PST con ora legale in vigore.

La sezione "(+-) OOO" del valore della proprietà StartTime è la distorsione corrente per la conversione 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 per cui il fuso orario è in anticipo o dietro la ora di Greenwich (GMT) di 60 (usare un numero positivo per il numero di ore se il fuso orario è preceduto da GMT e un numero negativo se il fuso orario è dietro GMT). Aggiungere un ulteriore 60 al calcolo se il fuso orario USA l'ora legale. Ad esempio, il fuso orario Pacifico standard è di otto ore dietro GMT, quindi 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 del _ fuso orario Win32 .

RunRepeatedly [ in, facoltativo]

Se true, un processo pianificato viene eseguito ripetutamente in giorni specifici. Il valore predefinito è False.

DaysOfWeek [ in, facoltativo]

Giorni della settimana in cui è pianificata l'esecuzione di un processo; utilizzato solo quando il parametro RunRepeatedly è true. Per pianificare un processo per più di un giorno della settimana, unire i valori appropriati in un operatore OR logico. Per pianificare un processo per martedì e venerdì, ad esempio, il valore di DaysOfWeek è 2 o 16.

Lunedì (1)

Martedì (2)

Mercoledì (4)

Giovedi (8)

Venerdì (16)

Sabato (32)

Domenica (64)

DaysOfMonth [ in, facoltativo]

Giorni del mese in cui è pianificata l'esecuzione di un processo; utilizzato solo quando il parametro RunRepeatedly è true.

1 (1)

Primo giorno del mese

2 (2)

Giorno 2 di un mese

3 (4)

Giorno 3 di un mese

4 (8)

Giorno 4 di un mese

5 (16)

Giorno 5 di un mese

6 (32)

Giorno 6 di un mese

7 (64)

Giorno 7 di un mese

8 (128)

Giorno 8 di un mese

9 (256)

Giorno 9 di un mese

10 (512)

Giorno 10 di un mese

11 (1024)

Giorno 11 del mese

12 (2048)

Giorno 12 di un mese

13 (4096)

Giorno 13 del mese

14 (8192)

Giorno 14 di un mese

15 (16384)

Giorno 15 del mese

16 (32768)

Giorno 16 di un mese

17 (65536)

Giorno 17 del mese

18 (131072)

Giorno 18 di un mese

19 (262144)

Giorno 19 di un mese

20 (524288)

Giorno 20 di un mese

21 (1048576)

Giorno 21 di un mese

22 (2097152)

Giorno 22 di un mese

23 (4194304)

Giorno 23 di un mese

24 (8388608)

Giorno 24 di un mese

25 (16777216)

Giorno 25 del mese

26 (33554432)

Giorno 26 di un mese

27 (67108864)

Giorno 27 del mese

28 (134217728)

Giorno 28 del mese

29 (268435456)

29 giorni di un mese

30 (536870912)

Giorno 30 di un mese

31 (1073741824)

Giorno 31 di un mese

InteractWithDesktop [ in, facoltativo]

Se true, il processo specificato deve essere interattivo, il che significa che un utente può fornire l'input a un processo pianificato mentre il processo è in esecuzione. Il valore predefinito è False.

JobID [ out]

Identificatore del numero di un processo. Questo parametro è un handle per un processo pianificato in un computer.

Valore restituito

Restituisce un valore pari a 0 (zero) quando ha esito positivo e un numero diverso per indicare un errore. Per ulteriori codici di errore, vedere costanti di errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere codici di errore di sistema.

Operazione completata

0

La richiesta è stata accettata.

Non supportato

1

La richiesta non è supportata.

Accesso negato

2

L'utente non dispone dell'accesso necessario.

Errore sconosciuto

8

Processo interattivo.

Impossibile trovare il percorso

9

Impossibile trovare il percorso di directory del file eseguibile del servizio.

Parametro non valido

21

Sono stati passati parametri non validi al servizio.

Servizio non avviato

22

L'account con cui viene eseguito il servizio non è valido o non dispone delle autorizzazioni necessarie per eseguire il servizio.

Altri

23 4294967295

Commenti

Se il processo pianificato avvia un programma interattivo, ad esempio Blocco note, la proprietà InteractWithDeskto deve essere impostata su true o la schermata del programma non è visibile. Il processo viene comunque visualizzato in Gestione attività anche se non viene visualizzato sullo schermo.

Requisiti

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

Vedi anche

Classi del sistema operativo

_ScheduledJob Win32