Metodo Create della classe Win32_ScheduledJob

Il metodo Creaclasse WMI invia un processo a un sistema operativo per l'esecuzione in un'ora e una data specificata in futuro. Questo metodo richiede che il servizio di pianificazione venga avviato nel computer in cui viene inviato il processo.

Questo argomento usa la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di 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 binari e della riga di comando usati dal servizio di pianificazione per richiamare il processo.

Esempio: "defrag /q /f".

StartTime [in]

Ora UTC (Coordinated Universal Time) per eseguire un processo. Il modulo deve essere: "AAAAMMDHHMMSS. MMMMMM(+-)OOO", dove "AAAAAMMDD" deve essere sostituito da "****". Ad esempio: "^^143000.00000-420" specifica 14.30 (2:30 P.M.) PST con ora legale in effetti.

La sezione "(+-)OOO" del valore della proprietà StartTime è la distorsione corrente per la traduzione ora locale. Il pregiudizio è la differenza tra l'ora UTC e l'ora locale. Per calcolare il pregiudizio per il fuso orario, moltiplicare il numero di ore che il fuso orario è in anticipo o dietro Greenwich Mean Time (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 un ulteriore 60 al calcolo se il fuso orario usa l'ora legale. Ad esempio, il fuso orario Standard 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à di pregiudizio della classe Win32_TimeZone .

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 viene pianificato l'esecuzione di un processo; usato solo quando il parametro RunRepeatedly è True. Per pianificare un processo per più di un giorno della settimana, aggiungere i valori appropriati in un or logico. Ad esempio, per pianificare un processo per martedì e venerdì, il valore di DaysOfWeek è 2 OR 16.

Lunedì (1)

Martedì (2)

Mercoledì (4)

Giovedì (8)

Venerdì (16)

Sabato (32)

Domenica (64)

DaysOfMonth [in, facoltativo]

Giorni del mese in cui viene pianificato l'esecuzione di un processo; usato solo quando il parametro RunRepeatedly è True.

1 (1 )

Giorno 1 di un 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 di un mese

12 (2048)

Giorno 12 di un mese

13 (4096)

Giorno 13 di un mese

14 (8192 )

Giorno 14 di un mese

15 (16384)

Giorno 15 di un mese

16 (32768)

Giorno 16 di un mese

17 (65536)

Giorno 17 di un 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 di un mese

26 (33554432)

Giorno 26 di un mese

27 (67108864)

Giorno 27 di un mese

28 (134217728)

Giorno 28 di un mese

29 (268435456)

Giorno 29 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 input a un processo pianificato durante l'esecuzione del processo. Il valore predefinito è False.

JobId [out]

Numero di identificatori di un processo. Questo parametro è un handle per un processo pianificato in un computer.

Valore restituito

Restituisce un valore pari a 0 (zero) in caso di esito positivo e un numero diverso per indicare un errore. Per altri 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 viene 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 della directory del file eseguibile del servizio.

Parametro non valido

21

I parametri non validi sono stati passati al servizio.

Servizio non avviato

22

L'account in cui viene eseguito il servizio non è valido o non dispone delle autorizzazioni per l'esecuzione del 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 oppure 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	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

Classi del sistema operativo

Win32_ScheduledJob