NAME
Invoke-DcsTask
SYNOPSIS
Causes the specified task to run.
SYNTAX
Invoke-DcsTask -Task <Object> [ -Connection <String> ] [ -PipelineVariable <String> ]
DESCRIPTION
Causes the specified task to run. The task must be enabled.
PARAMETERS
- -Task<Object>
- TaskData object, name, or ID that identifies the task.
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: true (ByValue)
- Accept wildcard characters: false
-
- -Connection<String>
- Alias of the connection to the server group. If not specified, the default connection is used.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -PipelineVariable<String>
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
INPUTS
TaskData : Object that identifies and describes the task.
OUTPUTS
TaskData : Object that identifies and describes the task.
NOTES
Also see Enable-DcsTask, Disable-DcsTask, Stop-DcsTask.
EXAMPLES
-------------- Example 1 Runs a task specified by name --------------
Invoke-DcsTask -Task "Reclaim_VirtualDisk1"
Invokes the task named "Reclaim_VirtualDisk1", which causes the task to run.
| Description | : | |
| Enabled | : | True |
| ActionBehavior | : | RunPerTrigger |
| MaxRunTime | : | 6048000000000 |
| Connective | : | LogicalOr |
| ActionDelay | : | 0 |
| State | : | Idle |
| CurrentActionId | : | |
| LastStartTime | : | 8/15/2011 2:59:59 PM |
| LastStopTime | : | 8/15/2011 3:00:00 PM |
| Id | : | 517d1498-04aa-4dda-9873-497db1964cf9 |
| Caption | : | Reclaim_VirtualDisk1 |
| ExtendedCaption | : | Reclaim_VirtualDisk1 |
| Internal | : | False |
-------------- Example 2 Runs all tasks by piping objects --------------
Get-DcsTask | Invoke-DcsTask
The cmdlet Get-DcsTask is used to pipe all task objects to the cmdlet Invoke-DcsTask, causing all tasks in the server group to be invoked.
| Description | : | |
| Enabled | : | True |
| ActionBehavior | : | RunPerTrigger |
| MaxRunTime | : | 6048000000000 |
| Connective | : | LogicalOr |
| ActionDelay | : | 0 |
| State | : | Idle |
| CurrentActionId | : | |
| LastStartTime | : | 8/15/2011 2:59:59 PM |
| LastStopTime | : | 8/15/2011 3:00:06 PM |
| Id | : | c1099d5b-0769-4322-9b73-f575fc5e45c3 |
| Caption | : | MonitorPoolUsage |
| ExtendedCaption | : | MonitorPoolUsage |
| Internal | : | False |
| Description | : | |
| Enabled | : | True |
| ActionBehavior | : | RunPerTrigger |
| MaxRunTime | : | 6048000000000 |
| Connective | : | LogicalOr |
| ActionDelay | : | 0 |
| State | : | Idle |
| CurrentActionId | : | |
| LastStartTime | : | 8/15/2011 3:02:28 PM |
| LastStopTime | : | 8/15/2011 3:02:28 PM |
| Id | : | 517d1498-04aa-4dda-9873-497db1964cf9 |
| Caption | : | Reclaim_VirtualDisk1 |
| ExtendedCaption | : | Reclaim_VirtualDisk1 |
| Internal | : | False |