about_Checkpoint-Workflow

Rövid leírás

A Checkpoint-Workflow tevékenységet ismerteti, amely egy ellenőrzőpontot vesz fel egy munkafolyamatban.

Hosszú leírás

A Checkpoint-Workflow tevékenység egy ellenőrzőpontot vesz fel, amely menti az állapotot és az adatokat a munkafolyamatban. Ha a munkafolyamat fel van függesztve vagy megszakítva, a legutóbbi ellenőrzőpontról folytatható ahelyett, hogy újra kellene indítani.

A Checkpoint-Workflow tevékenység csak egy munkafolyamatban érvényes.

Szemantika

workflow <Verb-Noun> {
    Checkpoint-Workflow
}

A Checkpoint-Workflow tevékenység nem fogad el paramétereket, beleértve a gyakori paramétereket és a munkafolyamat gyakori paramétereit.

A Checkpoint-Activity ellenőrzőpontot bárhol elhelyezheti egy munkafolyamatban a CmdletBinding vagy param utasítás után. Az ellenőrzőpontok elhelyezésekor azonban vegye figyelembe az adatok gyűjtésének és a munkafolyamatot futtató számítógépen lévő lemezre történő írásának teljesítményköltségét.

Győződjön meg arról, hogy a munkafolyamat egy szakaszának újrafuttatásához szükséges idő nagyobb, mint az ellenőrzőpont állapotának és adatainak lemezre írása.

Fontolja meg az ellenőrzőpontok kritikus lépések utáni ellenőrzését, hogy a munkafolyamat újraindulása helyett újra lehessen indítani. Tegyük fel például, hogy a nem idempotens parancsok után egy ellenőrzőpontot kell létrehoznia.

Tudnivalók az ellenőrzőpontokról

Az ellenőrzőpont a munkafolyamat aktuális állapotának pillanatképe, beleértve a változók aktuális értékeit és az eddig létrehozott kimeneteket, és lemezre menti.

Ha egy munkafolyamatot szándékosan vagy akaratlanul megszakítanak, a Windows PowerShell-munkafolyamat automatikusan a legújabb ellenőrzőponton lévő adatokat használja a munkafolyamat helyreállításához és folytatásához.

Amikor feladatként futtatja a munkafolyamatot, például az AsJob munkafolyamat közös paraméterének használatával, a munkafolyamat ellenőrzőpontjai mindaddig megmaradnak, amíg el nem törli a feladatot, például a Feladat eltávolítása parancsmag használatával. Ellenkező esetben a munkafolyamat-ellenőrzőpontok törlődnek a munkafolyamat befejezésekor.

Egyéb ellenőrzőpontozási technikák

A Checkpoint-Workflow tevékenység mellett a Windows PowerShell-munkafolyamat más ellenőrzőpont-technikákat is támogat, többek között az alábbiakat:

• PSPersist munkafolyamat gyakori paramétere
• PSPersist tevékenység gyakori paramétere
• PSPersistPreference változó (munkafolyamatban)

Az ellenőrzőpontok munkafolyamathoz való hozzáadásáról az "Ellenőrzőpontok hozzáadása munkafolyamathoz" című témakörben talál további információt.

Példák

Az alábbi munkafolyamat egy hosszú ideig futó függvény és egy adatokat megosztó szkript befejezése után meghívja a Checkpoint-Workflow tevékenységet.

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

    Invoke-LongRunningFunction {
        ...
    }
}

Kapcsolódó információk

• Windows PowerShell-munkafolyamat írása