Set-PSBreakpoint

Set-PSBreakpoint -Command <string[]> [[-Script] <string[]>] [-Azione <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint [-Script] <string[]> [-Line] <Int32[]> [[-Column] <int>] [-Azione <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint -Variable <string[]> [[-Script] <string[]>] [-Mode {<Read> | <Write> | <ReadWrite>}] [-Azione <scriptblock>] [<CommonParameters>]

C:\PS>set-psbreakpoint -script sample.ps1 -line 5

Column     : 0
Line       : 5
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Descrizione
-----------
Questo comando imposta un punto d'interruzione sulla riga 5 nello script Sample.ps1. Di conseguenza, durante l'esecuzione dello script, questa viene interrotta immediatamente prima dell'esecuzione della riga 5.

Quando si imposta un nuovo punto d'interruzione per numero di riga, il cmdlet Set-PSBreakpoint genera un oggetto punto di interruzione riga (System.Management.Automation.LineBreakpoint) che include l'ID del punto d'interruzione e il numero di passaggi, come illustrato nell'output di esempio seguente.

C:\PS>set-psbreakpoint -command Increment -script sample.ps1

Command    : Increment
Action     :
Enabled    : True
HitCount   : 0
Id         : 1
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Descrizione
-----------
Questo comando crea un punto di interruzione comando nella funzione Increment nel cmdlet Sample.ps1. Lo script interrompe l'esecuzione subito prima di ogni chiamata alla funzione specificata.

Il risultato sarà un oggetto punto di interruzione comando. Prima dell'esecuzione dello script, il valore della proprietà HitCount è 0.

C:\PS>set-psbreakpoint -script sample.ps1 -variable Server -Mode ReadWrite

Descrizione
-----------
Questo comando imposta un punto d'interruzione sulla variabile Server nello script Sample.ps1. Utilizza il parametro Mode con un valore di ReadWrite per interrompere l'esecuzione quando il valore della variabile viene letto e subito prima che il valore venga modificato.

C:\PS>set-psbreakpoint -script Sample.ps1 -command "write*"

Descrizione
-----------
Questo comando imposta un punto d'interruzione su ogni comando nello script Sample.ps1 che inizia con "write", ad esempio "write-host".

C:\PS>set-psbreakpoint -script test.ps1 -command DiskTest `
  -action { (if $disk -gt 2) { break } }

Descrizione
-----------
Questo comando interrompe l'esecuzione alla funzione DiskTest nello script Test.ps1 solo quando il valore della variabile $disk è maggiore di 2.

Utilizza il cmdlet Set-PSBreakpoint per impostare un punto di interruzione comando sulla funzione DiskTest. Il valore dell'azione è un blocco di script che verifica il valore della variabile $disk nella funzione.

L'azione utilizza la parola chiave BREAK per interrompere l'esecuzione se la condizione viene soddisfatta. L'alternativa (impostazione predefinita) è CONTINUE.

C:\PS>set-psbreakpoint -command checkpoint-computer

Id       : 0
Command  : checkpoint-computer
Enabled  : True
HitCount : 0
Action   :

C:\PS> function CheckLog {
>> get-eventlog -log Application | 
>> where {($_.source -like "TestApp") -and ($_.Message -like "*failed*")}
>>}
>>
C:\PS> Checklog
DEBUG: Hit breakpoint(s)
DEBUG:  Function breakpoint on 'prompt:Checklog'
C:\PS>>>

Descrizione
-----------
Questo comando imposta un punto d'interruzione sulla funzione CheckLog. Poiché il comando non specifica uno script, il punto d'interruzione viene impostato su qualsiasi attività in esecuzione nella sessione corrente. Il debugger viene interrotto quando la funzione viene chiamata, non quando viene dichiarata.

C:\PS>set-psbreakpoint -script sample.ps1 -line 1, 14, 19 -column 2 -action {&(log.ps1)}

Column     : 2
Line       : 1
Action     :
Enabled    : True
HitCount   : 0
Id         : 6
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Column     : 2
Line       : 14
Action     :
Enabled    : True
HitCount   : 0
Id         : 7
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Column     : 2
Line       : 19
Action     :
Enabled    : True
HitCount   : 0
Id         : 8
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Descrizione
-----------
Questo comando imposta tre punti d'interruzione riga nello script Sample.ps1. Imposta un punto d'interruzione alla colonna 2 su ciascuna riga specificata nello script. L'azione specificata nel parametro Action si applica a tutti i punti d'interruzione.