Adicionar a saída em scripts do Windows PowerShell

Concluído

Quando um script não estiver funcionando como você esperava, pode ser útil fazer com que o script exiba informações adicionais. Você pode usar essas informações para reconhecer o que o script está fazendo e por que ele não está funcionando conforme o esperado.

O cmdlet Write-Host é a maneira mais comum de exibir informações adicionais enquanto um script está em execução. Você pode usar o Write-Host para exibir informações de texto que indicam pontos específicos em um script e valores variáveis. Valores variáveis podem ser úteis na maioria dos casos quando um script não está se comportando como você espera que ele se comporte porque uma variável não contém um valor esperado.

Se você quiser tornar o texto de solução de problemas mais facilmente identificável, use o cmdlet Write-Warning em vez de Write-Host. Write-Warning exibe o texto especificado em uma cor alternativa.

Se você quiser reduzir a velocidade da execução de um script para permitir que você examine melhor a saída, adicione um cmdlet Start-Sleep e especifique alguns segundos para pausar. Como alternativa, se você quiser que o script pause até que você esteja pronto para ele continuar, use o Read-Host.

Enquanto estiver no processo de solução de problemas, você pode comentar as informações adicionais. Em seguida, se necessário, você poderá remover a marca de comentário para examinar as informações adicionais novamente.

Saída de script avançada

Se você configurou seu script como um script avançado usando CmdletBinding() no bloco Param(), também poderá usar os cmdlets na tabela a seguir como parte do script para solução de problemas.

Tabela 1: Cmdlets para solução de problemas

Cmdlet	Descrição
Write-Verbose	O texto especificado por Write-Verbose é exibido somente quando você usa o -Verbose parâmetro ao executar o script. O valor de $VerbosePreference especifica a ação a ser tomada após o comando Write-Verbose . A ação padrão é SilentlyContinue.
Write-Debug	O texto especificado por Write-Debug é exibido somente quando você usa o -Debug parâmetro ao executar o script. O valor de $DebugPreference especifica a ação a ser tomada após o comando Write-Debug . A ação padrão é SilentlyContinue, que não exibe nenhuma informação na tela. Você precisa alterar essa ação para Continuar para que as mensagens de depuração sejam exibidas.