about_Checkpoint-Workflow
КРАТКОЕ ОПИСАНИЕ
Описывает действие контрольного процесса, которое принимает контрольную точку в рабочем процессе.
ПОДРОБНОЕ ОПИСАНИЕ
Действие контрольного процесса принимает контрольную точку, которая сохраняет состояние и данные в рабочем процессе. Если рабочий процесс приостановлен или прерван, его можно возобновить с последней контрольной точки, а не перезапустить.
Действие контрольного процесса допустимо только в рабочем процессе.
SYNTAX
Workflow <Verb-Noun>
{
Checkpoint-Workflow
}
Действие контрольного процесса не принимает никаких параметров, включая общие параметры и общие параметры рабочего процесса.
Контрольную точку "Контрольная точка- действие" можно разместить в любом месте рабочего процесса после инструкции КомандлетBinding или Param. Однако при размещении контрольных точек следует учитывать затраты на производительность сбора данных и записи их на диск на компьютере, на котором выполняется рабочий процесс.
Убедитесь, что время, необходимое для перезапуска раздела рабочего процесса в случае его прерывания, больше, чем время, которое занимает запись состояния и данных контрольной точки на диск.
Рассмотрите возможность выполнения контрольных точек после критических шагов, чтобы рабочий процесс можно было возобновить, а не перезапустить. Например, выполните контрольную точку после команд, которые не являются идемпотентными.
СВЕДЕНИЯ О КОНТРОЛЬНЫХ ТОЧКАХ
Контрольная точка — это моментальный снимок текущего состояния рабочего процесса, включая текущие значения переменных и любые выходные данные, созданные на этот момент, который сохраняется на диске.
Если рабочий процесс прерывается намеренно или непреднамеренно, рабочий процесс Windows PowerShell автоматически использует данные в новейших контрольных точках для восстановления и возобновления рабочего процесса.
При запуске рабочего процесса в качестве задания, например с помощью общего параметра рабочего процесса AsJob, контрольные точки рабочего процесса сохраняются до удаления задания, например с помощью командлета Remove-Job. В противном случае контрольные точки рабочего процесса удаляются после завершения рабочего процесса.
ДРУГИЕ МЕТОДЫ КОНТРОЛЬНЫХ ТОЧЕК
Помимо действия контрольного процесса Рабочий процесс Windows PowerShell поддерживает другие методы контрольных точек, в том числе следующие:
- Общий параметр рабочего процесса PSPersist
- Общий параметр действия PSPersist
- Переменная PSPersistPreference (в рабочем процессе)
Дополнительные сведения о добавлении контрольной точки в рабочий процесс см. в разделе "Добавление контрольных точек в рабочий процесс".
Примеры
Следующий рабочий процесс включает вызов действия контрольного процесса после завершения длительной функции и скрипта, который предоставляет общий доступ к данным.
Workflow Test-Workflow
{
$a = Invoke-LongRunningFunction
InlineScript { \\Server\Share\Get-DataPacks.ps1 $Using:a}
Checkpoint-Workflow
Invoke-LongRunningFunction
{
...
}
}
См. также
PowerShell