Write-Debug
Grava uma mensagem de depuração no console.
Sintaxe
Write-Debug [-Message] <string> [<CommonParameters>]
Descrição
O cmdlet Write-Debug grava mensagens de depuração no console a partir de um script ou comando.
Por padrão, as mensagens de depuração não são exibidas no console, mas você pode os exibi-las usando o parâmetro Debug ou a variável $DebugPreference.
Parâmetros
-Message <string>
Especifica a mensagem de depuração a ser enviada ao console.
| Necessário? | true |
| Posição? | 1 |
| Valor padrão | |
| Aceitar entrada do pipeline? | true (ByValue) |
| Aceitar caracteres curinga? | false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
| Entradas | System.String
Você pode canalizar uma string que contém uma mensagem de depuração para Write-Debug. |
| Saídas | None
Write-Debug só grava no fluxo de depuração. Ele não retorna saída. |
Exemplo 1
C:\PS>Write-Debug "Cannot open file." Descrição ----------- Esse comando grava uma mensagem de depuração. Como o valor de $DebugPreference é "SilentlyContinue", a mensagem não é exibida no console.
Exemplo 2
C:\PS>$DebugPreference SilentlyContinue C:\PS> Write-Debug "Cannot open file." C:\PS> C:\PS> Write-Debug "Cannot open file." -debug DEBUG: Cannot open file. Descrição ----------- Esse exemplo mostra como usar o parâmetro comum Debug para substituir o valor da variável $DebugPreference para um comando específico. O primeiro comando exibe o valor da variável $DebugPreference que é "SilentlyContinue", o padrão. O segundo comando grava uma mensagem de depuração mas, por causa do valor de $DebugPreference, a mensagem não é exibida. O terceiro comando grava uma mensagem de depuração. Ele usa o parâmetro comum Debug para substituir o valor de $DebugPreference e exibir as mensagens de depuração resultantes desse comando. Como resultado, embora o valor de $DebugPreference seja "SilentlyContinue", a mensagem de depuração é exibida. Para obter mais informações sobre o parâmetro comum Debug, consulte about_CommonParameters.
Exemplo 3
C:\PS>$DebugPreference SilentlyContinue C:\PS> Write-Debug "Cannot open file." C:\PS> C:\PS> $DebugPreference = "Continue" C:\PS> Write-Debug "Cannot open file." DEBUG: Cannot open file. Descrição ----------- Esse comando mostra o efeito da alteração do valor da variável $DebugPreference na exibição de mensagens de depuração. O primeiro comando exibe o valor da variável $DebugPreference que é "SilentlyContinue", o padrão. O segundo comando grava uma mensagem de depuração mas, por causa do valor de $DebugPreference, a mensagem não é exibida. O terceiro comando atribui um valor de "Continue" à variável $DebugPreference. O quarto comando grava uma mensagem de depuração que é exibida no console. Para obter mais informações sobre $DebugPreference, consulte about_Preference_Variables.