영어로 읽기

다음을 통해 공유

Get-PSBreakpoint

  • 참조
모듈:
Microsoft.PowerShell.Utility

현재 세션에서 설정된 중단점을 가져옵니다.

구문

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

Get-PSBreakPoint cmdlet은 현재 세션에서 설정된 중단점을 가져옵니다. cmdlet 매개 변수를 사용하여 특정 중단점을 가져올 수 있습니다.

중단점은 명령을 검사할 수 있도록 실행이 일시적으로 중지되는 명령 또는 스크립트의 지점입니다. Get-PSBreakpoint PowerShell 스크립트 및 명령을 디버깅하도록 설계된 여러 cmdlet 중 하나입니다. PowerShell 디버거에 대한 자세한 내용은 about_Debuggers참조하세요.

예제

예제 1: 모든 스크립트 및 함수에 대한 모든 중단점 가져오기

이 명령은 현재 세션의 모든 스크립트 및 함수에 설정된 모든 중단점을 가져옵니다.

Get-PSBreakpoint

예제 2: ID별 중단점 가져오기

이 명령은 중단점 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

예제 3: ID를 'Get-PSBreakpoint'로 파이프

이러한 명령은 중단점 ID를 Get-PSBreakpoint파이프하여 중단점을 가져오는 방법을 보여 줍니다.

$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint

Set-PSBreakpoint cmdlet은 Sample.ps1 스크립트의 증분 함수에 중단점을 만들고 중단점 개체를 $B 변수에 저장합니다. $B 변수에 있는 중단점 개체의 ID 속성은 중단점 정보를 표시하기 위해 Get-PSBreakpoint cmdlet에 파이프됩니다.

예제 4: 지정된 스크립트 파일에서 중단점 가져오기

이 명령은 Sample.ps1 및 SupportScript.ps1 파일의 모든 중단점을 가져옵니다.

Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

이 명령은 다른 스크립트 또는 세션의 함수에서 설정할 수 있는 다른 중단점을 얻지 않습니다.

예제 5: 지정된 cmdlet에서 중단점 가져오기

이 명령은 Sample.ps1 파일의 Read-Host 또는 Write-Host 명령에 설정된 모든 명령 중단점을 가져옵니다.

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

예제 6: 지정된 파일에서 명령 중단점 가져오기

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

이 명령은 Sample.ps1 파일의 모든 명령 중단점을 가져옵니다.

예제 7: 변수별 중단점 가져오기

이 명령은 현재 세션의 $Index$Swap 변수에 설정된 중단점을 가져옵니다.

Get-PSBreakpoint -Variable "Index, Swap"

예제 8: 파일의 모든 줄 및 변수 중단점 가져오기

이 명령은 Sample.ps1 스크립트의 모든 줄 및 변수 중단점을 가져옵니다.

Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

예제 9: 특정 Runspace에서 설정된 중단점 가져오기

이 예제에서는 작업이 시작되고 Set-PSBreakPoint 실행될 때 중단점이 중단되도록 설정됩니다. runspace는 변수에 저장되고 Runspace 매개 변수를 사용하여 Get-PSBreakPoint 명령에 전달됩니다. 그런 다음 $breakpoint 변수에서 중단점을 검사할 수 있습니다.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakPoint -Runspace $runspace

매개 변수

-Command

지정된 명령 이름에 설정된 명령 중단점의 배열을 지정합니다. cmdlet 또는 함수의 이름과 같은 명령 이름을 입력합니다.

형식:String[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Id

이 cmdlet이 가져오는 중단점 ID를 지정합니다. 쉼표로 구분된 목록에 ID를 입력합니다. 중단점 ID를 Get-PSBreakpoint파이프할 수도 있습니다.

형식:Int32[]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Runspace

지정된 runspace에서 중단점과 상호 작용할 수 있도록 Runspace 개체의 ID를 지정합니다.

이 매개 변수는 PowerShell 7.2에 추가되었습니다.

형식:Runspace
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Script

중단점을 포함하는 스크립트 배열을 지정합니다. 하나 이상의 스크립트 파일의 경로(선택 사항) 및 이름을 입력합니다. 경로를 생략하면 기본 위치는 현재 디렉터리입니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Type

이 cmdlet이 가져오는 중단점 형식의 배열을 지정합니다. 하나 이상의 형식을 입력합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 줄
  • 명령
  • 변수

중단점 유형을 Get-PSBreakPoint파이프할 수도 있습니다.

형식:BreakpointType[]
허용되는 값:Line, Variable, Command
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Variable

지정된 변수 이름에 설정된 변수 중단점의 배열을 지정합니다. 달러 기호 없이 변수 이름을 입력합니다.

형식:String[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Int32

중단점 ID를 이 cmdlet으로 파이프할 수 있습니다.

BreakpointType

중단점 유형을 이 cmdlet으로 파이프할 수 있습니다.

출력

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

이 cmdlet은 세션의 중단점을 나타내는 개체를 반환합니다.

참고

PowerShell에는 Get-PSBreakpoint다음과 같은 별칭이 포함되어 있습니다.

  • 모든 플랫폼:
    • gbp