Write-Debug

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Scrive un messaggio di debug nella console.

Sintassi

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

Descrizione

Il Write-Debug cmdlet scrive messaggi di debug nell'host da uno script o un comando.

Per impostazione predefinita, i messaggi di debug non vengono visualizzati nella console, ma è possibile visualizzarli usando il parametro Debug o la $DebugPreference variabile .

Esempio

Esempio 1: Informazioni $DebugPreference

In questo esempio viene scritto un messaggio di debug.

Write-Debug "Cannot open file."

Il valore predefinito di $DebugPreference è SilentlyContinue. Pertanto, il messaggio non viene visualizzato nella console.

Esempio 2: Modificare il valore di $DebugPreference

In questo esempio viene illustrato l'effetto della modifica del valore della $DebugPreference variabile. Prima di tutto, viene visualizzato il valore corrente di $DebugPreference e si tenta di scrivere un messaggio di debug. Quindi si modifica il valore di $DebugPreference in Continua, che consente di visualizzare i messaggi di debug.

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

Per altre informazioni su $DebugPreference, vedere about_Preference_Variables.

Esempio 3: Usare il parametro Debug per eseguire l'override di $DebugPreference

La Test-Debug funzione scrive il valore della $DebugPreference variabile nell'host di PowerShell e nel flusso di debug. In questo esempio viene usato il parametro Debug per eseguire l'override del $DebugPreference valore.

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

Si noti che il valore delle $DebugPreference modifiche quando si usa il parametro Debug . Questa modifica influisce solo sull'ambito della funzione. Il valore non è interessato all'esterno della funzione.

Per altre informazioni sul parametro comune Debug , vedere about_CommonParameters.

Parametri

-Message

Specifica il messaggio di debug da inviare alla console.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Input

String

È possibile inviare tramite pipe una stringa contenente un messaggio di debug a questo cmdlet.

Output

None

Questo cmdlet non restituisce output. Scrive solo nel flusso di debug.