Freigeben über

Informationen über_Checkpoint-Workflow

  • Artikel

KURZE BESCHREIBUNG

Beschreibt die Prüfpunkt-Workflow-Aktivität, die einen Prüfpunkt in einem Workflow akzeptiert.

LANGE BESCHREIBUNG

Die Prüfpunkt-Workflow-Aktivität akzeptiert einen Prüfpunkt, der Zustand und Daten im Workflow speichert. Wenn der Workflow angehalten oder unterbrochen wird, kann er vom letzten Prüfpunkt fortgesetzt werden, anstatt neu gestartet werden zu müssen.

Die Prüfpunkt-Workflow-Aktivität ist nur in einem Workflow gültig.

SYNTAX

Workflow <Verb-Noun>
{
    Checkpoint-Workflow
}

Die Aktivität "Prüfpunkt-Workflow" akzeptiert keine Parameter, einschließlich allgemeiner Parameter und allgemeiner Workflowparameter.

Sie können den Prüfpunkt "Checkpoint-Activity" an einer beliebigen Stelle in einem Workflow nach der CmdletBinding- oder Param-Anweisung platzieren. Berücksichtigen Sie beim Platzieren von Prüfpunkten jedoch die Leistungskosten beim Sammeln der Daten und schreiben sie auf dem Datenträger auf dem Computer, auf dem der Workflow ausgeführt wird.

Sie können davon ausgehen, dass der Zeitaufwand für die erneute Ausführung eines unterbrochenen Workflowabschnitts höher ist als der Zeitaufwand für das Schreiben von Prüfpunktstatus und -daten auf den Datenträger.

Erwägen Sie, Prüfpunkte nach kritischen Schritten auszuführen, damit der Workflow fortgesetzt werden kann, anstatt neu zu starten. Nehmen Sie beispielsweise einen Prüfpunkt nach Befehlen, die nicht idempotent sind.

INFORMATIONEN ZU PRÜFPUNKTEN

Ein Prüfpunkt ist eine Momentaufnahme des aktuellen Zustands des Workflows, einschließlich der aktuellen Werte von Variablen, und beliebiger, bis zu diesem Punkt generierter Ausgaben, die auf dem Datenträger gespeichert wird.

Wenn ein Workflow absichtlich oder unbeabsichtigt unterbrochen wird, verwendet Windows PowerShell-Workflow automatisch die Daten im neuesten Prüfpunkt, um den Workflow wiederherzustellen und fortzusetzen.

Wenn Sie den Workflow als Auftrag ausführen, z. B. mithilfe des allgemeinen AsJob-Workflows, werden die Workflowprüfpunkte beibehalten, bis Sie den Auftrag löschen, z. B. mithilfe des Cmdlets "Remove-Job". Andernfalls werden Workflowprüfpunkte gelöscht, wenn der Workflow abgeschlossen ist.

ANDERE PRÜFPUNKTTECHNIKEN

Zusätzlich zur Prüfpunkt-Workflow-Aktivität unterstützt Windows PowerShell-Workflow andere Prüfpunkttechniken, einschließlich der folgenden:

  • Allgemeiner Workflowparameter "PSPersist"
  • Allgemeiner Aktivitätsparameter "PSPersist"
  • PSPersistPreference-Variable (in einem Workflow)

Weitere Informationen zum Hinzufügen eines Prüfpunkts zu einem Workflow finden Sie unter "So wird's gemacht: Hinzufügen von Prüfpunkten zu einem Workflow".

Beispiele

Der folgende Workflow enthält einen Aufruf der Checkpoint-Workflow-Aktivität nach Abschluss einer lang ausgeführten Funktion und eines Skripts, das Daten gemeinsam verwendet.

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

    Invoke-LongRunningFunction
    {
        ...
    }
}

Weitere Informationen