Get the breakpoints that are set in the current session, for debugging a .ps1 script.
Syntax
Get-PSBreakpoint [[-Script] string[]] [CommonParameters]
Get-PSBreakpoint -Command string[] [-Script string[]] [CommonParameters]
Get-PSBreakpoint [-Id] Int32[] [CommonParameters]
Get-PSBreakpoint [-Type] BreakpointType[] [-Script string[]] [CommonParameters]
Get-PSBreakpoint -Variable string[] [-Script string[]] [CommonParameters]
Key
-Command string[]
Get command breakpoints that are set on the specified command names.
Enter the command names, such as the name of a cmdlet or function.
-Id Int32[]
Get the breakpoints with the specified breakpoint IDs.
Enter the IDs in a comma-separated list.
You can pipe breakpoint IDs to Get-PSBreakpoint.
-Script string[]
Get only the breakpoints in the specified scripts.
Enter the path (optional) and names of one or more script
files. The default location is the current directory.
-Type BreakpointType[]
Get only breakpoints of the specified types.
Enter one or more types. Valid values are Line, Command,
and Variable. You can also pipe breakpoint types to Get-PSBreakpoint.
-Variable string[]
Get variable breakpoints that are set on the specified variable names.
Enter the variable names without dollar signs.
CommonParameters:
-Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable,
-OutBuffer -OutVariable.
Standard Aliases for Get-PSBreakpoint: gbp
A breakpoint is a point in a command or script where execution stops temporarily so that you can examine the instructions.
Examples
Get all breakpoints set on all scripts and functions in the current session:
PS C:> get-psbreakpoint
Get the breakpoint with breakpoint ID 2:
PS C:> get-psbreakpoint -Id 2
Get a breakpoint on the ss64 function in demo.ps1 by piping a breakpoint ID:
PS C:> $brk = set-psbreakpoint -script demo.ps1 -function ss64
PS C:> $brk.Id | get-psbreakpoint
Get all breakpoints for the scripts Demo1 and Demo2.ps1:
PS C:> get-psbreakpoint -script Demo1.ps1, Demo2.ps1
Get all breakpoints that are set on Read-Host or Write-Host commands in the Demo1.ps1 file:
PS C:> get-psbreakpoint -command Read-Host, Write-Host -script Demo1.ps1
Get all the Command breakpoints in Demo1.ps1:
PS C:> get-psbreakpoint -type Command -script Demo1.ps1
Get breakpoints that are set on the $var1 and $var2 variables in the current session.:
PS C:> get-psbreakpoint -variable var1, var2
Get all line and variable breakpoints in Demo1.ps1:
PS C:> get-psbreakpoint -type line, variable -script Demo1.ps1
“Better bend than break” ~ Scottish Proverb
Related PowerShell Cmdlets:
Enable-PSBreakpoint - Enable breakpoints in the current console