Write-Debug

Modulo:: Microsoft.PowerShell.Utility Module

Scrive un messaggio di debug nella console.

Sintassi

Default (impostazione predefinita).

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

Descrizione

Il cmdlet Write-Debug scrive messaggi di debug nell'host a partire 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 variabile .

Esempio

Esempio 1: Comprendere $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 variabile $DebugPreference. 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 funzione Test-Debug scrive il valore della variabile $DebugPreference nell'host di PowerShell e nel flusso di debug. In questo esempio viene usato il parametro Debug per eseguire l'override del valore $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 Continue
$DebugPreference is Continue
PS> $DebugPreference
SilentlyContinue

Si noti che il valore di $DebugPreference cambia quando si utilizza il parametro Debug . Questa modifica influisce solo sull'ambito della funzione. Il valore non viene influenzato al di fuori della funzione.

Per altre informazioni sul parametro comune di debug , vedere about_CommonParameters.

Parametri

-Message

Specifica il messaggio di debug da inviare alla console.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False
Alias:	Msg

Set di parametri

(All)

Posizione:	0
Obbligatorio:	True
Valore dalla pipeline:	True
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

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