Udostępnij za pośrednictwem

Set-SCExternalJob

  • Odwołanie
Moduł:
VirtualMachineManager

Aktualizacje istniejącego zadania zewnętrznego.

Składnia

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

Opis

Polecenie cmdlet Set-SCExternalJob aktualizuje istniejące zadania zewnętrzne w programie Virtual Machine Manager (VMM). Możesz zaktualizować procent ukończenia zadania lub ustawić stan zadania na ukończone lub zakończone niepowodzeniem.

Aby uzyskać więcej informacji na temat zadań zewnętrznych, zobacz polecenie cmdlet New-SCExternalJob .

Przykłady

Przykład 1. Ustawianie zadania zewnętrznego na 15% ukończonych

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

Pierwsze polecenie pobiera obiekt zadania zewnętrznego o nazwie ExternalJob01 i przechowuje obiekt w zmiennej $ExternalJob.

Drugie polecenie ustawia wartość postępu zadania przechowywanego w $ExternalJob na 15.

Przykład 2. Ustawianie zadania zewnętrznego na ukończone

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

Pierwsze polecenie pobiera obiekt zadania zewnętrznego o nazwie ExternalJob02 i przechowuje obiekt w zmiennej $ExternalJob.

Drugie polecenie ustawia stan zadania przechowywanego w $ExternalJob do ukończenia i dodaje informacje o zadaniu.

Przykład 3. Ustawianie zadania zewnętrznego na niepowodzenie

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

Pierwsze polecenie pobiera obiekt zadania zewnętrznego o nazwie ExternalJob03 i przechowuje obiekt w zmiennej $ExternalJob.

Drugie polecenie ustawia stan zadania przechowywanego w $ExternalJob nie powiodło się i dodaje informacje o zadaniu.

Parametry

-Completed

Ustawia stan zadania zewnętrznego do ukończenia.

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

-Failed

Ustawia stan zadania zewnętrznego na niepowodzenie.

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

-InfoMessage

Zawiera komunikat informacyjny dla zadań zewnętrznych.

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

-Job

Określa obiekt zadania programu VMM.

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

-ProgressValue

Dostarcza procent ukończenia postępu zadania zewnętrznego.

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

Dane wyjściowe

Task

To polecenie cmdlet zwraca obiekt Task .