RegisteredTask.SetSecurityDescriptor method

Article
12/11/2020

For scripting, sets the security descriptor that is used as credentials for the registered task.

Syntax

RegisteredTask.SetSecurityDescriptor( _
  ByVal sddl, _
  ByVal flags _
)

Parameters

sddl [in]: The security descriptor that is used as credentials for the registered task.

Note

If the Local System account is denied access to a task, then the Task Scheduler service can produce unexpected results.
flags [in]: Flags that specify how to set the security descriptor. The TASK_DONT_ADD_PRINCIPAL_ACE flag (0x10) from the TASK_CREATION enumeration can be specified.

Return value

This method does not return a value.

Remarks

You can specify the access control list (ACL) in the security descriptor for a task in order to allow or deny certain users and groups access to a task.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Type library	Taskschd.tlb
DLL	Taskschd.dll

Share via