Condividi tramite

Get-PSBreakpoint

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Ottiene i punti di interruzione impostati nella sessione corrente.

Sintassi

Get-PSBreakpoint
   [[-Script] <String[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Type] <BreakpointType[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Command <String[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Variable <String[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [-Id] <Int32[]>
   [<CommonParameters>]

Descrizione

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

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

Esempio

Esempio 1: Ottenere tutti i punti di interruzione per tutti gli script e le funzioni

PS C:\> Get-PSBreakpoint

Questo comando ottiene tutti i punti di interruzione impostati in tutti gli script e in tutte le funzioni della sessione corrente.

Esempio 2: Ottenere punti di interruzione in base all'ID

PS C:\> Get-PSBreakpoint -Id 2
Function   :
IncrementAction     :
Enabled    :
TrueHitCount   : 0
Id         : 2
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Questo comando ottiene il punto di interruzione con ID 2.

Esempio 3: Inviare tramite pipe un ID a Get-PSBreakpoint

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Command "Increment"
PS C:\> $B.Id | Get-PSBreakpoint

Questi comandi mostrano come ottenere un punto di interruzione tramite pipe di un ID punto di interruzione a Get-PSBreakpoint.

Il primo comando usa il cmdlet Set-PSBreakpoint per creare un punto di interruzione nella funzione Increment dello script Sample.ps1. Salva l'oggetto punto di interruzione nella variabile $B.

Il secondo comando usa l'operatore punto (.) per ottenere la proprietà Id dell'oggetto punto di interruzione nella variabile $B. Usa 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: Ottenere punti di interruzione nei file di script specificati

PS C:\> Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

Questo comando ottiene tutti i punti di interruzione dei file Sample.ps1 e SupportScript.ps1.

Questo comando non ottiene altri punti di interruzione che potrebbero essere impostati in altri script o nelle funzioni della sessione.

Esempio 5: Ottenere punti di interruzione nei cmdlet specificati

PS C:\> Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

Questo comando ottiene tutti i punti di interruzione Command impostati nei comandi Read-Host o Write-Host del file Sample.ps1.

Esempio 6: Ottenere i punti di interruzione del comando in un file specificato

PS C:\> Get-PSBreakpoint -Type Command -Script "Sample.ps1"

Questo comando ottiene tutti i punti di interruzione Command del file Sample.ps1.

Esempio 7: Ottenere punti di interruzione per variabile

PS C:\> Get-PSBreakpoint -Variable "Index, Swap"

Questo comando ottiene i punti di interruzione impostati sul $Index e le variabili $Swap nella sessione corrente.

Esempio 8: Ottenere tutti i punti di interruzione riga e variabile in un file

PS C:\> Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

Questo comando ottiene tutti i punti di interruzione di riga e di variabile dello script Sample.ps1.

Parametri

-Command

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Id

Specifica gli ID dei punti di interruzione che questo cmdlet ottiene. Immettere gli ID in un elenco di valori delimitati da virgole. È anche possibile inviare tramite pipe gli ID dei punti di interruzione a Get-PSBreakpoint.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Script

Specifica una matrice di script che contengono i punti di interruzione. Immettere il percorso e i nomi di uno o più file di script. Se si omette il percorso, l'impostazione predefinita è la directory corrente.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Type

Specifica una matrice di tipi di punti di interruzione che ottiene questo cmdlet. Immettere uno o più tipi. I valori validi per questo parametro sono:

  • A linee
  • Comando
  • Variabile

È anche possibile inviare tramite pipe i tipi di punti di interruzione a Get-PSBreakPoint.

Type:BreakpointType[]
Accepted values:Line, Variable, Command
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Variable

Specifica una matrice di punti di interruzione variabili impostati sui nomi delle variabili specificati. Immettere i nomi delle variabili senza il segno di dollaro.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Input

System.Int32, Microsoft.PowerShell.Commands.BreakpointType

È possibile inviare tramite pipe gli ID dei punti di interruzione e i tipi di punti di interruzione a Get-PSBreakPoint.

Output

Breakpoint

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

Note

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