about_Checkpoint-Workflow

Se aplica a: Windows PowerShell 3.0

TEMA

about_Checkpoint-Workflow

DESCRIPCIÓN BREVE

Describe la actividad Checkpoint-Workflow, que toma un punto de control en un flujo de trabajo.

DESCRIPCIÓN LARGA

La actividad Checkpoint-Workflow toma un punto de control, que guarda los datos y el estado del flujo de trabajo. 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.

La actividad Checkpoint-Workflow solo es válida en un flujo de trabajo.

SINTAXIS

    Workflow <Verb-Noun>
    {
        Checkpoint-Workflow
    }

La actividad Checkpoint-Workflow no acepta parámetros, incluidos los parámetros comunes y parámetros comunes de flujo de trabajo.

Puede colocar el punto de control Checkpoint-Activity en cualquier lugar de un flujo de trabajo después de la instrucción CmdletBinding o Param. Sin embargo, cuando coloque los puntos de control, tenga en cuenta el costo de rendimiento de la recopilación de datos y su escritura en disco en el equipo que ejecuta el flujo de trabajo.

Asegúrese de que el tiempo que se tarda en volver a ejecutar una sección del flujo de trabajo si se interrumpe es mayor que el tiempo que se tarda en escribir el estado del punto de control y los datos en el disco.

Considere la posibilidad de establecer puntos de control después de los pasos críticos, de forma que el flujo de trabajo pueda reanudarse en lugar de reiniciarse. Por ejemplo, capture un punto de control después de los comandos que no sean idempotentes.

ACERCA DE LOS PUNTOS DE CONTROL

Un punto de control es una instantánea del estado actual del flujo de trabajo, incluidos los valores actuales de las variables y todos los resultados generados hasta ese momento, que se guarda en el disco.

Si se interrumpe un flujo de trabajo, ya sea de forma intencionada o accidental, el flujo de trabajo de Windows PowerShell® usa automáticamente los datos del punto de control más reciente para recuperar y reanudar el flujo de trabajo.

Cuando se ejecuta el flujo de trabajo como un trabajo, por ejemplo, mediante el parámetro común de flujo de trabajo AsJob, los puntos de control de flujo de trabajo se mantienen hasta que se elimina el trabajo, como si se usara el cmdlet Remove-Job. De lo contrario, los puntos de control del flujo de trabajo se eliminan cuando se completa el flujo de trabajo.

OTRAS TÉCNICAS DE PUNTOS DE CONTROL

Además de la actividad Checkpoint-Workflow, el flujo de trabajo de Windows PowerShell admite otras técnicas de puntos de control, entre las que se incluyen las siguientes:

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

Para más información sobre cómo agregar un punto de control a un flujo de trabajo, consulte "Cómo agregar puntos de control a un flujo de trabajo".

EJEMPLOS

En el siguiente flujo de trabajo se incluye una llamada a la actividad Checkpoint-Workflow después de completar una función de ejecución prolongada y un script que compartan datos.

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

VEA TAMBIÉN

Cómo agregar puntos de control a un flujo de trabajo (https://go.microsoft.com/fwlink/?LinkId=261993)