Get-PSBreakpoint
Gets the breakpoints that are set in the current session.
구문
Script (기본값)
Get-PSBreakpoint
[-Script <String[]>]
[<CommonParameters>]
Variable
Get-PSBreakpoint
-Variable <String[]>
[-Script <String[]>]
[<CommonParameters>]
Command
Get-PSBreakpoint
-Command <String[]>
[-Script <String[]>]
[<CommonParameters>]
Type
Get-PSBreakpoint
[-Type] <BreakpointType[]>
[-Script <String[]>]
[<CommonParameters>]
Id
Get-PSBreakpoint
[-Id] <Int32[]>
[<CommonParameters>]
Description
The Get-PSBreakpoint cmdlet gets the breakpoints that are set in the current session. You can use
the cmdlet parameters to get particular breakpoints.
A breakpoint is a point in a command or script where execution stops temporarily so that you can
examine the instructions. Get-PSBreakpoint is one of several cmdlets designed for debugging
PowerShell scripts and commands. For more information about the PowerShell debugger, see
about_Debuggers.
예제
Example 1: Get all breakpoints for all scripts and functions
This command gets all breakpoints set on all scripts and functions in the current session.
Get-PSBreakpoint
Example 2: Get breakpoints by ID
This command gets the breakpoint with breakpoint 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
Example 3: Pipe an ID to `Get-PSBreakpoint`
These commands show how to get a breakpoint by piping a breakpoint ID to Get-PSBreakpoint.
$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint
The Set-PSBreakpoint cmdlet creates a breakpoint on the Increment function in the Sample.ps1
script and saves the breakpoint object in the $B variable. The Id property of the breakpoint
object in the $B variable is piped to the Get-PSBreakpoint cmdlet to display the breakpoint
information.
Example 4: Get breakpoints in specified script files
This command gets all of the breakpoints in the Sample.ps1 and SupportScript.ps1 files.
Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"
This command does not get other breakpoints that might be set in other scripts or on functions in the session.
Example 5: Get breakpoints in specified cmdlets
This command gets all Command breakpoints that are set on Read-Host or Write-Host commands in
the Sample.ps1 file.
Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"
Example 6: Get Command breakpoints in a specified file
Get-PSBreakpoint -Type Command -Script "Sample.ps1"
This command gets all Command breakpoints in the Sample.ps1 file.
Example 7: Get breakpoints by variable
This command gets breakpoints that are set on the $Index and $Swap variables in the current
session.
Get-PSBreakpoint -Variable "Index, Swap"
Example 8: Get all Line and Variable breakpoints in a file
This command gets all line and variable breakpoints in the Sample.ps1 script.
Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"
매개 변수
-Command
Specifies an array of command breakpoints that are set on the specified command names. Enter the command names, such as the name of a cmdlet or function.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Command
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Id
Specifies the breakpoint IDs that this cmdlet gets. Enter the IDs in a comma-separated list. You can
also pipe breakpoint IDs to Get-PSBreakpoint.
매개 변수 속성
| 형식: | Int32[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Id
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Script
Specifies an array of scripts that contain the breakpoints. Enter the path (optional) and names of one or more script files. If you omit the path, the default ___location is the current directory.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Script
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
Variable
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
Command
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
Type
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Type
Specifies an array of breakpoint types that this cmdlet gets. Enter one or more types. The acceptable values for this parameter are:
- Line
- Command
- Variable
You can also pipe breakpoint types to Get-PSBreakpoint.
매개 변수 속성
| 형식: | |
| Default value: | None |
| 허용되는 값: | Line, Variable, Command |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Type
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Variable
Specifies an array of variable breakpoints that are set on the specified variable names. Enter the variable names without dollar signs.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Variable
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
입력
Int32
You can pipe breakpoint IDs to this cmdlet.
BreakpointType
You can pipe breakpoint types to this cmdlet.
출력
CommandBreakpoint
LineBreakpoint
VariableBreakpoint
Breakpoint
This cmdlet returns objects that represent the breakpoints in the session.
참고
Windows PowerShell includes the following aliases for Get-PSBreakpoint:
gbp
