Scripting object that provides the security credentials for a principal. These security credentials define the security context for the tasks that are associated with the principal.

Methods

The Principal object does not define any methods.

Properties

The Principal object defines the following properties.

Remarks

When specifying an account, remember to properly use the double backslash in code to specify the domain and user name. For example, use DOMAIN\\UserName to specify a value for the UserId property.

When reading or writing XML for a task, the security credentials for a principal are specified in the Principal element of the Task Scheduler schema.

If a task is registered using the at.exe command line tool, and this object is used to retrieve information about the task, then the LogonType property will return 0, the RunLevel property will return 0, and the UserId property will return Nothing.

Examples

For more information and example code for this scripting object, see Time Trigger Example (Scripting).

Requirements

See Also

Task Scheduler Objects

Task Scheduler

Send comments about this topic to Microsoft

Build date: 11/12/2009