about_Checkpoint-Workflow

Назначение: Windows PowerShell 3.0

РАЗДЕЛ

about_Checkpoint-Workflow

КРАТКОЕ ОПИСАНИЕ

Этот раздел содержит описание действия Checkpoint-Workflow, которое принимает контрольную точку в рабочем процессе.

ПОДРОБНОЕ ОПИСАНИЕ

Действие Checkpoint-Workflow принимает контрольную точку, которая сохраняет состояние и данные в рабочем процессе. Если рабочий процесс приостановлен или прерван, его можно возобновить с последней контрольной точки, а не перезапускать.

Действие Checkpoint-Workflow допустимо только в рабочем процессе.

СИНТАКСИС

    Workflow <Verb-Noun>
    {
        Checkpoint-Workflow
    }

Действие Checkpoint-Workflow не принимает параметры, включая общие параметры и общие параметры рабочих процессов.

Действие Checkpoint-Workflow можно разместить в любом месте в рабочем процессе после оператора CmdletBinding или Param. Однако при размещении контрольных точек учитывайте потери производительности на сбор данных и их запись на диск на компьютере, на котором выполняется рабочий процесс.

Убедитесь, что время, необходимое для повторного выполнения части рабочего процесса, если он будет прерван, больше времени, необходимого для записи состояния контрольной точки и данных на диск.

Рассмотрите возможность создания контрольных точек после важных этапов, чтобы рабочий процесс можно было возобновить вместо перезапуска. Например, создайте контрольную точку после команд, которые не являются идемпотентными.

СВЕДЕНИЯ О КОНТРОЛЬНЫХ ТОЧКАХ

Контрольная точка представляет собой моментальный снимок текущего состояния рабочего процесса, включая текущие значения переменных, и все выходные данные, созданные до этого момента. При этом эти данные записываются на диск.

Если рабочий процесс прерывается намеренно или непреднамеренно Windows PowerShell® Workflow автоматически использует данные в последней контрольной точки для восстановления и возобновления рабочего процесса.

При запуске рабочего процесса в качестве задания, например с помощью общего параметра рабочего процесса AsJob, контрольные точки рабочего процесса сохраняются до удаления задания, например с помощью командлета Remove-Job. В противном случае контрольные точки рабочего процесса удаляются после завершения рабочего процесса.

ДРУГИЕ МЕТОДЫ РАБОТЫ С КОНТРОЛЬНЫМИ ТОЧКАМИ

В дополнение к действию Checkpoint-Workflow, Windows PowerShell Workflow поддерживает другие методы работы с контрольными точками, включая следующие:

        -- PSPersist workflow common parameter
        -- PSPersist activity common parameter
        -- PSPersistPreference variable (in a workflow)

Дополнительные сведения о добавлении контрольной точки в рабочий процесс см. в разделе "Как добавить контрольные точки в рабочий процесс".

ПРИМЕРЫ

Следующий рабочий процесс содержит вызов действия Checkpoint-Workflow после завершения длительной функции и скрипта, который совместно используют данные.

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

СМ. ТАКЖЕ

Как добавить контрольные точки в рабочий процесс (https://go.microsoft.com/fwlink/?LinkId=261993)