Sdílet prostřednictvím

Set-SCExternalJob

  • Reference
Modul:
VirtualMachineManager

Aktualizuje existující externí úlohu.

Syntaxe

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

Description

Rutina Set-SCExternalJob aktualizuje existující externí úlohy v nástroji Virtual Machine Manager (VMM). Můžete aktualizovat procento dokončení úlohy nebo nastavit stav úlohy na dokončenou nebo neúspěšnou.

Další informace o externích úlohách najdete v rutině New-SCExternalJob.

Příklady

Příklad 1: Nastavení externí úlohy na 15% dokončení

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

První příkaz načte objekt externí úlohy s názvem ExternalJob01 a uloží objekt do $ExternalJob proměnné.

Druhý příkaz nastaví hodnotu průběhu úlohy uložené v $ExternalJob na 15.

Příklad 2: Nastavení externí úlohy na dokončení

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

První příkaz získá objekt externí úlohy s názvem ExternalJob02 a uloží objekt do $ExternalJob proměnné.

Druhý příkaz nastaví stav úlohy uložené v $ExternalJob na dokončení a přidá informace o úloze.

Příklad 3: Nastavení externí úlohy na selhání

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

První příkaz získá externí objekt úlohy s názvem ExternalJob03 a uloží objekt do $ExternalJob proměnné.

Druhý příkaz nastaví stav úlohy uložené v $ExternalJob na selhání a přidá informace o úloze.

Parametry

-Completed

Nastaví stav externí úlohy na dokončenou.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Failed

Nastaví stav externí úlohy na neúspěšnou.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InfoMessage

Poskytuje informační zprávu pro externí úlohy.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Job

Určuje objekt úlohy VMM.

Typ:Task
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ProgressValue

Poskytuje procento dokončení průběhu externí úlohy.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

Task

Tato rutina vrátí objekt task.