Set-SCExternalJob
Met à jour un travail externe existant.
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
La cmdlet Set-SCExternalJob met à jour les travaux externes existants dans Virtual Machine Manager (VMM). Vous pouvez mettre à jour le pourcentage terminé du travail, ou définir l’état du travail sur terminé ou ayant échoué.
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 15La 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 sur 15.
Exemple 2 : Définir un travail externe sur terminé
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éfinition d’un travail externe sur l’é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 a échoué et ajoute des informations sur le travail.
Paramètres
-Completed
Définit l’état d’un travail externe à terminer.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Failed
Définit l’état d’un travail externe sur l’échec.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InfoMessage
Fournit un message d’information pour les travaux externes.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Job
Spécifie un objet de travail VMM.
| Type: | Task |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-ProgressValue
Fournit le pourcentage d’achèvement de la progression d’un travail externe.
| Type: | Int32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Sorties
Task
Cette applet de commande retourne un objet Task.