Acerca de Checkpoint-WorkflowAbout Checkpoint-Workflow

DESCRIPCIÓN BREVESHORT DESCRIPTION

Describe la actividad Checkpoint-Workflow, que toma un punto de control en un flujo de trabajo.Describes the Checkpoint-Workflow activity, which takes a checkpoint in a workflow.

DESCRIPCIÓN LARGALONG DESCRIPTION

La actividad Checkpoint-Workflow toma un punto de control, que guarda el estado y los datos en el flujo de trabajo.The Checkpoint-Workflow activity takes a checkpoint, which saves state and data in the workflow. Si el flujo de trabajo se suspende o se interrumpe, se puede reanudar desde el punto de control más reciente, en lugar de tener que reiniciarse.If the workflow is suspended or interrupted, it can be resumed from the most recent checkpoint, rather than having to be restarted.

La actividad Checkpoint-Workflow solo es válida en un flujo de trabajo.The Checkpoint-Workflow activity is valid only in a workflow.

SINTAXISSYNTAX

Workflow <Verb-Noun>
{
    Checkpoint-Workflow
}

La actividad Checkpoint-Workflow no acepta ningún parámetro, incluidos los parámetros comunes y los parámetros comunes de flujo de trabajo.The Checkpoint-Workflow activity does not accept any parameters, including common parameters and workflow common parameters.

Puede colocar el punto de control de Checkpoint-Activity en cualquier parte de un flujo de trabajo después de la instrucción CmdletBinding o param.You can place the Checkpoint-Activity checkpoint anywhere in a workflow after the CmdletBinding or Param statement. Sin embargo, al colocar los puntos de control, tenga en cuenta el costo de rendimiento de recopilar los datos y escribirlos en el disco en el equipo que ejecuta el flujo de trabajo.However, when placing checkpoints, consider the performance cost of collecting the data and writing it to disk on the computer that is running the workflow.

Asegúrate de que el tiempo necesario para volver a ejecutar una sección del flujo de trabajo si esta se interrumpe es mayor que el tiempo necesario para escribir el estado y los datos del punto de control en disco.Be sure that the time it takes to rerun a section of the workflow if it is interrupted is greater than the time it takes to write the checkpoint state and data to disk.

Considere la posibilidad de realizar puntos de control después de los pasos críticos para que el flujo de trabajo se pueda reanudar en lugar de reiniciarse.Consider taking checkpoints after critical steps so the workflow can be resumed rather than restarted. Por ejemplo, tome un punto de control después de los comandos que no son idempotente.For example, take a checkpoint after commands that are not idempotent.

ACERCA DE LOS PUNTOS DE CONTROLABOUT CHECKPOINTS

Un punto de control es una instantánea del estado actual del flujo de trabajo (incluidos los valores actuales de las variables) y cualquier resultado generado hasta ese momento, que lo guarda en disco.A checkpoint is a snapshot of the current state of the workflow, including the current values of variables, and any output generated up to that point, and it saves it to disk.

Si se interrumpe un flujo de trabajo, de forma intencionada o involuntaria, el flujo de trabajo de Windows PowerShell usa automáticamente los datos en el punto de comprobación más reciente para recuperar y reanudar el flujo de trabajo.If a workflow is interrupted, intentionally or unintentionally, Windows PowerShell Workflow automatically uses the data in newest checkpoint to recover and resume the workflow.

Al ejecutar el flujo de trabajo como un trabajo, como mediante el uso del parámetro común de flujo de trabajo AsJob, los puntos de control del flujo de trabajo se conservan hasta que se elimina el trabajo, por ejemplo, mediante el cmdlet Remove-Job.When you run the workflow as a job, such as by using the AsJob workflow common parameter, the workflow checkpoints are retained until you delete the job, such as by using the Remove-Job cmdlet. De lo contrario, los puntos de control de flujo de trabajo se eliminan cuando se completa el flujo de trabajo.Otherwise, workflow checkpoints are deleted when the workflow completes.

OTRAS TÉCNICAS DE PUNTOS DE COMPROBACIÓNOTHER CHECKPOINTING TECHNIQUES

Además de la actividad Checkpoint-Workflow, el flujo de trabajo de Windows PowerShell admite otras técnicas de puntos de comprobación, entre las que se incluyen las siguientes:In addition to the Checkpoint-Workflow activity, Windows PowerShell Workflow supports other checkpointing techniques, including the following:

  • Parámetro común de flujo de trabajo PSPersistPSPersist workflow common parameter
  • Parámetros comunes de actividades PSPersistPSPersist activity common parameter
  • Variable PSPersistPreference (en un flujo de trabajo)PSPersistPreference variable (in a workflow)

Para obtener más información sobre cómo agregar un punto de control a un flujo de trabajo, vea el tema sobre cómo agregar puntos de control a un flujo de trabajo.For more information about adding a checkpoint to a workflow, see "How to Add Checkpoints to a Workflow."

EJEMPLOSEXAMPLES

El siguiente flujo de trabajo incluye una llamada a la actividad Checkpoint-Workflow después de completar una función de ejecución prolongada y un script que comparte datos.The following workflow includes a call to the Checkpoint-Workflow activity after completing a long-running function and a script that share data.

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

    Invoke-LongRunningFunction
    {
        ...
    }
}

CONSULTE TAMBIÉNSEE ALSO

Escribir un flujo de trabajo de Windows PowerShellWriting a Windows PowerShell Workflow