Compartilhar via

Write-Debug

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Grava uma mensagem de depuração no console.

Sintaxe

Write-Debug
     [-Message] <String>
     [<CommonParameters>]

Description

O cmdlet Write-Debug grava mensagens de depuração no console de um script ou comando.

Por padrão, as mensagens de depuração não são exibidas no console, mas você pode exibi-las usando o parâmetro Depurar ou a variável $DebugPreference.

Exemplos

Exemplo 1: Entender $DebugPreference

Este exemplo grava uma mensagem de depuração.

Write-Debug "Cannot open file."

O valor padrão de $DebugPreference é SilentlyContinue . Portanto, a mensagem não é exibida no console.

Exemplo 2: alterar o valor de $DebugPreference

Este exemplo mostra o efeito de alterar o valor da variável $DebugPreference. Primeiro, exibimos o valor atual de $DebugPreference e tentamos gravar uma mensagem de depuração. Em seguida, alteramos o valor de $DebugPreference para Continuar, o que permite que as mensagens de depuração sejam exibidas.

PS> $DebugPreference
SilentlyContinue
PS> Write-Debug "Cannot open file."
PS>
PS> $DebugPreference = "Continue"
PS> Write-Debug "Cannot open file."
DEBUG: Cannot open file.

Para obter mais informações sobre $DebugPreference, consulte about_Preference_Variables.

Exemplo 3: usar o parâmetro Debug para substituir $DebugPreference

A função Test-Debug grava o valor da variável $DebugPreference no host do PowerShell e no fluxo de depuração. Neste exemplo, usamos o parâmetro Depurar para substituir o valor $DebugPreference.

function Test-Debug {
    [CmdletBinding()]
    param()
    Write-Debug ('$DebugPreference is ' + $DebugPreference)
    Write-Host ('$DebugPreference is ' + $DebugPreference)
}

PS> Test-Debug
$DebugPreference is SilentlyContinue
PS> Test-Debug -Debug
DEBUG: $DebugPreference is Inquire

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):
$DebugPreference is Inquire
PS> $DebugPreference
SilentlyContinue

Observe que o valor de é alterado quando você usa o parâmetro de depuração . Essa alteração afeta apenas o escopo da função. O valor não é afetado fora da função.

Nota

Quando o valor de $DebugPreference é inquire, o PowerShell interrompe a execução para perguntar se a execução deve continuar.

Para obter mais informações sobre o parâmetro comum Depurar, consulte about_CommonParameters.

Parâmetros

-Message

Especifica a mensagem de depuração a ser enviada para o console.

Tipo:String
Aliases:Msg
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém uma mensagem de depuração para Write-Debug.

Saídas

None

Write-Debug grava apenas no fluxo de depuração. Ele não retorna nenhuma saída.