Delen via

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 waar de uitvoering tijdelijk wordt gestopt, zodat u de instructies kunt bekijken. Get-PSBreakpoint is een van de vele 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 die zijn ingesteld voor alle scripts en functies in de huidige sessie.

Get-PSBreakpoint

Voorbeeld 2: onderbrekingspunten ophalen op id

Met deze opdracht wordt het onderbrekingspunt opgehaald met de onderbrekingspunt-id 2.

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 sluizen naar Get-PSBreakpoint.

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

De Set-PSBreakpoint cmdlet 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 $B variabele wordt doorgesluisd naar de Get-PSBreakpoint cmdlet om de onderbrekingspuntinformatie weer te geven.

Voorbeeld 4: onderbrekingspunten ophalen in opgegeven scriptbestanden

Met deze opdracht worden alle onderbrekingspunten in de Sample.ps1 bestanden en SupportScript.ps1 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 haalt u alle opdrachtonderbrekingspunten op die zijn ingesteld op Read-Host of Write-Host opdrachten in het Sample.ps1 bestand.

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

Voorbeeld 6: Opdrachtonderbrekingspunten ophalen in een opgegeven bestand

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

Met deze opdracht worden alle opdrachtonderbrekingspunten in het Sample.ps1-bestand.

Voorbeeld 7: Onderbrekingspunten ophalen per variabele

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

Get-PSBreakpoint -Variable "Index, Swap"

Voorbeeld 8: alle regel- en variabele onderbrekingspunten in een bestand ophalen

Met deze opdracht worden alle regel- en variabele onderbrekingspunten in het Sample.ps1 script opgehaald.

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

Voorbeeld 9: de onderbrekingspunten ophalen die zijn ingesteld in een specifieke runspace

In dit voorbeeld wordt een taak gestart en wordt een onderbrekingspunt ingesteld op onderbreking wanneer de Set-PSBreakPoint wordt uitgevoerd. De runspace wordt opgeslagen in een variabele en doorgegeven aan de Get-PSBreakPoint opdracht met de parameter Runspace . Vervolgens kunt u het onderbrekingspunt in de $breakpoint variabele inspecteren.

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

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakPoint -Runspace $runspace

Parameters

-Command

Hiermee geeft u een matrix met 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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Runspace

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

Deze parameter is toegevoegd in PowerShell 7.2.

Type:Runspace
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Script

Hiermee geeft u een matrix met 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Type

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

  • Lijn
  • Opdracht
  • Variabele

U kunt ook onderbrekingspunttypen doorspeken naar Get-PSBreakPoint.

Type:BreakpointType[]
Accepted values:Line, Variable, Command
Position:0
Default value:None
Required:True
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 namen van de variabelen in zonder dollartekens.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

Int32

U kunt onderbrekingspunt-id's doorsluizen naar deze cmdlet.

BreakpointType

U kunt onderbrekingspunttypen doorspeken naar deze cmdlet.

Uitvoerwaarden

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Deze cmdlet retourneert objecten die de onderbrekingspunten in de sessie vertegenwoordigen.

Notities

PowerShell bevat de volgende aliassen voor Get-PSBreakpoint:

  • Alle platformen:
    • gbp