about_Checkpoint-Workflow
KRÁTKÝ POPIS
Popisuje aktivitu kontrolního bodu pracovního postupu, která přebírá kontrolní bod v pracovním postupu.
DLOUHÝ POPIS
Aktivita Checkpoint-Workflow přebírá kontrolní bod, který ukládá stav a data v pracovním postupu. Pokud je pracovní postup pozastavený nebo přerušený, můžete ho obnovit z nejnovějšího kontrolního bodu a nemusíte ho restartovat.
Aktivita Checkpoint-Workflow je platná pouze v pracovním postupu.
SYNTAXE
Workflow <Verb-Noun>
{
Checkpoint-Workflow
}
Aktivita Checkpoint-Workflow nepřijímá žádné parametry, včetně běžných parametrů a běžných parametrů pracovního postupu.
Kontrolní bod aktivity kontrolního bodu můžete umístit kdekoli v pracovním postupu po příkazu RutinBinding nebo Param. Při umísťování kontrolních bodů však zvažte náklady na výkon při shromažďování dat a zápisu na disk v počítači, na kterém běží pracovní postup.
Ujistěte se, že doba potřebnou k opětovnému spuštění oddílu pracovního postupu, pokud je přerušená, větší než doba potřebnou k zápisu stavu kontrolního bodu a dat na disk.
Zvažte provedení kontrolních bodů po kritických krocích, aby se pracovní postup mohl obnovit místo restartování. Například za příkazy, které nejsou idempotentní, vezměte kontrolní bod.
INFORMACE O KONTROLNÍCH BODECH
Kontrolní bod je snímek aktuálního stavu pracovního postupu včetně aktuálních hodnot proměnných a všech výstupů vygenerovaných až do tohoto bodu a uloží ho na disk.
Pokud dojde k přerušení pracovního postupu záměrně nebo neúmyslně, pracovní postup Windows PowerShellu automaticky použije data v nejnovějším kontrolním bodu k obnovení a obnovení pracovního postupu.
Když pracovní postup spustíte jako úlohu, například pomocí společného parametru pracovního postupu AsJob, zachovají se kontrolní body pracovního postupu, dokud úlohu neodstraníte, například pomocí rutiny Remove-Job. Jinak se kontrolní body pracovního postupu po dokončení pracovního postupu odstraní.
DALŠÍ TECHNIKY VYTVÁŘENÍ KONTROLNÍCH BODŮ
Kromě aktivity Checkpoint-Workflow podporuje pracovní postup Windows PowerShellu další techniky vytváření kontrolních bodů, včetně následujících:
- Běžný parametr pracovního postupu PSPersist
- Běžný parametr aktivity PSPersist
- Proměnná PSPersistPreference (v pracovním postupu)
Další informace o přidání kontrolního bodu do pracovního postupu najdete v tématu Postup přidání kontrolních bodů do pracovního postupu.
Příklady
Následující pracovní postup zahrnuje volání aktivity Checkpoint-Workflow po dokončení dlouhotrvající funkce a skriptu, který sdílí data.
Workflow Test-Workflow
{
$a = Invoke-LongRunningFunction
InlineScript { \\Server\Share\Get-DataPacks.ps1 $Using:a}
Checkpoint-Workflow
Invoke-LongRunningFunction
{
...
}
}
