Write-Debug
Grava uma mensagem de depuração para o console.
Syntax
Write-Debug
[-Message] <String>
[<CommonParameters>]
Description
O Write-Debug
cmdlet grava mensagens de depuração no host 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 Debug ou a $DebugPreference
variável .
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 $DebugPreference
variável. 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 Test-Debug
função grava o valor da $DebugPreference
variável no host do PowerShell e no fluxo de Depuração. Neste exemplo, usamos o parâmetro Debug para substituir o $DebugPreference
valor.
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 Continue
$DebugPreference is Continue
PS> $DebugPreference
SilentlyContinue
Observe que o valor de $DebugPreference
é alterado quando você usa o parâmetro Debug . Essa alteração afeta apenas o escopo da função. O valor não é afetado fora da função.
Para obter mais informações sobre o parâmetro comum Depurar , consulte about_CommonParameters.
Parâmetros
-Message
Especifica a mensagem de depuração para enviar para o console.
Type: | String |
Aliases: | Msg |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
Você pode redirecionar uma cadeia de caracteres que contém uma mensagem de depuração para Write-Debug
.
Saídas
None
Write-Debug
grava somente no fluxo de depuração. Ele não grava nenhum objeto no pipeline.