Get-PSBreakpoint

Hiermee haalt u de onderbrekingspunten op die zijn ingesteld in de huidige sessie.

Syntax

Line (Standaard)

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

Command

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

Variable

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

Type

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

Id

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

Description

De Get-PSBreakPoint-cmdlet haalt de onderbrekingspunten op die zijn ingesteld in de huidige sessie. U kunt de cmdlet-parameters gebruiken om bepaalde onderbrekingspunten op te halen.

Een onderbrekingspunt is een punt in een opdracht of script waarbij de uitvoering tijdelijk stopt, zodat u de instructies kunt bekijken. Get-PSBreakpoint is een van de verschillende cmdlets die zijn ontworpen voor het opsporen van fouten in PowerShell-scripts en -opdrachten. Zie about_Debuggersvoor meer informatie over het PowerShell-foutopsporingsprogramma.

Voorbeelden

Voorbeeld 1: Alle onderbrekingspunten ophalen voor alle scripts en functies

Met deze opdracht worden alle onderbrekingspunten ingesteld voor alle scripts en functies in de huidige sessie.

Get-PSBreakpoint

Voorbeeld 2: Onderbrekingspunten ophalen op id

Met deze opdracht wordt het onderbrekingspunt met onderbrekingspunt-id 2 ophaalt.

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

Voorbeeld 3: Een id doorsluisen naar 'Get-PSBreakpoint'

Deze opdrachten laten zien hoe u een onderbrekingspunt kunt ophalen door een onderbrekingspunt-id door te geven aan Get-PSBreakpoint.

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

De cmdlet Set-PSBreakpoint maakt een onderbrekingspunt voor de functie Increment in het Sample.ps1 script en slaat het onderbrekingspuntobject op in de $B variabele. De eigenschap Id van het onderbrekingspuntobject in de variabele $B wordt doorgesluisd naar de Get-PSBreakpoint-cmdlet om de onderbrekingspuntgegevens weer te geven.

Voorbeeld 4: Onderbrekingspunten ophalen in opgegeven scriptbestanden

Met deze opdracht worden alle onderbrekingspunten in de Sample.ps1- en SupportScript.ps1-bestanden opgeslagen.

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

Met deze opdracht worden geen andere onderbrekingspunten weergegeven die kunnen worden ingesteld in andere scripts of op functies in de sessie.

Voorbeeld 5: Onderbrekingspunten ophalen in opgegeven cmdlets

Met deze opdracht worden alle onderbrekingspunten voor opdrachten die zijn ingesteld op Read-Host of Write-Host opdrachten in het Sample.ps1-bestand ophaalt.

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

Voorbeeld 6: Onderbrekingspunten voor opdrachten ophalen in een opgegeven bestand

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

Met deze opdracht worden alle onderbrekingspunten voor opdrachten in het Sample.ps1-bestand opgeslagen.

Voorbeeld 7: Onderbrekingspunten ophalen op variabele

Met deze opdracht worden onderbrekingspunten opgeslagen die zijn ingesteld op de $Index en $Swap variabelen in de huidige sessie.

Get-PSBreakpoint -Variable "Index, Swap"

Voorbeeld 8: Alle onderbrekingspunten voor regel en variabele ophalen in een bestand

Met deze opdracht worden alle onderbrekingspunten voor regels en variabelen in het Sample.ps1 script opgeslagen.

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

Parameters

-Command

Hiermee geeft u een matrix van opdrachtonderbrekingspunten die zijn ingesteld op de opgegeven opdrachtnamen. Voer de opdrachtnamen in, zoals de naam van een cmdlet of functie.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Command
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Id

Hiermee geeft u de onderbrekingspunt-id's op die door deze cmdlet worden opgehaald. Voer de id's in een door komma's gescheiden lijst in. U kunt ook onderbrekingspunt-id's naar Get-PSBreakpoint.

Parametereigenschappen

Type:

Int32[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Id
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Script

Hiermee geeft u een matrix van scripts die de onderbrekingspunten bevatten. Voer het pad (optioneel) en de namen van een of meer scriptbestanden in. Als u het pad weglaat, is de standaardlocatie de huidige map.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Script
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
Variable
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
Command
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
Type
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Type

Hiermee geeft u een matrix van onderbrekingspunttypen op die door deze cmdlet worden opgehaald. Voer een of meer typen in. De acceptabele waarden voor deze parameter zijn:

  • Lijn
  • Opdracht
  • Veranderlijk

U kunt ook typen onderbrekingspunten doorsluisen naar Get-PSBreakPoint.

Parametereigenschappen

Type:

BreakpointType[]

Default value:None
Geaccepteerde waarden:Line, Variable, Command
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Type
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Variable

Hiermee geeft u een matrix van variabele onderbrekingspunten die zijn ingesteld op de opgegeven namen van variabelen. Voer de namen van variabelen zonder dollartekens in.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Variable
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

Int32

BreakpointType

U kunt onderbrekingspunt-ID's en onderbrekingspunttypen doorlijnen naar Get-PSBreakPoint.

Uitvoerwaarden

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Get-PSBreakPoint Retourneert objecten die de onderbrekingspunten in de sessie vertegenwoordigen.

Notities

U kunt de alias "gbp" gebruiken Get-PSBreakpoint .