Get-PSBreakpoint

Referentie

Module:: Microsoft.PowerShell.Utility

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

Syntax

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

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

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

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

Get-PSBreakpoint
   [-Id] <Int32[]>
   [-Runspace <Runspace>]
   [<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_Debuggers voor meer informatie over het PowerShell-foutopsporingsprogramma.

Voorbeelden

Voorbeeld 1: Alle onderbrekingspunten voor alle scripts en functies ophalen

Met deze opdracht worden alle onderbrekingspunten ingesteld op 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 Set-PSBreakpoint cmdlet maakt een onderbrekingspunt op 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 $B variabele wordt doorgesluisd naar de Get-PSBreakpoint cmdlet om de informatie over het onderbrekingspunt 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 weergegeven 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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-Runspace

Hiermee geeft u de id van een Runspace-object op, zodat u kunt communiceren met onderbrekingspunten in de opgegeven runspace.

Type:	Runspace
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-Type

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

Lijn
Opdracht
Variabele

U kunt ook typen onderbrekingspunten doorsluisen naar Get-PSBreakPoint.

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

-Variable

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

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 de alias Gbp gebruiken Get-PSBreakpoint of de bijbehorende alias.