about_Checkpoint arbetsflöde

KORT BESKRIVNING

Beskriver Checkpoint-Workflow aktivitet, som tar en kontrollpunkt i ett arbetsflöde.

LÅNG BESKRIVNING

Den Checkpoint-Workflow aktiviteten tar en kontrollpunkt som sparar tillstånd och data i arbetsflödet. Om arbetsflödet pausas eller avbryts kan det återupptas från den senaste kontrollpunkten i stället för att behöva startas om.

Den Checkpoint-Workflow aktiviteten är endast giltig i ett arbetsflöde.

SYNTAX

Workflow <Verb-Noun>
{
    Checkpoint-Workflow
}

Den Checkpoint-Workflow aktiviteten accepterar inte några parametrar, inklusive vanliga parametrar och vanliga arbetsflödesparametrar.

Du kan placera Checkpoint-Activity kontrollpunkt var som helst i ett arbetsflöde efter instruktionen CmdletBinding eller Param. Men när du placerar kontrollpunkter bör du tänka på prestandakostnaden för att samla in data och skriva dem till disken på den dator som kör arbetsflödet.

Se till att den tid det tar att köra om ett avsnitt i arbetsflödet om det avbryts är större än den tid det tar att skriva kontrollpunktstillståndet och data till disken.

Överväg att utföra kontrollpunkter efter kritiska steg så att arbetsflödet kan återupptas i stället för att startas om. Ta till exempel en kontrollpunkt efter kommandon som inte är idempotenter.

OM KONTROLLPUNKTER

En kontrollpunkt är en ögonblicksbild av arbetsflödets aktuella tillstånd, inklusive aktuella värden för variabler och eventuella utdata som genereras fram till den punkten, och den sparas på disken.

Om ett arbetsflöde avbryts avsiktligt eller oavsiktligt använder Windows PowerShell Workflow automatiskt data i den senaste kontrollpunkten för att återställa och återuppta arbetsflödet.

När du kör arbetsflödet som ett jobb, till exempel med hjälp av den gemensamma parametern för AsJob-arbetsflödet, behålls kontrollpunkterna för arbetsflödet tills du tar bort jobbet, till exempel genom att använda cmdleten Remove-Job. Annars tas kontrollpunkter för arbetsflödet bort när arbetsflödet har slutförts.

ANDRA KONTROLLPUNKTSTEKNIKER

Förutom aktiviteten Checkpoint-Workflow stöder Windows PowerShell Workflow andra kontrollpunktstekniker, inklusive följande:

  • Gemensam parameter för PSPersist-arbetsflöde
  • Gemensam PSPersist-aktivitetsparameter
  • Variabeln PSPersistPreference (i ett arbetsflöde)

Mer information om hur du lägger till en kontrollpunkt i ett arbetsflöde finns i "Så här lägger du till kontrollpunkter i ett arbetsflöde".

Exempel

Följande arbetsflöde innehåller ett anrop till Checkpoint-Workflow aktivitet när du har slutfört en långvarig funktion och ett skript som delar data.

Workflow Test-Workflow
{
    $a = Invoke-LongRunningFunction
    InlineScript { \\Server\Share\Get-DataPacks.ps1 $Using:a}
    Checkpoint-Workflow

    Invoke-LongRunningFunction
    {
        ...
    }
}

Se även