Get-PSBreakpoint
Hämtar brytpunkterna som anges i den aktuella sessionen.
Syntax
Line (Standard)
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
Cmdleten Get-PSBreakpoint hämtar brytpunkterna som anges i den aktuella sessionen. Du kan använda cmdlet-parametrarna för att hämta specifika brytpunkter.
En brytpunkt är en punkt i ett kommando eller skript där körningen stoppas tillfälligt så att du kan granska instruktionerna.
Get-PSBreakpoint är en av flera cmdletar som är utformade för felsökning av PowerShell-skript och -kommandon. Mer information om PowerShell-felsökningsprogrammet finns i about_Debuggers.
Exempel
Exempel 1: Hämta alla brytpunkter för alla skript och funktioner
Det här kommandot hämtar alla brytpunkter som angetts för alla skript och funktioner i den aktuella sessionen.
Get-PSBreakpoint
Exempel 2: Hämta brytpunkter efter ID
Det här kommandot hämtar brytpunkten med brytpunkts-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
Exempel 3: Skicka ett ID till Get-PSBreakpoint
Dessa kommandon visar hur du hämtar en brytpunkt genom att skicka ett brytpunkts-ID till Get-PSBreakpoint.
$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint
Cmdleten Set-PSBreakpoint skapar en brytpunkt för funktionen Increment i skriptet Sample.ps1 och sparar brytpunktsobjektet i variabeln $B. Egenskapen ID för brytpunktsobjektet i variabeln $B skickas till cmdleten Get-PSBreakpoint för att visa brytpunktsinformationen.
Exempel 4: Hämta brytpunkter i angivna skriptfiler
Det här kommandot hämtar alla brytpunkter i Sample.ps1- och SupportScript.ps1-filerna.
Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"
Det här kommandot hämtar inte andra brytpunkter som kan anges i andra skript eller på funktioner i sessionen.
Exempel 5: Hämta brytpunkter i angivna cmdletar
Det här kommandot hämtar alla kommandobrytpunkter som har angetts för Read-Host- eller Write-Host-kommandon i Sample.ps1-filen.
Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"
Exempel 6: Hämta kommandobrytpunkter i en angiven fil
Get-PSBreakpoint -Type Command -Script "Sample.ps1"
Det här kommandot hämtar alla kommandobrytpunkter i filen Sample.ps1.
Exempel 7: Hämta brytpunkter efter variabel
Det här kommandot hämtar brytpunkter som har angetts för $Index och $Swap variabler i den aktuella sessionen.
Get-PSBreakpoint -Variable "Index, Swap"
Exempel 8: Hämta alla rad- och variabel brytpunkter i en fil
Det här kommandot hämtar alla rad- och variabel brytpunkter i skriptet Sample.ps1.
Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"
Exempel 9: Hämta brytpunkterna som angetts i ett visst runspace
I det här exemplet startas ett jobb och en brytpunkt anges att brytas när Set-PSBreakpoint körs. Runspace lagras i en variabel och skickas till kommandot Get-PSBreakpoint med parametern Runspace. Du kan sedan granska brytpunkten i variabeln $breakpoint.
Start-Job -ScriptBlock {
Set-PSBreakpoint -Command Start-Sleep
Start-Sleep -Seconds 10
}
$runspace = Get-Runspace -Id 1
$breakpoint = Get-PSBreakpoint -Runspace $runspace
Parametrar
-Command
Anger en matris med kommandobrytpunkter som har angetts för de angivna kommandonamnen. Ange kommandonamnen, till exempel namnet på en cmdlet eller funktion.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Command
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Id
Anger brytpunkts-ID:t som den här cmdleten hämtar. Ange ID:t i en kommaavgränsad lista. Du kan också skicka brytpunkts-ID:t till Get-PSBreakpoint.
Parameteregenskaper
| Typ: | Int32[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Id
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Runspace
Anger ID för ett Runspace- objekt så att du kan interagera med brytpunkter i det angivna körningsutrymmet.
Den här parametern lades till i PowerShell 7.2.
Parameteregenskaper
| Typ: | Runspace |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Script
Anger en matris med skript som innehåller brytpunkterna. Ange sökvägen (valfritt) och namnen på en eller flera skriptfiler. Om du utelämnar sökvägen är standardplatsen den aktuella katalogen.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Script
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
Variable
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
Command
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
Type
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Type
Anger en matris med brytpunktstyper som den här cmdleten hämtar. Ange en eller flera typer. De godtagbara värdena för den här parametern är:
- Linje
- Command
- Variabel
Du kan också skicka brytpunktstyper för att Get-PSBreakpoint.
Parameteregenskaper
| Typ: | |
| Standardvärde: | None |
| Godkända värden: | Line, Variable, Command |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Type
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Variable
Anger en matris med variabel brytpunkter som anges för de angivna variabelnamnen. Ange variabelnamnen utan dollartecken.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Variable
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
Int32
Du kan skicka brytpunkts-ID:t till den här cmdleten.
BreakpointType
Du kan skicka brytpunktstyper till den här cmdleten.
Utdata
CommandBreakpoint
LineBreakpoint
VariableBreakpoint
Breakpoint
Den här cmdleten returnerar objekt som representerar brytpunkterna i sessionen.
Kommentarer
PowerShell innehåller följande alias för Get-PSBreakpoint:
- Alla plattformar:
gbp