Get-PSBreakpoint

  • Referens
Modul:
Microsoft.PowerShell.Utility

Hämtar brytpunkterna som har angetts i den aktuella sessionen.

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

Cmdleten Get-PSBreakPoint hämtar de brytpunkter 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 utformats 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 . ID-egenskapen 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 filerna och SupportScript.ps1 .

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 kommando brytpunkter som är inställda på Read-Host eller Write-Host kommandon i Sample.ps1 filen.

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

Exempel 6: Hämta kommando brytpunkter i en angiven fil

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

Det här kommandot hämtar alla kommando brytpunkter i filen Sample.ps1.

Exempel 7: Hämta brytpunkter efter variabel

Det här kommandot hämtar brytpunkter som har angetts för variablerna $Index och $Swap 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 körningsutrymme

I det här exemplet startas ett jobb och en brytpunkt ställs in på att avbrytas när Set-PSBreakPoint körs. Runspace lagras i en variabel och skickas Get-PSBreakPoint till kommandot 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 kommando brytpunkter som har angetts för de angivna kommandonamnen. Ange kommandonamnen, till exempel namnet på en cmdlet eller funktion.

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

-Id

Anger brytpunkts-ID:t som denna cmdlet hämtar. Ange ID:na i en kommaavgränsad lista. Du kan också skicka brytpunkts-ID:t till Get-PSBreakpoint.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Runspace
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Type

Anger en matris med brytpunktstyper som denna cmdlet hämtar. Ange en eller flera typer. De acceptabla värdena för den här parametern är:

  • Linje
  • Kommando
  • Variabel

Du kan också skicka brytpunktstyper till 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

Anger en matris med variabel brytpunkter som anges för de angivna variabelnamnen. Ange variabelnamnen utan dollartecken.

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

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