about_Checkpoint-Workflow
DESCRIPTION COURTE
Décrit l’activité Checkpoint-Workflow, qui prend un point de contrôle dans un flux de travail.
DESCRIPTION DÉTAILLÉE
L’activité Checkpoint-Workflow prend un point de contrôle, qui enregistre l’état et les données dans le flux de travail. Si le flux de travail est suspendu ou interrompu, il peut être repris à partir du point de contrôle le plus récent, au lieu d’être redémarré.
L’activité Checkpoint-Workflow est valide uniquement dans un flux de travail.
SYNTAX
Workflow <Verb-Noun>
{
Checkpoint-Workflow
}
L’activité Checkpoint-Workflow n’accepte aucun paramètre, y compris les paramètres communs et les paramètres communs du flux de travail.
Vous pouvez placer le point de contrôle d’activité de point de contrôle n’importe où dans un flux de travail après l’instruction CmdletBinding ou Param. Toutefois, lors du placement de points de contrôle, tenez compte du coût de performances de la collecte des données et de l’écriture sur le disque sur l’ordinateur qui exécute le flux de travail.
Le temps nécessaire pour relancer une section du workflow s’il est interrompu est plus long que le temps nécessaire pour écrire l’état et les données du point de contrôle sur le disque.
Envisagez de prendre des points de contrôle après des étapes critiques afin que le flux de travail puisse être repris plutôt que redémarré. Par exemple, prenez un point de contrôle après les commandes qui ne sont pas idempotentes.
À PROPOS DES POINTS DE CONTRÔLE
Un point de contrôle est un instantané de l’état du workflow, avec les valeurs des variables et tout résultat généré jusqu’à ce stade. Tout est enregistré sur le disque.
Si un flux de travail est interrompu, intentionnellement ou involontairement, Windows PowerShell Workflow utilise automatiquement les données dans le point de contrôle le plus récent pour récupérer et reprendre le flux de travail.
Lorsque vous exécutez le flux de travail en tant que travail, par exemple à l’aide du paramètre commun du flux de travail AsJob, les points de contrôle de flux de travail sont conservés jusqu’à ce que vous supprimiez le travail, par exemple à l’aide de l’applet de commande Remove-Job. Sinon, les points de contrôle de flux de travail sont supprimés une fois le flux de travail terminé.
AUTRES TECHNIQUES DE POINT DE CONTRÔLE
Outre l’activité Checkpoint-Workflow, Windows PowerShell Workflow prend en charge d’autres techniques de point de contrôle, notamment les suivantes :
- Paramètre commun de workflow PSPersist
- Paramètre commun d’activité PSPersist
- Variable PSPersistPreference (dans un flux de travail)
Pour plus d’informations sur l’ajout d’un point de contrôle à un flux de travail, consultez « Comment ajouter des points de contrôle à un flux de travail ».
Exemples
Le flux de travail suivant inclut un appel à l’activité Checkpoint-Workflow après avoir terminé une fonction longue et un script qui partage des données.
Workflow Test-Workflow
{
$a = Invoke-LongRunningFunction
InlineScript { \\Server\Share\Get-DataPacks.ps1 $Using:a}
Checkpoint-Workflow
Invoke-LongRunningFunction
{
...
}
}
