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 Foutopsporingsprogramma van PowerShell.

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 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 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 opgeslagen 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: 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 bestand Sample.ps1 opgeslagen.

Voorbeeld 7: Onderbrekingspunten ophalen op variabele

Met deze opdracht worden onderbrekingspunten opgeslagen die zijn ingesteld voor 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"

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 einde wanneer de Set-PSBreakPoint taak 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 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
Required:True
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
Required:True
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.

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 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
Required:False
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
  • Variabel

U kunt ook typen onderbrekingspunten doorsluisen 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 namen van variabelen. Voer de namen van variabelen zonder dollartekens in.

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

Invoerwaarden

Int32

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

BreakpointType

U kunt onderbrekingspunttypen doorsluisen naar deze cmdlet.

Uitvoerwaarden

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Met deze cmdlet worden objecten geretourneerd die de onderbrekingspunten in de sessie vertegenwoordigen.

Notities

PowerShell bevat de volgende aliassen voor Get-PSBreakpoint:

  • Alle platforms:
    • gbp