Dela via


Get-PSBreakpoint

Hämtar brytpunkterna som anges i den aktuella sessionen.

Syntax

Script (Standard)

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

Type

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

Command

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

Variable

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

Id

Get-PSBreakpoint
    [-Id] <Int32[]>
    [<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 är utformade för felsökning av Windows PowerShell-skript och -kommandon. Mer information om Windows PowerShell-felsökningsprogrammet finns i about_Debuggers.

Exempel

Exempel 1: Hämta alla brytpunkter för alla skript och funktioner

PS C:\> Get-PSBreakpoint

Det här kommandot hämtar alla brytpunkter som angetts för alla skript och funktioner i den aktuella sessionen.

Exempel 2: Hämta brytpunkter efter ID

PS C:\> Get-PSBreakpoint -Id 2
Function   :
IncrementAction     :
Enabled    :
TrueHitCount   : 0
Id         : 2
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Det här kommandot hämtar brytpunkten med brytpunkts-ID 2.

Exempel 3: Skicka ett ID till Get-PSBreakpoint

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Command "Increment"
PS C:\> $B.Id | Get-PSBreakpoint

Dessa kommandon visar hur du hämtar en brytpunkt genom att skicka ett brytpunkts-ID till Get-PSBreakpoint.

Det första kommandot använder cmdleten Set-PSBreakpoint för att skapa en brytpunkt för funktionen Increment i skriptet Sample.ps1. Det sparar brytpunktsobjektet i variabeln $B.

Det andra kommandot använder punktoperatorn (.) för att hämta ID-egenskapen för brytpunktsobjektet i variabeln $B. Den använder en pipelineoperator (|) för att skicka ID:t till cmdleten Get-PSBreakpoint.

Därför hämtar Get-PSBreakpoint brytpunkten med det angivna ID:t.

Exempel 4: Hämta brytpunkter i angivna skriptfiler

PS C:\> Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

Det här kommandot hämtar alla brytpunkter i Sample.ps1- och SupportScript.ps1-filerna.

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

PS C:\> Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

Det här kommandot hämtar alla kommandobrytpunkter som har angetts för Read-Host- eller Write-Host-kommandon i Sample.ps1-filen.

Exempel 6: Hämta kommandobrytpunkter i en angiven fil

PS C:\> 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

PS C:\> Get-PSBreakpoint -Variable "Index, Swap"

Det här kommandot hämtar brytpunkter som anges på $Index och $Swap variabler i den aktuella sessionen.

Exempel 8: Hämta alla rad- och variabel brytpunkter i en fil

PS C:\> Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

Det här kommandot hämtar alla rad- och variabel brytpunkter i skriptet Sample.ps1.

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

-Script

Anger en matris med skript som innehåller brytpunkterna. Ange sökvägen 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:0
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:0
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:0
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:0
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
  • Kommando
  • Variabel

Du kan också skicka brytpunktstyper för att Get-PSBreakPoint-.

Parameteregenskaper

Typ:

BreakpointType[]

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

System.Int32, Microsoft.PowerShell.Commands.BreakpointType

Du kan skicka brytpunkts-ID:er och brytpunktstyper till Get-PSBreakPoint-.

Utdata

Breakpoint

Get-PSBreakPoint- returnerar objekt som representerar brytpunkterna i sessionen.

Kommentarer

  • Du kan använda Get-PSBreakpoint eller dess alias, "gbp".