Informazioni su Checkpoint-WorkflowAbout Checkpoint-Workflow

DESCRIZIONE BREVESHORT DESCRIPTION

Descrive l'attività Checkpoint-Workflow, che accetta un checkpoint in un flusso di lavoro.Describes the Checkpoint-Workflow activity, which takes a checkpoint in a workflow.

DESCRIZIONE LUNGALONG DESCRIPTION

L'attività Checkpoint-Workflow accetta un checkpoint, che consente di salvare lo stato e i dati nel flusso di lavoro.The Checkpoint-Workflow activity takes a checkpoint, which saves state and data in the workflow. Se il flusso di lavoro viene sospeso o interrotto, è possibile riprenderlo dal checkpoint più recente, anziché dover essere riavviato.If the workflow is suspended or interrupted, it can be resumed from the most recent checkpoint, rather than having to be restarted.

L'attività Checkpoint-Workflow è valida solo in un flusso di lavoro.The Checkpoint-Workflow activity is valid only in a workflow.

SYNTAXSYNTAX

Workflow <Verb-Noun>
{
    Checkpoint-Workflow
}

L'attività Checkpoint-Workflow non accetta alcun parametro, inclusi i parametri comuni e i parametri comuni del flusso di lavoro.The Checkpoint-Workflow activity does not accept any parameters, including common parameters and workflow common parameters.

È possibile posizionare il Checkpoint Checkpoint-Activity in un punto qualsiasi di un flusso di lavoro dopo l'istruzione cmdlet o Param.You can place the Checkpoint-Activity checkpoint anywhere in a workflow after the CmdletBinding or Param statement. Tuttavia, quando si posizionano i checkpoint, prendere in considerazione il costo delle prestazioni della raccolta dei dati e la scrittura su disco nel computer che esegue il flusso di lavoro.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.

Assicurarsi che il tempo impiegato per eseguire di nuovo una sezione del flusso di lavoro interrotto sia maggiore del tempo necessario per scrivere lo stato e i dati del checkpoint nel 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.

Si consiglia di prendere i checkpoint dopo i passaggi critici, in modo che il flusso di lavoro possa essere ripreso anziché riavviato.Consider taking checkpoints after critical steps so the workflow can be resumed rather than restarted. Ad esempio, eseguire un checkpoint dopo i comandi che non sono idempotente.For example, take a checkpoint after commands that are not idempotent.

INFORMAZIONI SUI CHECKPOINTABOUT CHECKPOINTS

Un checkpoint è uno snapshot dello stato corrente del flusso di lavoro che include e salva su disco i valori correnti delle variabili e qualsiasi output generato fino a quel punto.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.

Se un flusso di lavoro viene interrotto, intenzionalmente o involontariamente, il flusso di lavoro di Windows PowerShell usa automaticamente i dati nel checkpoint più recente per ripristinare e riprendere il flusso di lavoro.If a workflow is interrupted, intentionally or unintentionally, Windows PowerShell Workflow automatically uses the data in newest checkpoint to recover and resume the workflow.

Quando si esegue il flusso di lavoro come processo, ad esempio utilizzando il parametro comune del flusso di lavoro AsJob, i checkpoint del flusso di lavoro vengono mantenuti fino a quando non si elimina il processo, ad esempio utilizzando il 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. In caso contrario, i checkpoint del flusso di lavoro vengono eliminati quando il flusso di lavoro viene completato.Otherwise, workflow checkpoints are deleted when the workflow completes.

ALTRE TECNICHE DI CHECKPOINTOTHER CHECKPOINTING TECHNIQUES

Oltre all'attività Checkpoint-Workflow, il flusso di lavoro di Windows PowerShell supporta altre tecniche di checkpoint, incluse le seguenti:In addition to the Checkpoint-Workflow activity, Windows PowerShell Workflow supports other checkpointing techniques, including the following:

  • Parametro comune del flusso di lavoro PSPersistPSPersist workflow common parameter
  • Parametro comune di attività PSPersistPSPersist activity common parameter
  • Variabile PSPersistPreference (in un flusso di lavoro)PSPersistPreference variable (in a workflow)

Per ulteriori informazioni sull'aggiunta di un checkpoint a un flusso di lavoro, vedere "come aggiungere Checkpoint a un flusso di lavoro".For more information about adding a checkpoint to a workflow, see "How to Add Checkpoints to a Workflow."

ESEMPIEXAMPLES

Il flusso di lavoro seguente include una chiamata all'attività Checkpoint-Workflow dopo il completamento di una funzione a esecuzione prolungata e di uno script che condivide i dati.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
    {
        ...
    }
}

VEDERE ANCHESEE ALSO

Come scrivere un flusso di lavoro di Windows PowerShellWriting a Windows PowerShell Workflow