다음을 통해 공유


Set-SCExternalJob

기존 외부 작업을 업데이트합니다.

구문

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

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

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Failed

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

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InfoMessage

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Job

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

형식:Task
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ProgressValue

외부 작업의 진행률 완료 비율을 제공합니다.

형식:Int32
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

출력

Task

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