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 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 exibi-las usando o parâmetro Debug ou a $DebugPreference
variável.
Exemplos
Exemplo 1: Entenda $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 $DebugPreference
valor da variável. Primeiro, exibimos o valor atual e tentamos escrever uma mensagem de $DebugPreference
depuração. Em seguida, alteramos o valor de para Continue, que permite que mensagens de $DebugPreference
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
o , consulte about_Preference_Variables.
Exemplo 3: Usar o parâmetro Debug para substituir $DebugPreference
A Test-Debug
função grava $DebugPreference
o valor da 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 das $DebugPreference
alterações 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 Debug , 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 canalizar uma cadeia de caracteres que contém uma mensagem de depuração para esse cmdlet.
Saídas
None
Esse cmdlet não retorna nenhuma saída. Ele só grava no fluxo de depuração.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de