Export (0) Print
Expand All
2 out of 2 rated this helpful - Rate this topic

Task Actions

The work items performed by a task are called actions. A task can have a single action or a maximum of 32 actions. Be aware that when multiple actions are specified, they are executed sequentially.

Types of Actions

The following table of actions describes the type of work or actions that can be accomplished by a task.

Type of ActionDescription
ComHandler ActionThis action fires a COM handler.
Exec ActionThis action executes a command-line operation such as starting Notepad.
E-mail ActionThis action sends an email when a task is triggered.
Show Message ActionThis action shows a message box with a specified message and title.

 

Specifying Actions

The actions of a task are specified when the task is defined and stored in a collection of actions used by the Task Scheduler service. The following table lists links to reference topics for the APIs and XML elements that are associated with actions.

For more information and examples about how to use the Task Scheduler interfaces, scripting objects, and XML, see Using the Task Scheduler.

Interface APIs for C++ Development

APIDescription
Actions Property of ITaskDefinition Gets or sets the actions performed by the task.
IActionCollection Contains the actions performed by the task.
IComHandlerAction Represents an action that fires a handler.
IExecAction Represents an action that executes a command-line operation.
IEmailAction Represents an action that sends an email message.
IShowMessageAction Represents an action that shows a message box.

 

Scripting Object APIs for Scripting Development

APIDescription
TaskDefinition.Actions Gets or sets the actions performed by the task.
ActionCollection Contains the actions performed by the task.
ComHandlerAction Represents an action that fires a handler.
ExecAction Represents an action that executes a command-line operation.
EmailAction Represents an action that sends an email message.
ShowMessageAction Represents an action that shows a message box.

 

XML Elements

ElementDescription
Actions Defines the actions performed by the task.
ComHandler Represents an action that fires a handler.
Exec Represents an action that executes a command-line operation.
SendEmail Represents an action that sends an email message.
ShowMessage Represents an action that shows a message box.

 

Using Variables in Action Properties

Some action properties that are of type BSTR can contain $(Arg0), $(Arg1), ..., $(Arg32) variables in their string values. These variables are replaced with the values that are specified in the params parameter of the IRegisteredTask::Run and IRegisteredTask::RunEx methods or are contained within the event trigger for the task. The following table lists the action properties that can use variables in their string values.

ActionProperties
COM Handler Action

C++:

Scripting:

Email Action

C++:

Scripting:

Exec Action

C++:

Scripting:

Show Message Action

C++:

Scripting:

 

Related topics

About The Task Scheduler

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.