Set-SCExternalJob

Set-SCExternalJob

Updates an existing external job.

Syntax

Parameter Set: Progress
Set-SCExternalJob [-Job] <Task> -ProgressValue <Int32> [ <CommonParameters>]

Parameter Set: Completed
Set-SCExternalJob [-Job] <Task> -Completed [-InfoMessage <String> ] [ <CommonParameters>]

Parameter Set: Failed
Set-SCExternalJob [-Job] <Task> -Failed -InfoMessage <String> [ <CommonParameters>]

Detailed Description

The Set-SCExternalJob cmdlet updates existing external jobs in Virtual Machine Manager (VMM). You can update the percent complete of the job, or set the status of the job to completed or failed.

For more information about external jobs, see the New-SCExternalJob cmdlet.

Parameters

-Completed

Sets the status of an external job to completed.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Failed

Indicates that this cmdlet sets the status of an external job to failed.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InfoMessage<String>

Provides an informational message for external jobs.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Job<Task>

Specifies a VMM job object.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-ProgressValue<Int32>

Supplies the percent complete of the progress of an external job.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Task

Examples

Example Example 1: Set an external job to 15 percent% complete. percent

The first command gets the external job object named ExternalJob01, and then stores the object in the $externalJob variable.

The second command sets the progress value for the job stored in $externalJob to 15.

PS C:\> $externalJob = Get-SCJob -Name "ExternalJob01"
PS C:\> Set-SCExternalJob -Job $externalJob -ProgressValue 15

Example 2: Set an external job to completed

The first command gets the external job object named ExternalJob02, and stores the object in the $externalJob variable.

The second command sets the status of the job stored in $externalJob to completed, and adds information about the job.

PS C:\> $externalJob = Get-SCJob -Name "ExternalJob02"
PS C:\> Set-SCExternalJob Job $externalJob -Completed -InfoMessage "Some information about the completed job"

Example 3: Set an external job to failed

The first command gets the external job object named ExternalJob03, and then stores the object in the $externalJob variable.

The second command sets the status of the job stored in $externalJob to failed, and adds information about the job.

PS C:\> $externalJob = Get-SCJob -Name "ExternalJob03"
PS C:\> Set-SCExternalJob -Job $externalJob -Failed -InfoMessage "An error message for the failed job"

New-SCExternalJob

Get-SCJob