Share via


Oggetto Principal

Oggetto scripting che fornisce le credenziali di sicurezza per un'entità. Queste credenziali di sicurezza definiscono il contesto di sicurezza per le attività associate all'entità.

Membri

L'oggetto Principal ha questi tipi di membri:

Proprietà

L'oggetto Principal ha queste proprietà.

Proprietà Tipo di accesso Descrizione
DisplayName
Lettura/Scrittura
Ottiene o imposta il nome dell'entità visualizzata nell'interfaccia utente dell'utilità di pianificazione.
GroupId
Lettura/Scrittura
Ottiene o imposta l'identificatore del gruppo di utenti necessario per eseguire le attività associate all'entità.
Id
Lettura/Scrittura
Ottiene o imposta l'identificatore dell'entità.
LogonType
Lettura/Scrittura
Ottiene o imposta il metodo di accesso di sicurezza necessario per eseguire le attività associate all'entità.
Runlevel
Lettura/Scrittura
Ottiene o imposta l'identificatore utilizzato per specificare il livello di privilegio necessario per eseguire le attività associate all'entità.
Userid
Lettura/Scrittura
Ottiene o imposta l'identificatore utente necessario per eseguire le attività associate all'entità.

Commenti

Quando si specifica un account, ricordarsi di usare correttamente la doppia barra rovesciata nel codice per specificare il dominio e il nome utente. Ad esempio, utilizzare DOMAIN\\UserName per specificare un valore per la proprietà UserId .

Quando si legge o si scrive codice XML per un'attività, le credenziali di sicurezza per un'entità vengono specificate nell'elemento Principal dello schema dell'utilità di pianificazione.

Se un'attività viene registrata utilizzando lo strumento da riga di comando at.exe e questo oggetto viene utilizzato per recuperare informazioni sull'attività, la proprietà LogonType restituirà 0, la proprietà RunLevel restituirà 0 e la proprietà UserId restituirà Nothing.

Esempio

Per altre informazioni e codice di esempio per questo oggetto scripting, vedere Esempio di trigger temporale (scripting).

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