Set-PSBreakpoint

Set-PSBreakpoint -Command <string[]> [[-Script] <string[]>] [-Action <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint [-Script] <string[]> [-Line] <Int32[]> [[-Column] <int>] [-Action <scriptblock>] [<CommonParameters>]

Set-PSBreakpoint -Variable <string[]> [[-Script] <string[]>] [-Mode {<Read> | <Write> | <ReadWrite>}] [-Action <scriptblock>] [<CommonParameters>]

C:\PS>set-psbreakpoint -script sample.ps1 -line 5

Column     : 0
Line       : 5
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

설명
-----------
이 명령은 Sample.ps1 스크립트의 줄 5에 중단점을 설정합니다. 따라서 스크립트가 실행되면 줄 5가 실행되기 직전에 실행이 중지됩니다.

줄 번호로 새 중단점을 설정하는 경우 Set-PSBreakpoint cmdlet은 다음 샘플 출력에서와 같이 중단점 ID와 적중 횟수가 포함된 줄 중단점 개체(System.Management.Automation.LineBreakpoint)를 생성합니다.

C:\PS>set-psbreakpoint -command Increment -script sample.ps1

Command    : Increment
Action     :
Enabled    : True
HitCount   : 0
Id         : 1
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

설명
-----------
이 명령은 Sample.ps1 cmdlet의 Increment 함수에 명령 중단점을 만듭니다. 매번 지정된 함수를 호출하기 직전에 스크립트의 실행이 중지됩니다.

만들어지는 개체는 명령 중단점 개체입니다. 스크립트가 실행되기 전 HitCount 속성의 값은 0입니다.

C:\PS>set-psbreakpoint -script sample.ps1 -variable Server -Mode ReadWrite

설명
-----------
이 명령은 Sample.ps1 스크립트의 Server 변수에 중단점을 설정합니다. 이 명령은 ReadWrite 값과 함께 Mode 매개 변수를 사용하여 변수 값을 읽거나 값을 변경하기 직전 실행을 중지합니다.

C:\PS>set-psbreakpoint -script Sample.ps1 -command "write*"

설명
-----------
이 명령은 Sample.ps1 스크립트에서 "write"로 시작하는 모든 명령(예: "write-host")에 중단점을 설정합니다.

C:\PS>set-psbreakpoint -script test.ps1 -command DiskTest `
  -action { (if $disk -gt 2) { break } }

설명
-----------
이 명령은 $disk 변수 값이 2보다 큰 경우에만 Test.ps1 스크립트의 DiskTest 함수에서 실행을 중지합니다.

이 명령은 Set-PSBreakpoint cmdlet을 사용하여 DiskTest 함수에 명령 중단점을 설정합니다. 작업의 값은 함수에서 $disk 변수의 값을 테스트하는 스크립트 블록입니다.

이 작업에서는 BREAK 키워드를 사용하여 조건이 충족된 경우 실행을 중지합니다. 기본값이기도 한 다른 값은 CONTINUE입니다.

C:\PS>set-psbreakpoint -command checkpoint-computer

Id       : 0
Command  : checkpoint-computer
Enabled  : True
HitCount : 0
Action   :

C:\PS> function CheckLog {
>> get-eventlog -log Application | 
>> where {($_.source -like "TestApp") -and ($_.Message -like "*failed*")}
>>}
>>
C:\PS> Checklog
DEBUG: Hit breakpoint(s)
DEBUG:  Function breakpoint on 'prompt:Checklog'
C:\PS>>>

설명
-----------
이 명령은 CheckLog 함수에 중단점을 설정합니다. 명령이 스크립트를 지정하지 않으므로 중단점은 현재 세션에서 실행되는 모든 항목에 설정됩니다. 디버거는 함수가 선언될 때가 아니라 호출될 때 중단됩니다.

C:\PS>set-psbreakpoint -script sample.ps1 -line 1, 14, 19 -column 2 -action {&(log.ps1)}

Column     : 2
Line       : 1
Action     :
Enabled    : True
HitCount   : 0
Id         : 6
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Column     : 2
Line       : 14
Action     :
Enabled    : True
HitCount   : 0
Id         : 7
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Column     : 2
Line       : 19
Action     :
Enabled    : True
HitCount   : 0
Id         : 8
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

설명
-----------
이 명령은 Sample.ps1 스크립트에 3개의 줄 중단점을 설정합니다. 스크립트에서 지정된 각 줄의 열 2에 중단점이 하나씩 설정됩니다. Action 매개 변수에 지정된 작업은 모든 중단점에 적용됩니다.