Click or drag to resize
Task Scheduler Managed Class Library

TaskServiceAddTask Method (String, QuickTriggerType, String, String, String, String, TaskLogonType, String)

Creates a new task, registers the task, and returns the instance.

Namespace:  Microsoft.Win32.TaskScheduler
Assembly:  Microsoft.Win32.TaskScheduler (in Microsoft.Win32.TaskScheduler.dll) Version: 2.10.1
Syntax
public Task AddTask(
	string path,
	QuickTriggerType trigger,
	string exePath,
	string arguments = null,
	string userId = null,
	string password = null,
	TaskLogonType logonType = TaskLogonType.InteractiveToken,
	string description = null
)
Request Example View Source

Parameters

path
Type: SystemString
The task name. If this value is NULL, the task will be registered in the root task folder and the task name will be a GUID value that is created by the Task Scheduler service. A task name cannot begin or end with a space character. The '.' character cannot be used to specify the current task folder and the '..' characters cannot be used to specify the parent task folder in the path.
trigger
Type: Microsoft.Win32.TaskSchedulerQuickTriggerType
The Trigger to determine when to run the task.
exePath
Type: SystemString
The executable path.
arguments (Optional)
Type: SystemString
The arguments (optional). Value can be NULL.
userId (Optional)
Type: SystemString
The user credentials used to register the task.
password (Optional)
Type: SystemString
The password for the userId used to register the task.
logonType (Optional)
Type: Microsoft.Win32.TaskSchedulerTaskLogonType
A TaskLogonType value that defines what logon technique is used to run the registered task.
description (Optional)
Type: SystemString
The task description.

Return Value

Type: Task
A Task instance of the registered task.
Examples
C#
// Display a log file every day
TaskService.Instance.AddTask("Test", QuickTriggerType.Daily, "notepad.exe", "c:\\test.log"));
See Also