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