다음을 통해 공유

디버거 정보

  • 아티클

간단한 설명

PowerShell 디버거에 대해 설명합니다.

자세한 설명

디버깅은 스크립트 명령에서 오류를 식별하고 수정하기 위해 실행되는 동안 스크립트를 검사하는 프로세스입니다. PowerShell 디버거를 사용하면 스크립트, 함수, 명령, PowerShell 워크플로, PowerShell Desired State Configuration(DSC) 구성 또는 식에서 오류 및 비효율성을 검사하고 식별할 수 있습니다.

PowerShell 5.0부터 PowerShell 디버거는 콘솔에서 실행되거나 원격 컴퓨터에서 ISE를 Windows PowerShell 스크립트, 함수, 워크플로, 명령, 구성 또는 식을 디버그하도록 업데이트되었습니다. 를 실행 Enter-PSSession 하여 원격 컴퓨터에서 중단점을 설정하고 스크립트 파일 및 명령을 디버그할 수 있는 대화형 원격 PowerShell 세션을 시작할 수 있습니다. Enter-PSSession 기능은 원격 컴퓨터에서 스크립트 또는 명령을 실행하는 연결이 끊긴 세션에 다시 연결하고 입력할 수 있도록 업데이트되었습니다. 실행 중인 스크립트가 중단점에 도달하면 클라이언트 세션이 디버거를 자동으로 시작합니다. 스크립트를 실행하는 연결이 끊긴 세션이 이미 중단점에 도달하고 중단점 Enter-PSSession 에서 중지된 경우 세션에 다시 연결한 후 명령줄 디버거를 자동으로 시작합니다.

PowerShell 디버거를 사용하여 PowerShell 콘솔 또는 Windows PowerShell ISE에서 PowerShell 워크플로를 디버그할 수도 있습니다. PowerShell 5.0부터 로컬 또는 원격으로 실행 중인 작업 또는 프로세스 내에서 디버그할 수 있습니다.

PowerShell 디버거의 기능을 사용하여 실행 중인 PowerShell 스크립트, 함수, 명령, 워크플로 또는 식을 검사할 수 있습니다. PowerShell 디버거에는 중단점을 설정하고, 중단점을 관리하고, 호출 스택을 볼 수 있는 cmdlet 집합이 포함되어 있습니다.

디버거 Cmdlet

PowerShell 디버거에는 다음 cmdlet 집합이 포함됩니다.

  • Set-PSBreakpoint: 줄, 변수 및 명령에 중단점을 설정합니다.
  • Get-PSBreakpoint: 현재 세션의 중단점을 가져옵니다.
  • Disable-PSBreakpoint: 현재 세션에서 중단점을 끕니다.
  • Enable-PSBreakpoint: 현재 세션에서 중단점을 다시 사용하도록 설정합니다.
  • Remove-PSBreakpoint: 현재 세션에서 중단점을 삭제합니다.
  • Get-PSCallStack: 현재 호출 스택을 표시합니다.

디버거 시작 및 중지

디버거를 시작하려면 하나 이상의 중단점을 설정합니다. 그런 다음 디버그하려는 스크립트, 명령 또는 함수를 실행합니다.

중단점에 도달하면 실행이 중지되고 컨트롤이 디버거로 인계됩니다.

디버거를 중지하려면 스크립트, 명령 또는 함수가 완료될 때까지 실행합니다. 또는 또는 을 입력합니다 stopt.

디버거 명령

PowerShell 콘솔에서 디버거를 사용하는 경우 다음 명령을 사용하여 실행을 제어합니다. Windows PowerShell ISE에서 디버그 메뉴의 명령을 사용합니다.

참고: 다른 호스트 애플리케이션에서 디버거를 사용하는 방법에 대한 자세한 내용은 호스트 애플리케이션 설명서를 참조하세요.

  • s, StepInto: 다음 문을 실행한 다음 중지합니다.

  • v, StepOver: 다음 문을 실행하지만 함수 및 호출을 건너뜁니다. 건너뛴 문은 실행되지만 단계별로 실행되지는 않습니다.

  • Ctrl+Break: (ISE에서 모두 중단) PowerShell 콘솔 또는 Windows PowerShell ISE 내에서 실행 중인 스크립트로 나뉩니다. Windows PowerShell 2.0, 3.0 및 4.0의 Ctrl+나누기는 프로그램을 닫습니다. 중단 모두 로컬 및 원격 대화형 실행 스크립트 모두에서 작동합니다.

  • o, StepOut: 현재 함수에서 한 단계씩 나가고 중첩된 경우 한 수준 위로 올라갔습니다. 기본 본문에 있는 경우 끝 또는 다음 중단점까지 계속됩니다. 건너뛴 문은 실행되지만 단계별로 실행되지는 않습니다.

  • c, Continue: 스크립트가 완료되거나 다음 중단점에 도달할 때까지 계속 실행됩니다. 건너뛴 문은 실행되지만 단계별로 실행되지는 않습니다.

  • l, List: 실행 중인 스크립트의 부분을 표시합니다. 기본적으로 현재 줄, 5개의 이전 줄 및 10개의 후속 줄이 표시됩니다. 스크립트를 계속 나열하려면 Enter 키를 누릅니다.

  • l <m>, List: 로 지정된 줄 번호로 시작하는 스크립트의 16줄을 <m>표시합니다.

  • l <m> <n>, List: 로 <n> 지정된 <m>줄 번호부터 시작하여 스크립트의 줄을 표시합니다.

  • q, Stop, Exit: 스크립트 실행을 중지하고 디버거를 종료합니다. cmdlet Exit 을 실행 Debug-Job 하여 작업을 디버깅하는 경우 명령은 디버거를 분리하고 작업이 계속 실행되도록 허용합니다.

  • k, Get-PsCallStack: 현재 호출 스택을 표시합니다.

  • <Enter>: Step(s), StepOver(v) 또는 List(l)인 경우 마지막 명령을 반복합니다. 그렇지 않으면 은 제출 작업을 나타냅니다.

  • ?, h: 디버거 명령 도움말을 표시합니다.

디버거를 종료하려면 중지(q)를 사용할 수 있습니다.

PowerShell 5.0부터 Exit 명령을 실행하여 또는 Debug-Runspace를 실행 Debug-Job 하여 시작한 중첩된 디버깅 세션을 종료할 수 있습니다.

이러한 디버거 명령을 사용하면 스크립트를 실행하고, 우려 지점에서 중지하고, 변수 값과 시스템 상태를 검사하고, 문제를 식별할 때까지 스크립트를 계속 실행할 수 있습니다.

참고: ">"와 같은 리디렉션 연산자를 사용하여 문을 한 단계씩 실행하면 PowerShell 디버거가 스크립트의 나머지 모든 문을 단계별로 실행합니다.

스크립트 변수 값 표시

디버거에 있는 동안 명령을 입력하고, 변수 값을 표시하고, cmdlet을 사용하고, 명령줄에서 스크립트를 실행할 수도 있습니다.

다음 자동 변수를 제외하고 디버깅 중인 스크립트에 있는 모든 변수의 현재 값을 표시할 수 있습니다.

$_
$Args
$Input
$MyInvocation
$PSBoundParameters

이러한 변수의 값을 표시하려는 경우 스크립트의 변수 값이 아니라 디버거가 사용하는 내부 파이프라인의 해당 변수 값을 가져옵니다.

디버깅 중인 스크립트에 대해 이러한 변수 값을 표시하려면 스크립트에서 자동 변수의 값을 새 변수에 할당합니다. 그런 다음 새 변수의 값을 표시할 수 있습니다.

예를 들면 다음과 같습니다.

$scriptArgs = $Args
$scriptArgs

이 항목의 예제에서 변수 값 $MyInvocation 은 다음과 같이 다시 할당됩니다.

$scriptname = $MyInvocation.MyCommand.Path

디버거 환경

중단점에 도달하면 디버거 환경을 입력합니다. 명령 프롬프트가 변경되어 "[DBG]:"로 시작합니다. 워크플로를 디버깅하는 경우 프롬프트는 "[WFDBG]"입니다. 프롬프트를 사용자 지정할 수 있습니다.

프롬프트를 사용자 지정하는 방법에 대한 자세한 내용은 about_Prompts.

또한 PowerShell 콘솔과 같은 일부 호스트 애플리케이션에서는(Windows PowerShell ISE] 통합 스크립팅 환경에서는 아님) 중첩된 프롬프트가 열리고 디버깅이 수행됩니다. 명령 프롬프트에 나타나는 보다 큰 문자(ASCII 62)를 반복하여 중첩된 프롬프트를 검색할 수 있습니다.

예를 들어 PowerShell 콘솔의 기본 디버깅 프롬프트는 다음과 같습니다.

[DBG]: PS (get-location)>>>

자동 변수를 사용하여 $NestedPromptLevel 중첩 수준을 찾을 수 있습니다.

또한 자동 변수인 $PSDebugContext는 로컬 scope 정의됩니다. 변수의 $PsDebugContext 존재를 사용하여 디버거에 있는지 여부를 확인할 수 있습니다.

예를 들면 다음과 같습니다.

if ($PSDebugContext) {"Debugging"} else {"Not Debugging"}

디버깅에서 변수 값을 $PSDebugContext 사용할 수 있습니다.

[DBG]: PS>>> $PSDebugContext.InvocationInfo

Name   CommandLineParameters  UnboundArguments  Location
----   ---------------------  ----------------  --------
=      {}                     {}                C:\ps-test\vote.ps1 (1)

디버깅 및 범위

디버거에 침입해도 작업 중인 scope 변경되지 않지만 스크립트의 중단점에 도달하면 스크립트 scope 이동합니다. scope 스크립트는 디버거를 실행한 scope 자식입니다.

스크립트 scope 정의된 변수 및 별칭을 찾으려면 또는 Get-Variable cmdlet의 Scope 매개 변수를 Get-Alias 사용합니다.

예를 들어 다음 명령은 로컬(스크립트) scope 변수를 가져옵니다.

Get-Variable -scope 0

명령을 다음과 같이 축약할 수 있습니다.

gv -s 0

이는 스크립트에서 정의한 변수와 디버깅하는 동안 정의한 변수만 볼 수 있는 유용한 방법입니다.

명령줄에서 디버깅

변수 중단점 또는 명령 중단점을 설정하는 경우 스크립트 파일에서만 중단점을 설정할 수 있습니다. 그러나 기본적으로 중단점은 현재 세션에서 실행되는 모든 항목에 대해 설정됩니다.

예를 들어 변수에 $name 중단점을 설정하는 경우 디버거는 중단점을 사용하지 않도록 설정하거나 제거할 때까지 실행하는 스크립트, 명령, 함수, 스크립트 cmdlet 또는 식의 모든 $name 변수에서 중단됩니다.

이렇게 하면 세션 및 사용자 프로필의 함수, 변수 및 기타 스크립트의 영향을 받을 수 있는 보다 현실적인 컨텍스트에서 스크립트를 디버그할 수 있습니다.

줄 중단점은 스크립트 파일에만 적용되므로 스크립트 파일에만 설정됩니다.

워크플로 디버깅

PowerShell 4.0 디버거를 사용하여 PowerShell 콘솔 또는 Windows PowerShell ISE에서 PowerShell 워크플로를 디버그할 수 있습니다. PowerShell 디버거를 사용하여 워크플로를 디버그하는 데 몇 가지 제한 사항이 있습니다.

  • 디버거에 있는 동안 워크플로 변수를 볼 수 있지만 디버거 내에서 워크플로 변수 설정은 지원되지 않습니다.
  • 워크플로 디버거에서 중지된 경우 탭 완성을 사용할 수 없습니다.
  • 워크플로 디버깅은 PowerShell 스크립트에서 워크플로를 동기적으로 실행하는 경우에만 작동합니다. 워크플로가 작업으로 실행되는 경우( AsJob 매개 변수 사용) 워크플로를 디버그할 수 없습니다.
  • 다른 워크플로를 호출하는 워크플로 또는 스크립트를 호출하는 워크플로와 같은 다른 중첩된 디버깅 시나리오는 구현되지 않습니다.

다음 예제에서는 워크플로 디버깅을 보여 줍니다. 디버거가 워크플로 함수로 이동하면 디버거 프롬프트가 "[WFDBG]"로 변경됩니다.

PS C:> Set-PSBreakpoint -Script C:\TestWFDemo1.ps1 -Line 8

ID Script           Line Command    Variable     Action
-- ------           ---- -------    --------     ------
0 TestWFDemo1.ps1   8

PS C:> C:\TestWFDemo1.ps1
Entering debug mode. Use h or ? for help.

Hit Line breakpoint on 'C:\TestWFDemo1.ps1:8'

At C:\TestWFDemo1.ps1:8 char:5
+     Write-Output -InputObject "Now writing output:"
# +!INCLUDE[]~~~~~

[WFDBG:localhost]: PS C:>> list

# 3:

4:  workflow SampleWorkflowTest
5:  {
6:      param ($MyOutput)
# 7:

8:*     Write-Output -InputObject "Now writing output:"
9:      Write-Output -Input $MyOutput
# 10:

11:      Write-Output -InputObject "Get PowerShell process:"
12:      Get-Process -Name powershell
# 13:

14:      Write-Output -InputObject "Workflow function complete."
15:  }
# 16:

17:  # Call workflow function
18:  SampleWorkflowTest -MyOutput "Hello"

[WFDBG:localhost]: PS C:>> $MyOutput
Hello
[WFDBG:localhost]: PS C:>> stepOver
Now writing output:
At C:\TestWFDemo1.ps1:9 char:5
+     Write-Output -Input $MyOutput
# +!INCLUDE[]~

[WFDBG:localhost]: PS C:>> list

4:  workflow SampleWorkflowTest
5:  {
6:      param ($MyOutput)
# 7:

8:      Write-Output -InputObject "Now writing output:"
9:*     Write-Output -Input $MyOutput
# 10:

11:      Write-Output -InputObject "Get PowerShell process:"
12:      Get-Process -Name powershell
# 13:

14:      Write-Output -InputObject "Workflow function complete."
15:  }
# 16:

17:  # Call workflow function
18:  SampleWorkflowTest -MyOutput "Hello"
# 19:


[WFDBG:localhost]: PS C:>> stepOver
Hello
At C:\TestWFDemo1.ps1:11 char:5
+     Write-Output -InputObject "Get PowerShell process:"
# +!INCLUDE[]~~~~~~~~~

[WFDBG:localhost]: PS C:>> stepOut
Get PowerShell process:

Handles  NPM(K)    PM(K)    WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----    ----- -----   ------     -- -----------
    433      35   106688   128392   726     2.67   7124 powershell
    499      44   134244   172096   787     2.79   7452 powershell

Workflow function complete.

디버깅 함수

, 및 ProcessEnd 섹션이 있는 Begin함수에 중단점을 설정하면 디버거가 각 섹션의 첫 번째 줄에서 중단됩니다.

예를 들면 다음과 같습니다.

function test-cmdlet {
    begin {
        write-output "Begin"
    }
    process {
        write-output "Process"
    }
    end {
        write-output "End"
    }
}

C:\PS> Set-PSBreakpoint -command test-cmdlet

C:\PS> test-cmdlet

Begin
Entering debug mode. Use h or ? for help.

Hit Command breakpoint on 'prompt:test-cmdlet'

test-cmdlet

[DBG]: C:\PS> c
Process
Entering debug mode. Use h or ? for help.

Hit Command breakpoint on 'prompt:test-cmdlet'

test-cmdlet

[DBG]: C:\PS> c
End
Entering debug mode. Use h or ? for help.

Hit Command breakpoint on 'prompt:test-cmdlet'

test-cmdlet

# [DBG]: C:\PS>

원격 스크립트 디버깅

PowerShell 5.0부터 원격 세션, 콘솔 또는 Windows PowerShell ISE에서 PowerShell 디버거를 실행할 수 있습니다. Enter-PSSession 기능은 원격 컴퓨터에서 실행되고 현재 스크립트를 실행하는 연결이 끊긴 세션에 다시 연결하고 입력할 수 있도록 업데이트되었습니다. 실행 중인 스크립트가 중단점에 도달하면 클라이언트 세션이 디버거를 자동으로 시작합니다.

다음은 6, 11, 22 및 25줄의 스크립트에서 중단점이 설정된 상태에서 작동 방식을 보여 주는 예제입니다. 이 예제에서는 디버거가 시작될 때 두 가지 식별 프롬프트가 있습니다. 즉, 세션이 실행 중인 컴퓨터의 이름과 디버깅 모드에 있음을 알 수 있는 DBG 프롬프트가 있습니다.

Enter-Pssession -Cn localhost
[localhost]: PS C:\psscripts> Set-PSBreakpoint .\ttest19.ps1 6,11,22,25

ID Script          Line     Command          Variable          Action
-- ------          ----     -------          --------          ------
0 ttest19.ps1          6
1 ttest19.ps1          11
2 ttest19.ps1          22
3 ttest19.ps1          25

[localhost]: PS C:\psscripts> .\ttest19.ps1
Hit Line breakpoint on 'C:\psscripts\ttest19.ps1:11'

At C:\psscripts\ttest19.ps1:11 char:1
+ $winRMName = "WinRM"
# + ~

[localhost]: [DBG]: PS C:\psscripts>> list

6:      1..5 | foreach { sleep 1; Write-Output "hello2day $_" }
7:  }
# 8:

9:  $count = 10
10:  $psName = "PowerShell"
11:* $winRMName = "WinRM"
12:  $myVar = 102
# 13:

14:  for ($i=0; $i -lt $count; $i++)
15:  {
16:      sleep 1
17:      Write-Output "Loop iteration is: $i"
18:      Write-Output "MyVar is $myVar"
# 19:

20:      hello2day
# 21:


[localhost]: [DBG]: PS C:\psscripts>> stepover
At C:\psscripts\ttest19.ps1:12 char:1
+ $myVar = 102
# + ~

[localhost]: [DBG]: PS C:\psscripts>> quit
[localhost]: PS C:\psscripts> Exit-PSSession
PS C:\psscripts>

예제

이 테스트 스크립트는 운영 체제의 버전을 검색하고 시스템에 적합한 메시지를 표시합니다. 여기에는 함수, 함수 호출 및 변수가 포함됩니다.

다음 명령은 테스트 스크립트 파일의 내용을 표시합니다.

PS C:\PS-test>  Get-Content test.ps1

function psversion {
  "PowerShell " + $PSVersionTable.PSVersion
  if ($PSVersionTable.PSVersion.Major -lt 6) {
    "Upgrade to PowerShell 6.0!"
  }
  else {
    "Have you run a background job today (start-job)?"
  }
}

$scriptName = $MyInvocation.MyCommand.Path
psversion
"Done $scriptName."

시작하려면 줄, 명령, 변수 또는 함수와 같은 스크립트에 관심 있는 지점에서 중단점을 설정합니다.

먼저 현재 디렉터리에 있는 Test.ps1 스크립트의 첫 번째 줄에 줄 중단점을 만듭니다.

PS C:\ps-test> Set-PSBreakpoint -line 1 -script test.ps1

이 명령을

PS C:\ps-test> spb 1 -s test.ps1

명령은 줄 바꿈점 개체(System.Management.Automation.LineBreakpoint)를 반환합니다.

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

이제 스크립트를 시작합니다.

PS C:\ps-test> .\test.ps1

스크립트가 첫 번째 중단점에 도달하면 중단점 메시지는 디버거가 활성 상태임을 나타냅니다. 중단점을 설명하고 함수 선언인 스크립트의 첫 번째 줄을 미리 봅니다. 명령 프롬프트도 변경되어 디버거가 제어할 수 있음을 나타냅니다.

미리 보기 줄에는 미리 보기 명령의 스크립트 이름과 줄 번호가 포함됩니다.

Entering debug mode. Use h or ? for help.

Hit Line breakpoint on 'C:\ps-test\test.ps1:1'

test.ps1:1   function psversion {
# DBG>

Step 명령을 사용하여 스크립트에서 첫 번째 문을 실행하고 다음 문을 미리 봅니다. 다음 문은 자동 변수를 $MyInvocation 사용하여 변수 값을 스크립트 파일의 $scriptName 경로 및 파일 이름으로 설정합니다.

DBG> s
test.ps1:11  $scriptName = $MyInvocation.MyCommand.Path

이 시점에서 변수는 $scriptName 채워지지 않지만 해당 값을 표시하여 변수의 값을 확인할 수 있습니다. 이 경우 값은 $null입니다.

DBG> $scriptname
# DBG>

다른 Step 명령을 사용하여 현재 문을 실행하고 스크립트에서 다음 문을 미리 봅니다. 다음 문은 PsVersion 함수를 호출합니다.

DBG> s
test.ps1:12  psversion

이때 변수가 $scriptName 채워지지만 해당 값을 표시하여 변수의 값을 확인합니다. 이 경우 값은 스크립트 경로로 설정됩니다.

DBG> $scriptName
C:\ps-test\test.ps1

다른 Step 명령을 사용하여 함수 호출을 실행합니다. Enter 키를 누르거나 단계에 "s"를 입력합니다.

DBG> s
test.ps1:2       "PowerShell " + $PSVersionTable.PSVersion

디버그 메시지에는 함수의 문 미리 보기가 포함되어 있습니다. 이 문을 실행하고 함수에서 다음 문을 미리 보려면 명령을 사용할 Step 수 있습니다. 그러나 이 경우 StepOut 명령(o)을 사용합니다. 함수의 실행을 완료하고(중단점에 도달하지 않는 한) 스크립트의 다음 문으로 이동합니다.

DBG> o
Windows PowerShell 2.0
Have you run a background job today (start-job)?
test.ps1:13  "Done $scriptName"

스크립트의 마지막 문에 있으므로 Step, StepOut 및 Continue 명령은 동일한 효과를 갖습니다. 이 경우 StepOut(o)을 사용합니다.

Done C:\ps-test\test.ps1
PS C:\ps-test>

StepOut 명령은 마지막 명령을 실행합니다. 표준 명령 프롬프트는 디버거가 종료되어 명령 프로세서에 컨트롤을 반환했음을 나타냅니다.

이제 디버거를 다시 실행합니다. 먼저 현재 중단점을 삭제하려면 및 Remove-PSBreakpoint cmdlet을 Get-PSBreakpoint 사용합니다. (중단점을 다시 사용할 수 있다고 생각되면 대신 Remove-PSBreakpointcmdlet을 Disable-PSBreakpoint 사용합니다.)

PS C:\ps-test> Get-PSBreakpoint| Remove-PSBreakpoint

이 명령을

PS C:\ps-test> gbp | rbp

또는 다음 함수와 같은 함수를 작성하여 명령을 실행합니다.

function delbr { gbp | rbp }

이제 변수에 중단점을 만듭니다 $scriptname .

PS C:\ps-test> Set-PSBreakpoint -variable scriptname -script test.ps1

명령을 다음과 같이 축약할 수 있습니다.

PS C:\ps-test> sbp -v scriptname -s test.ps1

이제 스크립트를 시작합니다. 스크립트가 변수 중단점에 도달합니다. 기본 모드는 Write이므로 변수 값을 변경하는 문 바로 앞에서 실행이 중지됩니다.

PS C:\ps-test> .\test.ps1
Hit Variable breakpoint on 'C:\ps-test\test.ps1:$scriptName'
(Write access)

test.ps1:11  $scriptName = $MyInvocation.MyCommand.Path
# DBG>

변수의 현재 값( $scriptName )을 표시합니다 $null.

DBG> $scriptName
# DBG>

Step 명령을 사용하여 변수를 채우는 문을 실행합니다. 그런 다음 변수의 새 값을 표시합니다 $scriptName .

DBG> $scriptName
C:\ps-test\test.ps1
```powershell

Use a Step command (s) to preview the next statement in the script.

```powershell
DBG> s
test.ps1:12  psversion

다음 문은 PsVersion 함수에 대한 호출입니다. 함수를 건너뛰지만 계속 실행하려면 StepOver 명령(v)을 사용합니다. StepOver를 사용할 때 함수에 이미 있는 경우 유효하지 않습니다. 함수 호출이 표시되지만 실행되지 않습니다.

DBG> v
Windows PowerShell 2.0
Have you run a background job today (start-job)?
test.ps1:13  "Done $scriptName"

StepOver 명령은 함수를 실행하고 스크립트에서 마지막 줄을 인쇄하는 다음 문을 미리 봅니다.

중지 명령(t)을 사용하여 디버거를 종료합니다. 명령 프롬프트가 표준 명령 프롬프트로 돌아갑니다.

C:\ps-test>

중단점을 삭제하려면 및 Remove-PSBreakpoint cmdlet을 Get-PSBreakpoint 사용합니다.

PS C:\ps-test> Get-PSBreakpoint| Remove-PSBreakpoint

PsVersion 함수에 새 명령 중단점을 Create.

PS C:\ps-test> Set-PSBreakpoint -command psversion -script test.ps1

이 명령을 축약하여 다음을 수행할 수 있습니다.

PS C:\ps-test> sbp -c psversion -s test.ps1

이제 스크립트를 실행합니다.

PS C:\ps-test> .\test.ps1
Hit Command breakpoint on 'C:\ps-test\test.ps1:psversion'

test.ps1:12  psversion
# DBG>

스크립트는 함수 호출 시 중단점에 도달합니다. 이 시점에서 함수는 아직 호출되지 않았습니다. 이렇게 하면 의 Set-PSBreakpoint Action 매개 변수를 사용하여 중단점 실행에 대한 조건을 설정하거나 로그 시작 또는 진단 또는 보안 스크립트 호출과 같은 준비 또는 진단 작업을 수행할 수 있습니다.

작업을 설정하려면 Continue 명령(c)을 사용하여 스크립트를 종료하고 Remove-PSBreakpoint 명령을 사용하여 현재 중단점을 삭제합니다. (중단점은 읽기 전용이므로 현재 중단점에 작업을 추가할 수 없습니다.)

DBG> c
Windows PowerShell 2.0
Have you run a background job today (start-job)?
Done C:\ps-test\test.ps1

PS C:\ps-test> Get-PSBreakpoint| Remove-PSBreakpoint
PS C:\ps-test>

이제 작업을 사용하여 새 명령 중단점을 만듭니다. 다음 명령은 함수를 호출할 때 변수 값을 $scriptName 기록하는 작업을 사용하여 명령 중단점을 설정합니다. 중단 키워드(keyword) 작업에 사용되지 않으므로 실행이 중지되지 않습니다. (백틱(')은 줄 연속 문자입니다.)

PS C:\ps-test> Set-PSBreakpoint -command psversion -script test.ps1  `
-action { add-content "The value of `$scriptName is $scriptName." `
-path action.log}

중단점에 대한 조건을 설정하는 작업을 추가할 수도 있습니다. 다음 명령에서 명령 중단점은 실행 정책이 여전히 스크립트 실행을 허용하는 가장 제한적인 정책인 RemoteSigned로 설정된 경우에만 실행됩니다. (백틱(')은 연속 문자입니다.)

PS C:\ps-test> Set-PSBreakpoint -script test.ps1 -command psversion `
-action { if ((Get-ExecutionPolicy) -eq "RemoteSigned") { break }}

작업의 중단 키워드(keyword) 디버거가 중단점을 실행하도록 지시합니다. 계속 키워드(keyword) 사용하여 디버거를 중단 없이 실행하도록 지시할 수도 있습니다. 기본 키워드(keyword) 계속이므로 실행을 중지하려면 중단을 지정해야 합니다.

이제 스크립트를 실행합니다.

PS C:\ps-test> .\test.ps1
Hit Command breakpoint on 'C:\ps-test\test.ps1:psversion'

test.ps1:12  psversion

실행 정책이 RemoteSigned로 설정되었으므로 함수 호출 시 실행이 중지됩니다.

이 시점에서 호출 스택을 검사 수 있습니다. Get-PsCallStack cmdlet 또는 Get-PsCallStack 디버거 명령(k)을 사용합니다. 다음 명령은 현재 호출 스택을 가져옵니다.

DBG> k
2: prompt
1: .\test.ps1: $args=[]
0: prompt: $args=[]

이 예제에서는 PowerShell 디버거를 사용하는 몇 가지 방법을 보여 줍니다.

디버거 cmdlet에 대한 자세한 내용은 다음 명령을 입력합니다.

help <cmdlet-name> -full

예를 들어 다음과 같이 입력합니다.

help Set-PSBreakpoint -full

PowerShell의 기타 디버깅 기능

PowerShell 디버거 외에도 PowerShell에는 스크립트 및 함수를 디버그하는 데 사용할 수 있는 몇 가지 다른 기능이 포함되어 있습니다.

  • Windows PowerShell ISE에는 대화형 그래픽 디버거가 포함되어 있습니다. 자세한 내용은 ISE Windows PowerShell 시작하고 F1 키를 누릅니다.

  • cmdlet은 Set-PSDebug 단계별 실행 및 추적을 비롯한 매우 기본적인 스크립트 디버깅 기능을 제공합니다.

  • cmdlet을 Set-StrictMode 사용하여 초기화되지 않은 변수에 대한 참조, 개체의 존재하지 않는 속성에 대한 참조 및 유효하지 않은 함수 구문에 대한 참조를 검색합니다.

  • 변수 값을 표시하는 문, 명령줄에서 입력을 읽는 문 또는 현재 명령을 보고하는 문과 같은 진단 문을 스크립트에 추가합니다. 이 작업에 대한 쓰기 동사가 포함된 cmdlet(예: Write-Host, , Write-DebugWrite-Warning및 )을 Write-Verbose사용합니다.

참고 항목