Use as informações seguintes para depurar um script em etapas.

Inspeção (stepping) é o processo de executar uma instrução de cada vez. Você pode parar em uma linha de código e examinar os valores de variáveis e o estado do sistema. A tabela seguinte descreve tarefas comuns de depuração como passo a passo simples, passo a passo detalhado e retornar passo a passo.

Tarefa de depuração

Descrição

Como realizar isto no PowerShell ISE

Passo a Passo Detalhado

Executa a instrução atual e, em seguida, para na próxima instrução. Se a instrução atual for uma função ou chamada de script, o depurador fará uma depuração detalhada naquela função ou script; caso contrário parará na próxima instrução.

No Painel de Comando, digite E e pressione ENTER ou, no menu Depurar, clique em Passo a Passo Detalhado.

Passo a Passo Simples

Executa a instrução atual e, em seguida, para na próxima instrução. Se a instrução atual for uma função ou chamada de script, o depurador executará a função ou o script inteiro e parará na próxima instrução após a chamada de função.

No Painel de Comando, digite M e pressione ENTER ou, no menu Depurar, clique em Passo a Passo Simples.

Retornar Passo a Passo

Sai da função atual e sobe um nível se a função estiver aninhada. Se estiver no corpo principal, o script será executado até o fim ou até o próximo ponto de interrupção. As instruções ignoradas são executadas, mas não inspecionadas.

No Painel de Comando, digite O e pressione ENTER ou, no menu Depurar, clique em Retornar Passo a Passo.

Continuar

Continua a execução até o fim ou até o próximo ponto de interrupção. As funções ou invocações ignoradas são executadas, mas não inspecionadas.

No Painel de Comando, digite C e pressione ENTER ou, no menu Depurar, clique em Executar/Continuar.

Depurando um script

  1. Defina os pontos de interrupção no código que você deseja examinar. Para obter mais informações sobre como definir pontos de interrupção, consulte How to Set, Remove, Disable Enable, Disable, and List Breakpoints ou Set-PSBreakpoint.

  2. No menu Depurar, clique em Executar/Continuar ou, na barra de ferramentas, clique em Executar Script. O resultado deve ser esse:

    • A depuração inicia. O script executa até localizar o primeiro ponto de interrupção e para. O ponto de interrupção é destacado.

    • O prompt de comando altera e o prefixo [DBG] aparece na barra de Painel de Comando.

    • Uma mensagem sobre o ponto de interrupção que foi encontrado aparece no Painel de Saída. Por exemplo, “Hit Line breakpoint on 'C:\Users\name\Desktop\test.script.ps1:13”.

    A mensagem contém o nome do script e detalhes sobre o ponto de interrupção de linha, o ponto de interrupção variável ou o ponto de interrupção de comando.

  3. Daqui você pode fazer um passo a passo simples, um passo a passo detalhado, pode retornar passo a passo ou continuar. Continuar faz o depurador executar até o fim do script ou do próximo ponto de interrupção.

  4. Para localizar o valor de uma variável que você está depurando, passe o mouse sobre a variável no Painel de Script, ou digite o nome da variável no Painel de Comando e pressione ENTER. O Painel de Saída exibe o valor da variável. Continue a inspecionar o script ou execute outras tarefas de depuração.

See Also



Sumário