Depurar uma sequência de tarefas

  • Artigo

Aplica-se a: Gerenciador de Configurações (branch atual)

O depurador de sequência de tarefas é uma ferramenta de solução de problemas. Você implanta uma sequência de tarefas no modo de depuração em uma coleção pequena. Ele permite que você passe pela sequência de tarefas de maneira controlada para ajudar na solução de problemas e na investigação. O depurador atualmente é executado no mesmo dispositivo que o mecanismo de sequência de tarefas, não é um depurador remoto.

Dica

Esse recurso foi introduzido pela primeira vez na versão 1906 como um recurso de pré-lançamento. Começando com a versão 2203, ele não é mais um recurso de pré-lançamento.

Configuration Manager não habilita esse recurso opcional por padrão. Antes de usá-lo, você precisa habilitar esse recurso. Para obter mais informações, consulte Habilitar recursos opcionais das atualizações.

Pré-requisitos

  • Atualizar o cliente Configuration Manager no dispositivo de destino

  • Entre no dispositivo de destino como usuário no grupo administradores locais. O depurador só é executado para administradores.

  • Atualizar a imagem de inicialização associada à sequência de tarefas para garantir que ela tenha a versão mais recente do cliente

Iniciar a ferramenta

  1. No console Configuration Manager, acesse o workspace biblioteca de software, expanda Sistemas Operacionais e selecione Sequências de Tarefas.

  2. Selecione uma sequência de tarefas. No grupo Implantação da faixa de opções, selecione Depurar.

    Dica

    Como alternativa, defina a variável TSDebugMode como TRUE em uma coleção ou objeto de computador ao qual a sequência de tarefas é implantada. Qualquer dispositivo que tenha esse conjunto de variáveis colocará qualquer sequência de tarefas implantada nele no modo de depuração.

  3. Criar uma implantação de depuração. As configurações de implantação são as mesmas de uma implantação de sequência de tarefas normal. Para obter mais informações, consulte Implantar uma sequência de tarefas.

    Observação

    Você só pode selecionar uma pequena coleção para uma implantação de depuração. Ele exibe apenas coleções de dispositivos com 10 ou menos membros.

Use a variável de sequência de tarefas TSDebugOnError para iniciar automaticamente o depurador quando a sequência de tarefas retornar um erro. Para obter mais informações, consulte Variáveis de sequência de tarefas – TSDebugOnError.

Usar a ferramenta

Quando a sequência de tarefas é executada no dispositivo, a janela Depurador de Sequência de Tarefas é aberta de forma semelhante à seguinte captura de tela:

Captura de tela do Depurador de Sequência de Tarefas.

O depurador inclui os seguintes controles:

  • Etapa: na posição atual , execute apenas a próxima etapa na sequência de tarefas.

    Observação

    Quando a sequência de tarefas está no modo de depuração, se uma etapa retornar um erro fatal, a sequência de tarefas não falhará normalmente. Esse comportamento oferece a opção de tentar novamente uma etapa depois de fazer uma alteração externa.

  • Executar: Na posição atual , execute a sequência de tarefas normalmente até o final, o próximo ponto de interrupção ou se uma etapa falhar. Antes de usar essa ação, defina os pontos de interrupção com a ação Definir Interrupção .

  • Definir Atual: selecione uma etapa no depurador e selecione Definir Atual. Essa ação move o ponteiro atual para essa etapa. Essa ação permite ignorar etapas ou ir para trás.

    Aviso

    O depurador não considera o tipo de etapa quando você altera a posição atual na sequência. Algumas etapas podem definir variáveis de sequência de tarefas necessárias para avaliação da condição por etapas posteriores. Se ficar sem ordem, algumas etapas poderão falhar ou causar danos significativos a um dispositivo. Use essa opção por sua conta e risco.

  • Definir Pausa: selecione uma etapa no depurador e, em seguida , selecione Definir Interrupção. Essa ação adiciona um ponto de interrupção no depurador. Quando você executa a sequência de tarefas, ela para em um intervalo.

    • Antes de usar a ação Executar , defina pontos de interrupção.

    • Se você criar um ponto de interrupção no depurador e a sequência de tarefas reiniciar o computador, o depurador manterá seus pontos de interrupção após a reinicialização.

  • Limpar todas as quebras: remova todos os pontos de interrupção.

  • Arquivo de log: abre o arquivo de log da sequência de tarefas atual, smsts.log, com CMTrace. Você pode ver entradas de log quando o mecanismo de sequência de tarefas é "Aguardando o depurador".

  • Prompt do Cmd: no Windows PE, abre um prompt de comando.

  • Cancelar: feche o depurador e falhe na sequência de tarefas.

  • Desanexe e feche o depurador, mas a sequência de tarefas continua a ser executada normalmente.

A janela Variáveis de Sequência de Tarefas mostra os valores atuais para todas as variáveis no ambiente de sequência de tarefas. Para obter mais informações, consulte Variáveis de sequência de tarefas. Se você usar a etapa Definir Variável de Sequência de Tarefas com a opção De não exibir esse valor, o depurador não exibirá o valor da variável. Você não pode editar os valores de variável no depurador.

Observação

Algumas variáveis de sequência de tarefas são apenas para uso interno e não estão listadas na documentação de referência.

O depurador de sequência de tarefas continua a ser executado após uma etapa Reiniciar Computador . O depurador mantém seus pontos de interrupção após a reinicialização. Embora a sequência de tarefas possa não exigir isso, já que o depurador requer interação do usuário, você precisa entrar no Windows para continuar. Se você não entrar após uma hora para continuar a depuração, a sequência de tarefas falhará.

Ele também entra em uma sequência de tarefas filho com a etapa Executar Sequência de Tarefas . A janela de depurador mostra as etapas da sequência de tarefas filho junto com a sequência de tarefas principal.

Problemas conhecidos

Se você direcionar uma implantação normal e uma implantação de depuração para o mesmo dispositivo por meio de várias implantações, o depurador de sequência de tarefas poderá não ser iniciado.

Confira também