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)

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

Vedi anche

Classi del sistema operativo

Win32_ScheduledJob