Metodo TaskFolder.RegisterTask

Articolo
06/13/2023

Per lo scripting, registra (crea) una nuova attività nella cartella usando XML per definire l'attività.

Sintassi

TaskFolder.RegisterTask( _
  ByVal path, _
  ByVal xmlText, _
  ByVal flags, _
  ByVal userId, _
  ByVal password, _
  ByVal logonType, _
  [ ByVal sddl ], _
  ByRef pTask _
)

Parametri

percorso [in]

Nome dell'attività. Se questo valore è Nothing, l'attività verrà registrata nella cartella attività radice e il nome dell'attività sarà un valore GUID creato dal servizio Utilità di pianificazione.

Un nome dell'attività non può iniziare o terminare con un carattere di spazio. Impossibile utilizzare il carattere '.' per specificare la cartella attività corrente e '.'. i caratteri non possono essere usati per specificare la cartella dell'attività padre nel percorso.

xmlText [in]

Descrizione formattata XML dell'attività.

Gli argomenti seguenti contengono attività definite usando XML.

flag [in]

Costante TASK_CREATION .

Valore	Significato
TASK_VALIDATE_ONLY 0x1	L'Utilità di pianificazione controlla la sintassi del codice XML che descrive l'attività, ma non registra l'attività. Questa costante non può essere combinata con i valori TASK_CREATE, TASK_UPDATE o TASK_CREATE_OR_UPDATE .
TASK_CREATE 0x2	L'utilità di pianificazione attività registra l'attività come nuova attività.
TASK_UPDATE 0x4	L'Utilità di pianificazione registra l'attività come versione aggiornata di un'attività esistente. Quando viene aggiornata un'attività con un trigger di registrazione, l'attività verrà eseguita dopo l'aggiornamento.
TASK_CREATE_OR_UPDATE 0x6	L'Utilità di pianificazione registra l'attività come nuova attività o come versione aggiornata se l'attività esiste già. Equivalente a TASK_CREATE \| TASK_UPDATE.
TASK_DISABLE 0x8	L'Utilità di pianificazione disabilita l'attività esistente.
TASK_DONT_ADD_PRINCIPAL_ACE 0x10	L'utilità di pianificazione dell'attività non consente di aggiungere la voce di controllo di accesso (ACE) per l'entità contesto. Quando la funzione TaskFolder.RegisterTask viene chiamata con questo flag per aggiornare un'attività, il servizio Utilità di pianificazione non aggiunge l'ACE per la nuova entità di contesto e non rimuove l'ACE dall'entità contesto precedente.
TASK_IGNORE_REGISTRATION_TRIGGERS 0x20	L'utilità di pianificazione attività crea l'attività, ma ignora i trigger di registrazione nell'attività. Ignorando i trigger di registrazione, l'attività non verrà eseguita quando viene registrata a meno che non venga eseguito un trigger basato sul tempo per l'esecuzione nella registrazione.

userId [in]

Credenziali utente usate per registrare l'attività.

Nota

Se l'attività è definita come attività Utilità di pianificazione 1.0, non usare un nome di gruppo (anziché un nome utente specifico) in questo parametro userId. Un'attività viene definita come attività Utilità di pianificazione 1.0 quando l'attributo di versione dell'elemento Task nel codice XML dell'attività è impostato su 1.1.

password [in]

Password per userId utilizzata per registrare l'attività. Quando viene usato il tipo di accesso TASK_LOGON_SERVICE_ACCOUNT, la password deve essere un valore VARIANT vuoto, ad esempio VT_NULL o VT_EMPTY.

logonType [in]

Definisce la tecnica di accesso utilizzata per eseguire l'attività registrata.

Valore	Significato
TASK_LOGON_NONE 0	Il metodo di accesso non è specificato. Usato per le credenziali non NT.
TASK_LOGON_PASSWORD 1	Usare una password per l'accesso all'utente. La password deve essere fornita al momento della registrazione.
TASK_LOGON_S4U 2	Usare un token interattivo esistente per eseguire un'attività. L'utente deve accedere usando un servizio per l'accesso (S4U). Quando viene usato un accesso S4U, nessuna password viene archiviata dal sistema e non è possibile accedere alla rete o ai file crittografati.
TASK_LOGON_INTERACTIVE_TOKEN 3	L'utente deve essere già connesso. L'attività verrà eseguita solo in una sessione interattiva esistente.
TASK_LOGON_GROUP 4	Attivazione del gruppo. Il campo groupId specifica il gruppo.
TASK_LOGON_SERVICE_ACCOUNT 5	Indica che un account del sistema locale, del servizio locale o del servizio di rete viene usato come contesto di sicurezza per eseguire l'attività.
TASK_LOGON_INTERACTIVE_TOKEN_OR_PASSWORD 6	Usare prima di tutto il token interattivo. Se l'utente non è connesso (non è disponibile alcun token interattivo), viene usata la password. La password deve essere specificata quando viene registrata un'attività. Questo flag non è consigliato per le nuove attività perché è meno affidabile di TASK_LOGON_PASSWORD.

sddl [in, facoltativo]

Descrittore di sicurezza associato all'attività registrata. È possibile specificare l'elenco di controllo di accesso (ACL) nel descrittore di sicurezza per un'attività per consentire o negare a determinati utenti e gruppi l'accesso a un'attività.

Nota

Se l'account di sistema locale viene negato l'accesso a un'attività, il servizio Utilità di pianificazione può produrre risultati imprevisti.

pTask [out]

Oggetto RegisteredTask che rappresenta la nuova attività.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Per un'attività che contiene un'azione di finestra di messaggio, la finestra di messaggio verrà visualizzata se l'attività è attivata e l'attività ha un tipo di accesso interattivo. Per impostare il tipo di accesso dell'attività su interattivo, specificare 3 (TASK_LOGON_INTERACTIVE_TOKEN) o 4 (TASK_LOGON_GROUP) nella proprietà LogonType dell'entità attività oppure nel parametro logonType di TaskFolder.RegisterTask o TaskFolder.RegisterTaskDefinition.

Solo un membro del gruppo Administrators può creare un'attività con un trigger di avvio.

È possibile registrare correttamente un'attività con un gruppo specificato nel parametro userId e 3 (TASK_LOGON_INTERACTIVE_TOKEN) specificato nel parametro logonType di TaskFolder.RegisterTask o TaskFolder.RegisterTaskDefinition, ma l'attività non verrà eseguita.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Libreria dei tipi	Taskschd.tlb
DLL	Taskschd.dll

Vedi anche

Utilità di pianificazione
RegisteredTask
TaskFolder

Condividi tramite