Managed Object - ScheduledTask

Property of: EventFilterSpec, ScheduledTaskEventArgument, ScheduledTaskInfo, ScheduledTaskManager, TaskFilterSpec, TaskReasonSchedule
Returned by: CreateObjectScheduledTask, CreateScheduledTask, RetrieveEntityScheduledTask, RetrieveObjectScheduledTask
Extends: ExtensibleManagedObject
See also: ScheduledTaskInfo, ScheduledTaskSpec

Managed Object Description

The scheduled task object.

Properties

Name	Type	Description
info	ScheduledTaskInfo	Information about the current scheduled task.
Properties inherited from ExtensibleManagedObject
availableField, value

Methods

Methods defined in this Managed Object
ReconfigureScheduledTask, RemoveScheduledTask, RunScheduledTask
Methods inherited from ExtensibleManagedObject
setCustomValue

ReconfigureScheduledTask

Reconfigures the scheduled task properties.

Required Privileges: ScheduledTask.Edit

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the ScheduledTask used to make the method call.
spec	ScheduledTaskSpec	The new specification for the scheduled task.

Return Value

Type	Description
None

Faults

Type	Description
DuplicateName	Thrown if a scheduled task with the name already exists.
InvalidArgument	Thrown if the specification is invalid.
InvalidName	Thrown if the scheduled task name is empty or too long.
InvalidState	Thrown if the scheduled task is running.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ReconfigureScheduledTask" type="vim25:ReconfigureScheduledTaskRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="ReconfigureScheduledTaskResponse">
            <complexType/>
         </element>

RemoveScheduledTask

Removes the scheduled task.

Required Privileges: ScheduledTask.Delete

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the ScheduledTask used to make the method call.

Return Value

Type	Description
None

Faults

Type	Description
InvalidState	Thrown if the scheduled task is running.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RemoveScheduledTask" type="vim25:RemoveScheduledTaskRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RemoveScheduledTaskResponse">
            <complexType/>
         </element>

RunScheduledTask

Runs the scheduled task immediately. The schedule for future runs remains in effect.

Required Privileges: ScheduledTask.Run

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the ScheduledTask used to make the method call.

Return Value

Type	Description
None

Faults

Type	Description
InvalidState	Thrown if the scheduled task is running already.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RunScheduledTask" type="vim25:RunScheduledTaskRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RunScheduledTaskResponse">
            <complexType/>
         </element>