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: | |
| 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