Sdílet prostřednictvím

Set-SCExternalJob

  • Reference
Modul:
VirtualMachineManager

Aktualizace existující externí úlohu.

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

Rutina Set-SCExternalJob aktualizuje existující externí úlohy v nástroji Virtual Machine Manager (VMM). Procento dokončení úlohy můžete aktualizovat nebo nastavit stav úlohy na dokončení nebo selhání.

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

Příklady

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

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

První příkaz získá 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í dokončení externí úlohy

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 proměnné $ExternalJob.

Druhý příkaz nastaví stav úlohy uložené v $ExternalJob k 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á objekt externí ú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čení.

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

-Failed

Nastaví stav externí úlohy na selhání.

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

-InfoMessage

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

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

-Job

Určuje objekt úlohy VMM.

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

-ProgressValue

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

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

Výstupy

Task

Tato rutina vrátí objekt Task .