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
   [[-Script] <String[]>]
   [-Type] <BreakpointType[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Command <String[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Variable <String[]>
   [<CommonParameters>]
Get-PSBreakpoint
   [-Id] <Int32[]>
   [<CommonParameters>]

Description

De cmdlet Get-PSBreakPoint 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 Windows PowerShell-scripts en -opdrachten. Zie about_Debuggers voor meer informatie over het Windows PowerShell-foutopsporingsprogramma.

Voorbeelden

Voorbeeld 1: Alle onderbrekingspunten ophalen voor alle scripts en functies

PS C:\> Get-PSBreakpoint

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

Voorbeeld 2: Onderbrekingspunten ophalen op 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

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

Voorbeeld 3: een id doorsluisen naar Get-PSBreakpoint

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

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

De eerste opdracht maakt gebruik van de Set-PSBreakpoint cmdlet om een onderbrekingspunt te maken voor de functie Increment in het Sample.ps1 script. Het onderbrekingspuntobject wordt opgeslagen in de variabele $B.

De tweede opdracht gebruikt de puntoperator (.) om de id-eigenschap van het onderbrekingspuntobject op te halen in de $B variabele. Er wordt een pijplijnoperator (|) gebruikt om de id te verzenden naar de cmdlet Get-PSBreakpoint.

Als gevolg hiervan haalt Get-PSBreakpoint het onderbrekingspunt met de opgegeven id op.

Voorbeeld 4: Onderbrekingspunten ophalen in opgegeven scriptbestanden

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

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

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

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

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

Voorbeeld 6: Onderbrekingspunten voor opdrachten ophalen in een opgegeven bestand

PS C:\> 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

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

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

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

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

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

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 en de namen in van een of meer scriptbestanden. Als u het pad weglaat, is de standaardlocatie de huidige map.

Type:String[]
Position:0
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 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

System.Int32, Microsoft.PowerShell.Commands.BreakpointType

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

Uitvoerwaarden

Breakpoint

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

Notities

  • U kunt Get-PSBreakpoint of de alias gbp gebruiken.