Compartilhar via


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 cadeia de caracteres que contém uma mensagem de depuração para Write-Debug.

Saídas

Nenhum

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.





Consulte também

Conceitos

Write-Verbose
Write-Error
Write-Host
Write-Progress
Write-Output
Write-Warning