Condividi tramite

Get-PSBreakpoint

Modulo:
Microsoft.PowerShell.Utility Module

Ottiene i punti di interruzione impostati nella sessione corrente.

Sintassi

Line (impostazione predefinita). 

Get-PSBreakpoint
    [[-Script] <String[]>]
    [-Runspace <Runspace>]
    [<CommonParameters>]

Command 

Get-PSBreakpoint
    [[-Script] <String[]>]
    -Command <String[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Variable 

Get-PSBreakpoint
    [[-Script] <String[]>]
    -Variable <String[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Type 

Get-PSBreakpoint
    [[-Script] <String[]>]
    [-Type] <BreakpointType[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Id 

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

Descrizione

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

Un punto di interruzione è un punto in un comando o uno script in cui l'esecuzione si arresta temporaneamente in modo da poter esaminare le istruzioni. Get-PSBreakpoint è uno dei diversi cmdlet progettati per il debug di script e comandi di PowerShell. Per altre informazioni sul debugger di PowerShell, vedere about_Debuggers.

Esempio

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

Questo comando ottiene tutti i punti di interruzione impostati su tutti gli script e le funzioni nella sessione corrente.

Get-PSBreakpoint

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

Questo comando ottiene il punto di interruzione con ID punto di interruzione 2.

Get-PSBreakpoint -Id 2

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

Esempio 3: inviare tramite pipe un ID a 'Get-PSBreakpoint'

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

$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint

Il cmdlet Set-PSBreakpoint crea un punto di interruzione nella funzione Increment nello script Sample.ps1 e salva l'oggetto punto di interruzione nella variabile $B. La proprietà id dell'oggetto punto di interruzione nella variabile $B viene inviata tramite pipe al cmdlet Get-PSBreakpoint per visualizzare le informazioni sul punto di interruzione.

Esempio 4: Ottenere punti di interruzione nei file di script specificati

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

Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

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

Esempio 5: Ottenere punti di interruzione nei cmdlet specificati

Questo comando ottiene tutti i punti di interruzione comando impostati su Read-Host o Write-Host comandi nel file Sample.ps1.

Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

Esempio 6: Ottenere i punti di interruzione dei comandi in un file specificato

Get-PSBreakpoint -Type Command -Script "Sample.ps1"

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

Esempio 7: Ottenere punti di interruzione per variabile

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

Get-PSBreakpoint -Variable "Index, Swap"

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

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

Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

Esempio 9: Ottenere i punti di interruzione impostati in uno spazio di esecuzione specifico

In questo esempio, viene avviato un processo e viene impostato un punto di interruzione per interrompere l'esecuzione quando viene eseguito il Set-PSBreakpoint. Lo spazio di esecuzione viene memorizzato in una variabile e passato al comando Get-PSBreakpoint con il parametro Runspace. È quindi possibile esaminare il punto di interruzione nella variabile $breakpoint.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakpoint -Runspace $runspace

Parametri

-Command

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

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Command
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Id

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

Proprietà dei parametri

Tipo:

Int32[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Id
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Runspace

Specifica l'ID di un oggetto Runspace in modo da poter interagire con i punti di interruzione nello spazio di esecuzione specificato.

Questo parametro è stato aggiunto in PowerShell 7.2.

Proprietà dei parametri

Tipo:Runspace
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Script

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

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Script
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Variable
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Command
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
Type
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Type

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

  • Linea
  • Comando
  • Variabile

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

Proprietà dei parametri

Tipo:

BreakpointType[]

Valore predefinito:None
Valori accettati:Line, Variable, Command
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Type
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Variable

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

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Variable
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

Int32

È possibile inviare tramite pipe gli ID dei punti di interruzione a questo cmdlet.

BreakpointType

È possibile inviare tramite pipe i tipi di punti di interruzione a questo cmdlet.

Output

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Questo cmdlet restituisce oggetti che rappresentano i punti di interruzione nella sessione.

Note

PowerShell include gli alias seguenti per Get-PSBreakpoint:

  • Tutte le piattaforme:
    • gbp