about_Checkpoint-Workflow

Aplica-se a: Windows PowerShell 3.0

TÓPICO

about_Checkpoint-Workflow

DESCRIÇÃO BREVE

Descreve a atividade Checkpoint-Workflow, que usa um ponto de verificação em um fluxo de trabalho.

DESCRIÇÃO LONGA

A atividade Checkpoint-Workflow usa um ponto de verificação que salva o estado e os dados no fluxo de trabalho. Se o fluxo de trabalho for suspenso ou interrompido, ele poderá ser retomado do ponto de verificação mais recente, em vez de precisar ser reiniciado.

A atividade Checkpoint-Workflow somente é válida em um fluxo de trabalho.

SINTAXE

    Workflow <Verb-Noun>
    {
        Checkpoint-Workflow
    }

A atividade Checkpoint-Workflow não aceita nenhum parâmetro, incluindo parâmetros comuns e parâmetros comuns de fluxo de trabalho.

Você pode colocar o ponto de verificação da Checkpoint-Activity em qualquer lugar de um fluxo de trabalho após a instrução CmdletBinding ou Param. No entanto, ao colocar pontos de verificação, considere o custo de desempenho da coleta de dados e da sua gravação em disco no computador que está executando o fluxo de trabalho.

Certifique-se de que o tempo necessário para executar novamente uma seção do fluxo de trabalho, caso ela seja interrompida, seja maior que o tempo necessário para gravar o estado do ponto de verificação e os dados no disco.

Considere usar pontos de verificação após as etapas essenciais, para que o fluxo de trabalho possa ser retomado em vez de reiniciado. Por exemplo, use um ponto de verificação depois de comandos que não são idempotentes.

SOBRE PONTOS DE VERIFICAÇÃO

Um ponto de verificação é um instantâneo do estado atual do fluxo de trabalho, incluindo os valores atuais das variáveis e qualquer saída gerada até esse ponto, que salva esse estado em disco.

Se um fluxo de trabalho for interrompido, intencionalmente ou não, o fluxo de trabalho do Windows PowerShell® usa automaticamente os dados do ponto de verificação mais recente para recuperar e retomar o fluxo de trabalho.

Quando você executa o fluxo de trabalho como um trabalho, como usando o parâmetro comum de fluxo de trabalho AsJob, os pontos de verificação do fluxo de trabalho são mantidos até que você exclua o trabalho, por exemplo, usando o cmdlet Remove-Job. Caso contrário, os pontos de verificação do fluxo de trabalho são excluídos quando o fluxo de trabalho for concluído.

OUTRAS TÉCNICAS DE PONTO DE VERIFICAÇÃO

Além da atividade Checkpoint-Workflow, o fluxo de trabalho do Windows PowerShell dá suporte a outras técnicas de ponto de verificação, incluindo as seguintes:

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

Para obter mais informações sobre como adicionar um ponto de verificação a um fluxo de trabalho, consulte "Como adicionar pontos de verificação a um fluxo de trabalho".

EXEMPLOS

O fluxo de trabalho a seguir inclui uma chamada para a atividade Checkpoint-Workflow após a conclusão de uma função e um script de execução longa que compartilham dados.

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

CONSULTE TAMBÉM

Como adicionar pontos de verificação a um fluxo de trabalho (https://go.microsoft.com/fwlink/?LinkId=261993)