Partager via

Set-SCExternalJob

  • Référence
Module:
VirtualMachineManager

Mises à jour un travail externe existant.

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

L’applet de commande Set-SCExternalJob met à jour des travaux externes existants dans Virtual Machine Manager (VMM). Vous pouvez mettre à jour le pourcentage complet du travail ou définir l’état du travail à terminer ou échouer.

Pour plus d’informations sur les travaux externes, consultez l’applet de commande New-SCExternalJob .

Exemples

Exemple 1 : Définir un travail externe sur 15 % terminé

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

La première commande obtient l’objet de travail externe nommé ExternalJob01 et stocke l’objet dans la variable $ExternalJob.

La deuxième commande définit la valeur de progression du travail stocké dans $ExternalJob à 15.

Exemple 2 : Définir un travail externe à terminer

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

La première commande obtient l’objet de travail externe nommé ExternalJob02 et stocke l’objet dans la variable $ExternalJob.

La deuxième commande définit l’état du travail stocké dans $ExternalJob à terminer et ajoute des informations sur le travail.

Exemple 3 : Définir un travail externe sur échec

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

La première commande obtient l’objet de travail externe nommé ExternalJob03 et stocke l’objet dans la variable $ExternalJob.

La deuxième commande définit l’état du travail stocké dans $ExternalJob pour échouer et ajoute des informations sur le travail.

Paramètres

-Completed

Définit l’état d’un travail externe à terminer.

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

-Failed

Définit l’état d’un travail externe ayant échoué.

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

-InfoMessage

Fournit un message d’information pour les travaux externes.

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

-Job

Spécifie un objet travail VMM.

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

-ProgressValue

Fournit le pourcentage complet de la progression d’un travail externe.

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

Sorties

Task

Cette applet de commande retourne un objet Task .