Delen via

Get-PSBreakpoint

  • Referentie
Module:
Microsoft.PowerShell.Utility

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

Syntaxis

Get-PSBreakpoint
   [[-Script] <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   -Command <string[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   -Variable <string[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [-Type] <BreakpointType[]>
   [-Script <string[]>]
   [<CommonParameters>]
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.

Type:String[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren: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.

Type:Int32[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
  • Bevelen
  • Veranderlijk

U kunt ook typen onderbrekingspunten doorsluisen naar Get-PSBreakPoint.

Type:BreakpointType[]
Geaccepteerde waarden:Line, Variable, Command
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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.

Type:String[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Int32

BreakpointType

U kunt onderbrekingspunt-id's en onderbrekingspunttypen doorsluisen naar Get-PSBreakPoint.

Uitvoerwaarden

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

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

Notities

U kunt Get-PSBreakpoint of de alias gbp gebruiken.