Compartilhar via

Como capturar o fluxo de depuração em runbooks de Automação do Azure

  • Artigo

Versão original do produto: Automação do Azure
Número original do KB: 4022768

Resumo

Por padrão, a Automação do Azure não captura nenhum dado de fluxo de depuração.  Somente dados de saída, erro e aviso são capturados, bem como dados detalhados se o runbook estiver configurado para capturá-los.

Para capturar dados de fluxo de depuração, você precisa executar duas ações em seus runbooks:

  1. Defina a variável $GLOBAL:DebugPreference="Continue", que informa ao PowerShell para continuar sempre que uma mensagem de depuração for encontrada. A parte $GLOBAL: informa ao PowerShell para fazer isso no escopo global em vez de qualquer escopo local no qual o script está no momento em que a instrução é executada.
  2. Redirecione o fluxo de depuração que não capturamos para um fluxo que capturamos, como o de saída. Isso é feito definindo o redirecionamento do PowerShell em relação à instrução a ser executada.  Para obter mais informações sobre o redirecionamento do PowerShell, consulte About_Redirection.

Exemplo:

Dado o seguinte runbook:

Write-Output "This is an output message."  
Write-Debug "This is a debug message."

Se esse runbook fosse executado como está, o painel de saída do trabalho de runbook na Automação do Azure exibiria o seguinte:

This is an output message.

Dado o seguinte runbook:

Write-Output "This is an output message."  
$GLOBAL:DebugPreference="Continue"  
Write-Debug "This is a debug message." 5>&1

Se esse runbook fosse executado, o painel de saída agora exibiria o seguinte:

This is an output message.  
This is a debug message.

Isso ocorre porque a instrução $GLOBAL:DebugPreference="Continue" informa ao PowerShell para exibir mensagens de depuração e, em seguida, continuar e a adição de 5>&1 ao final de qualquer instrução, que informa ao PowerShell para redirecionar o fluxo 5 (depuração) para o fluxo 1 (saída).

Entre em contato conosco para obter ajuda

Se você tiver dúvidas ou precisar de ajuda, crie uma solicitação de suporte ou peça ajuda à comunidade de suporte do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.