Set-SCExternalJob

참조

모듈:: VirtualMachineManager

기존 외부 작업을 업데이트.

Syntax

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

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

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

Description

Set-SCExternalJob cmdlet은 VMM(Virtual Machine Manager)의 기존 외부 작업을 업데이트합니다. 작업의 완료율(%)을 업데이트하거나 작업의 상태를 완료 또는 실패로 설정할 수 있습니다.

외부 작업에 대한 자세한 내용은 New-SCExternalJob cmdlet을 참조하세요.

예제

예제 1: 외부 작업을 15% 완료로 설정

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

첫 번째 명령은 ExternalJob01이라는 외부 작업 개체를 가져오고 개체를 $ExternalJob 변수에 저장합니다.

두 번째 명령은 $ExternalJob 저장된 작업의 진행률 값을 15로 설정합니다.

예제 2: 외부 작업을 완료하도록 설정

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

첫 번째 명령은 ExternalJob02라는 외부 작업 개체를 가져오고 개체를 $ExternalJob 변수에 저장합니다.

두 번째 명령은 $ExternalJob 저장된 작업의 상태를 완료하도록 설정하고 작업에 대한 정보를 추가합니다.

예제 3: 외부 작업을 실패로 설정

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

첫 번째 명령은 ExternalJob03이라는 외부 작업 개체를 가져오고 개체를 $ExternalJob 변수에 저장합니다.

두 번째 명령은 $ExternalJob 저장된 작업의 상태를 실패로 설정하고 작업에 대한 정보를 추가합니다.

매개 변수

-Completed

완료할 외부 작업의 상태를 설정합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Failed

외부 작업의 상태를 실패로 설정합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InfoMessage

외부 작업에 대한 정보 메시지를 제공합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Job

VMM 작업 개체를 지정합니다.

Type:	Task
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ProgressValue

외부 작업의 진행률에 대한 완료율(%)을 제공합니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

출력

Task

이 cmdlet은 Task 개체를 반환합니다.

New-SCExternalJob