Set-PSDebug

Attiva e disattiva le funzionalità di debug degli script, imposta il livello di traccia e attiva e disattiva la modalità ridotta.

Sintassi

Set-PSDebug [-Off] [<CommonParameters>]

Set-PSDebug [-Step] [-Strict] [-Trace <int>] [<CommonParameters>]

Descrizione

Il cmdlet Set-PSDebug attiva e disattiva le funzionalità di debug degli script, imposta il livello di traccia e attiva e disattiva la modalità ridotta.

Quando il parametro Trace è impostato su 1, ogni riga di script viene tracciata come se fosse eseguita. Quando il parametro è impostato su 2, vengono tracciate anche le assegnazioni delle variabili e le chiamate a funzioni e script. Se viene specificato il parametro Step, l'utente viene avvisato prima dell'esecuzione di ogni riga di script.

Parametri

-Off

Disattiva tutte le funzionalità di debug degli script.

Nota: con un comando "Set-StrictMode -off" si disabilita la verifica impostata da un comando "set-psdebug -strict". Per ulteriori informazioni, vedere Set-StrictMode.

-Step

Attiva il debug passo a passo degli script. Prima dell'esecuzione di ogni riga, all'utente viene richiesto se interrompere, continuare o attivare un nuovo livello di interprete per controllare lo stato dello script.

Nota: se si specifica il parametro Step, viene automaticamente impostato un livello di traccia 1.

-Strict

Specifica che l'interprete deve generare un'eccezione se viene fatto riferimento a una variabile prima dell'assegnazione di un valore alla variabile.

Nota: con un comando "Set-StrictMode -off" si disabilita la verifica impostata da un comando "set-psdebug -strict". Per ulteriori informazioni, vedere Set-StrictMode.

-Trace <int>

Specifica il livello di traccia:

0: disattiva la traccia degli script.

1: traccia le righe script mentre vengono eseguite.

2: traccia le righe script, le assegnazioni delle variabili, le chiamate a funzioni e gli script.

<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.

Esempio 1

C:\PS>set-psdebug -trace 2; foreach ($i in 1..3) {$i}

DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
1
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
2
DEBUG:    1+ Set-PsDebug -trace 2; foreach ($i in 1..3) {$i}
3

Descrizione
-----------
Con questo comando si imposta il livello di traccia 2, quindi si esegue uno script che visualizza i numeri 1, 2 e 3.

Esempio 2

C:\PS>set-psdebug -step; foreach ($i in 1..3) {$i}

DEBUG:    1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
Continue with this operation?
   1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help
(default is "Y"):a
DEBUG:    1+ Set-PsDebug -step; foreach ($i in 1..3) {$i}
1
2
3

Descrizione
-----------
Tramite questo comando viene attivato il debug passo a passo, quindi 
viene eseguito uno script che visualizza i numeri 1, 2 e 3.

Esempio 3

C:\PS>set-psdebug -off; foreach ($i in 1..3) {$i}

1
2
3

Descrizione
-----------
Con questo comando si disattivano tutte le funzionalità di debug, quindi si esegue uno script che visualizza i numeri 1, 2 e 3.

Esempio 4

C:\PS>set-psdebug -strict; $NewVar

The variable $NewVar cannot be retrieved because it has not been set yet.
At line:1 char:28
+ Set-PsDebug -strict;$NewVar <<<<

Descrizione
-----------
Tramite questo comando viene attivata la modalità ridotta per l'interprete e viene eseguito un tentativo di accesso a una variabile non ancora impostata.

Vedere anche

Concetti

about_Debuggers
Debug-Process
Set-PSBreakpoint
Set-StrictMode
Write-Debug