Delen via


Get-PSBreakpoint

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

Syntaxis

Line (Standaard)

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

Command

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

Variable

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

Type

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

Id

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_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"

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 wordt uitgevoerd. De runspace wordt opgeslagen in een variabele en doorgegeven aan de opdracht Get-PSBreakpoint met de parameter Runspace. Vervolgens kunt u het onderbrekingspunt in de variabele $breakpoint 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.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Command
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Int32[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Id
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:Runspace
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Script
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
Variable
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
Command
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
Type
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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
  • Opdracht
  • Veranderlijk

U kunt ook typen onderbrekingspunten doorsluisen naar Get-PSBreakpoint.

Parametereigenschappen

Type:

BreakpointType[]

Default value:None
Geaccepteerde waarden:Line, Variable, Command
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Type
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Variable
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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