Udostępnij za pośrednictwem

Set-SCExternalJob

  • Odwołanie
Moduł:
VirtualMachineManager

Aktualizuje istniejące zadanie zewnętrzne.

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 wykonania 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. Ustawienie zadania zewnętrznego na 15% ukończenia

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 do ukończenia

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 niepowodzeniem i dodaje informacje o zadaniu.

Parametry

-Completed

Ustawia stan zadania zewnętrznego na ukończone.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Failed

Ustawia stan zadania zewnętrznego na niepowodzenie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InfoMessage

Zawiera komunikat informacyjny dla zadań zewnętrznych.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Job

Określa obiekt zadania programu VMM.

Typ:Task
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ProgressValue

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

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

Task

To polecenie cmdlet zwraca obiekt zadania .