Scrive un messaggio di debug nella console.
Sintassi
Write-Debug [-Message] <string> [<CommonParameters>]
Descrizione
Il cmdlet Write-Debug scrive messaggi di debug nella console di uno script o di un comando.
Per impostazione predefinita, i messaggi di debug non vengono visualizzati nella console, ma è possibile visualizzarli tramite il parametro Debug o la variabile $DebugPreference.
Parametri
-Message <string>
Specifica il messaggio di debug da inviare alla console.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue) |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
System.String È possibile reindirizzare una stringa che contiene un messaggio di debug a Write-Debug. |
|
Output |
Nessuno Write-Debug scrive solo nel flusso di debug. Non restituisce alcun output. |
Esempio 1
C:\PS>Write-Debug "Cannot open file." Descrizione ----------- Questo comando scrive un messaggio di debug. Poiché il valore di $DebugPreference è "SilentlyContinue", il messaggio non viene visualizzato nella console.
Esempio 2
C:\PS>$DebugPreference SilentlyContinue C:\PS> Write-Debug "Cannot open file." C:\PS> C:\PS> Write-Debug "Cannot open file." -debug DEBUG: Cannot open file. Descrizione ----------- In questo esempio viene illustrato come utilizzare il parametro comune Debug per eseguire l'override del valore della variabile $DebugPreference per un determinato comando. Il primo comando visualizza il valore della variabile $DebugPreference, ovvero "SilentlyContinue", l'impostazione predefinita. Il secondo comando scrive un messaggio di debug ma, a causa del valore di $DebugPreference, il messaggio non viene visualizzato. Il terzo comando scrive un messaggio di debug. Utilizza il parametro comune Debug per eseguire l'override del valore di $DebugPreference e per visualizzare i messaggi di debug risultanti da questo comando. Di conseguenza, anche se il valore di $DebugPreference è "SilentlyContinue", il messaggio di debug viene visualizzato. Per ulteriori informazioni sul parametro comune Debug, vedere about_CommonParameters.
Esempio 3
C:\PS>$DebugPreference SilentlyContinue C:\PS> Write-Debug "Cannot open file." C:\PS> C:\PS> $DebugPreference = "Continue" C:\PS> Write-Debug "Cannot open file." DEBUG: Cannot open file. Descrizione ----------- In questo comando viene illustrato l'effetto della modifica del valore della variabile $DebugPreference nella visualizzazione dei messaggi di debug. Il primo comando visualizza il valore della variabile $DebugPreference, ovvero "SilentlyContinue", l'impostazione predefinita. Il secondo comando scrive un messaggio di debug, ma a causa del valore di $DebugPreference il messaggio non viene visualizzato. Il terzo comando assegna il valore "Continue" alla variabile $DebugPreference. Il quarto comando scrive un messaggio di debug visualizzato nella console. Per ulteriori informazioni su $DebugPreference, vedere about_Preference_Variables.
Vedere anche