Edit

Task Registration Information

  • Article

Registration information provides a way to identify a task in several different ways. For example, a task can be identified by the author, how it was authored (referred to as the task source), and date of registration.

Using Registration Information

Registration information is typically specified when the task is created and then used in the following ways:

  • Displayed by the Task Scheduler user interface.
  • Get or set by C++ applications or scripts.
  • In an enterprise environment, used as a search criteria when enumerating over all registered tasks.

Types of Registration Information

Task registration information is defined by the properties of the RegistrationInfo object for scripting applications, the properties of the IRegistrationInfo interface for C++ applications, and the child elements of the RegistrationInfo (taskType) element for reading or writing XML.

These properties allow access to the following types of registration information:

  • Task Author

    Task Scheduler sets the author of the task when it is created.

  • Task Registration Date

    Task Scheduler sets this date when the task is registered.

  • Task Description

    A user-defined description that may include what triggers are used to start the task or what actions the task performs.

  • Task Documentation

    User-supplied documentation that is needed by the task.

  • Task Security Descriptor

    A user-supplied security descriptor.

  • Task Source

    User-supplied information that describes where the task originated from. For example, a task may originate from a component, service, application, or user.

  • Task URI

    A uniform resource identifier (URI) for the task.

  • Task Version

    User-supplied information that is used when multiple versions of a task exist.

  • XML Text

    An XML-formatted version of the registration information. Note that you can set or modify the registration information directly through this XML and the appropriate object and interface properties will be updated accordingly.

Registering Tasks

A task can be registered after the task definitions are created and registration information and setting values are supplied by the user. A task is registered using the TaskFolder.RegisterTaskDefinition method for scripting applications or the ITaskFolder::RegisterTaskDefinition method for C++ applications. If you want to register a task using XML to define the task, you use the TaskFolder.RegisterTask method for scripting applications and the ITaskFolder::RegisterTask method for C++ applications.

In the methods mentioned above, you can specify the security context to run the task. You have to be an administrator on the system to schedule jobs to run under contexts other than your own. For more information on the security contexts to run tasks, see Security Contexts for Running Tasks.

About The Task Scheduler

Task Scheduler