Ottiene i punti di interruzione impostati nella sessione corrente.

Sintassi

Get-PSBreakpoint [[-Script] <string[]>] [<CommonParameters>]

Get-PSBreakpoint -Command <string[]> [-Script <string[]>] [<CommonParameters>]

Get-PSBreakpoint [-Id] <Int32[]> [<CommonParameters>]

Get-PSBreakpoint [-Type] <BreakpointType[]> [-Script <string[]>] [<CommonParameters>]

Get-PSBreakpoint -Variable <string[]> [-Script <string[]>] [<CommonParameters>]

Descrizione

Il cmdlet Get-PSBreakPoint ottiene i punti di interruzione impostati nella sessione corrente. È possibile utilizzare i parametri del cmdlet per ottenere determinati punti di interruzione.

Un punto di interruzione è un punto in un comando o in uno script in corrispondenza del quale l'esecuzione viene interrotta temporaneamente per consentire l'analisi delle istruzioni. Get-PSBreakpoint è uno dei diversi cmdlet progettato per il debug dei comandi e degli script di Windows PowerShell. Per ulteriori informazioni sul debugger di Windows PowerShell, vedere about_Debuggers.

Parametri

-Command <string[]>

Ottiene i punti di interruzione comando impostati sui nomi dei comandi specificati. Immettere i nomi dei comandi, ad esempio il nome di un cmdlet o di una funzione.

Obbligatorio?

true

Posizione?

named

Valore predefinito

All breakpoints

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Id <Int32[]>

Ottiene i punti di interruzione con gli ID dei punti di interruzione specificati. Immettere gli ID in un elenco separato da virgole. È inoltre possibile reindirizzare gli ID dei punti di interruzione a Get-PSBreakpoint.

Obbligatorio?

true

Posizione?

1

Valore predefinito

All breakpoints

Accettare input da pipeline?

true (ByValue)

Accettare caratteri jolly?

false

-Script <string[]>

Ottiene solo i punti di interruzione negli script specificati. Immettere il percorso (facoltativo) e i nomi di uno o più file di script. Il percorso predefinito è la directory corrente.

Obbligatorio?

false

Posizione?

named

Valore predefinito

All breakpoints

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Type <BreakpointType[]>

Ottiene solo i punti di interruzione dei tipi specificati. Immettere uno o più tipi. I valori validi sono Line, Command e Variable. È inoltre possibile reindirizzare i tipi di punto di interruzione a Get-PSBreakpoint.

Obbligatorio?

true

Posizione?

1

Valore predefinito

All breakpoints

Accettare input da pipeline?

true (ByValue)

Accettare caratteri jolly?

false

-Variable <string[]>

Ottiene i punti di interruzione variabile impostati sui nomi della variabile specificata. Immettere i nomi della variabile senza simboli di dollaro.

Obbligatorio?

true

Posizione?

named

Valore predefinito

All breakpoints

Accettare input da pipeline?

false

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.Int32, Microsoft.PowerShell.Commands.BreakpointType

È possibile reindirizzare i tipi e gli ID dei punti di interruzione a Get-PSBreakpoint.

Output

Oggetto punto di interruzione (System.Management.Automation.LineBreakpoint, System.Management.Automation.VariableBreakpoint, System.Management.Automation.CommandBreakpoint)

Get-PSBreakPoint restituisce gli oggetti che rappresentano i punti di interruzione nella sessione.

Note

È possibile utilizzare Get-PSBreakpoint o il relativo alias, "gbp".

Esempio 1

C:\PS>get-psbreakpoint

Descrizione
-----------
Questo comando consente di ottenere tutti i set di punti di interruzione in tutti gli script e le funzioni nella sessione corrente.






Esempio 2

C:\PS>get-psbreakpoint -Id 2

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

Descrizione
-----------
Con questo comando si ottiene il punto di interruzione con ID del punto di interruzione 2.






Esempio 3

C:\PS>$b = set-psbreakpoint -script sample.ps1 -function increment

C:\PS> $b.Id | get-psbreakpoint

Descrizione
-----------
In questi comandi viene illustrato come ottenere un punto di interruzione reindirizzando un ID del punto di interruzione a Get-PSBreakpoint.

Nel primo comando viene utilizzato il cmdlet Set-PSBreakpoint per creare un punto di interruzione nella funzione Increment nello script Sample.ps1. L'oggetto punto di interruzione viene salvato nella variabile $b.

Nel secondo comando viene utilizzato l'operatore punto (.) per ottenere la proprietà dell'Id dell'oggetto punto di interruzione nella variabile $b. Viene utilizzato un operatore pipeline (|) per inviare l'ID al cmdlet Get-PSBreakpoint.

Di conseguenza, Get-PSBreakpoint ottiene il punto di interruzione con l'ID specificato.






Esempio 4

C:\PS>get-psbreakpoint -script Sample.ps1, SupportScript.ps1

Descrizione
-----------
Con questo comando si ottengono tutti i punti di interruzione nei file Sample.ps1 e SupportScript.ps1.

Non si ottengono altri punti di interruzione che potrebbero essere impostati in altri script o su funzioni della sessione.






Esempio 5

C:\PS>get-psbreakpoint -command Read-Host, Write-Host -script Sample.ps1

Descrizione
-----------
Con questo comando si ottengono tutti i punti di interruzione Command impostati sui comandi Read-Host o Write-Host nel file Sample.ps1.






Esempio 6

C:\PS>get-psbreakpoint -type Command -script Sample.ps1

Descrizione
-----------
Con questo comando si ottengono tutti i punti di interruzione Command nel file Sample.ps1.






Esempio 7

C:\PS>get-psbreakpoint -variable Index, Swap

Descrizione
-----------
Con questo comando si ottengono i punti di interruzione impostati sulle variabili $index e $swap nella sessione corrente.






Esempio 8

C:\PS>get-psbreakpoint -type line, variable -script Sample.ps1

Descrizione
-----------
Con questo comando si ottengono tutti i punti di interruzione riga e variabile nello script Sample.ps1.






Vedere anche




Argomenti della Guida