about_Checkpoint-Workflow

  • Artikel

KORTE BESCHRIJVING

Beschrijft de activiteit Controlepunt-werkstroom, die een controlepunt in een werkstroom neemt.

LANGE BESCHRIJVING

De activiteit Controlepunt-werkstroom maakt gebruik van een controlepunt, waarmee status en gegevens in de werkstroom worden opgeslagen. Als de werkstroom wordt onderbroken of onderbroken, kan deze worden hervat vanaf het meest recente controlepunt in plaats van opnieuw te worden opgestart.

De activiteit Controlepuntwerkstroom is alleen geldig in een werkstroom.

SYNTAXIS

Workflow <Verb-Noun>
{
    Checkpoint-Workflow
}

De activiteit Controlepunt-werkstroom accepteert geen parameters, waaronder algemene parameters en gemeenschappelijke werkstroomparameters.

U kunt het controlepunt Checkpoint-Activity overal in een werkstroom plaatsen na de cmdletBinding- of Param-instructie. Houd bij het plaatsen van controlepunten echter rekening met de prestatiekosten voor het verzamelen van de gegevens en het schrijven ervan naar de schijf op de computer waarop de werkstroom wordt uitgevoerd.

Zorg ervoor dat de tijd die nodig is voor het opnieuw uitvoeren van een sectie van de werkstroom groter is dan de tijd die nodig is om de status van het controlepunt en de gegevens naar de schijf te schrijven.

Overweeg controlepunten te nemen na kritieke stappen, zodat de werkstroom kan worden hervat in plaats van opnieuw te worden opgestart. Neem bijvoorbeeld een controlepunt na opdrachten die niet idempotent zijn.

OVER CONTROLEPUNTEN

Een controlepunt is een momentopname van de huidige status van de werkstroom, met inbegrip van de huidige waarden van variabelen en uitvoer die tot dat punt is gegenereerd, en slaat het op schijf op.

Als een werkstroom opzettelijk of onbedoeld wordt onderbroken, gebruikt Windows PowerShell Workflow automatisch de gegevens in het nieuwste controlepunt om de werkstroom te herstellen en te hervatten.

Wanneer u de werkstroom uitvoert als een taak, zoals met behulp van de algemene parameter voor de AsJob-werkstroom, worden de controlepunten van de werkstroom bewaard totdat u de taak verwijdert, zoals met behulp van de cmdlet Remove-Job. Anders worden controlepunten voor werkstromen verwijderd wanneer de werkstroom is voltooid.

ANDERE CONTROLEPUNTENTECHNIEKEN

Naast de activiteit Checkpoint-Workflow biedt Windows PowerShell Workflow ondersteuning voor andere controlepuntentechnieken, waaronder de volgende:

  • Algemene parameter psPersist-werkstroom
  • Algemene parameter psPersist-activiteit
  • PSPersistPreference-variabele (in een werkstroom)

Zie 'Controlepunten toevoegen aan een werkstroom' voor meer informatie over het toevoegen van een controlepunt aan een werkstroom.

Voorbeelden

De volgende werkstroom bevat een aanroep van de activiteit Checkpoint-Workflow nadat een langlopende functie en een script waarmee gegevens worden gedeeld.

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

    Invoke-LongRunningFunction
    {
        ...
    }
}

Zie ook