Windows PowerShell ISE에서 스크립트를 디버그하는 방법

이 문서에서는 Windows PowerShell ISE(통합 스크립팅 환경) 시각적 디버깅 기능을 사용하여 로컬 컴퓨터에서 스크립트를 디버그하는 방법을 설명합니다.

중단점을 관리하는 방법

중단점은 스크립트가 실행되는 환경 및 변수의 현재 상태를 검사할 수 있도록 작업을 일시 중지하려는 스크립트의 지정된 지점입니다. 스크립트가 중단점에 의해 일시 중지되면 콘솔 창에서 명령을 실행하여 스크립트의 상태를 검사할 수 있습니다. 변수를 출력하거나 다른 명령을 실행할 수 있습니다. 현재 실행 중인 스크립트의 컨텍스트에 표시되는 변수의 값을 수정할 수도 있습니다. 보려는 사항을 검사한 후 스크립트 작업을 다시 시작할 수 있습니다.

Windows PowerShell 디버깅 환경에서 다음 세 가지 유형의 중단점을 설정할 수 있습니다.

1. 줄 중단점. 스크립트를 작업하는 동안 지정된 줄에 도달하면 스크립트가 일시 중지됩니다.

2. 변수 중단점입니다. 지정된 변수의 값이 변경될 때마다 스크립트가 일시 중지됩니다.

3. 명령 중단점. 스크립트를 실행하는 동안 지정된 명령이 실행될 때마다 스크립트가 일시 중지됩니다. 중단점을 원하는 작업으로만 추가로 필터링하는 매개 변수를 포함할 수 있습니다. 이 명령은 사용자가 만든 함수일 수도 있습니다.

Windows PowerShell ISE 디버깅 환경에서는 이 중에서 줄 중단점만 메뉴 또는 바로 가기 키를 통해 설정할 수 있습니다. 다른 두 가지 유형의 중단점을 설정할 수 있지만 Set-PSBreakpoint cmdlet을 사용하여 콘솔 창에서 설정합니다. 이 섹션에서는 사용 가능한 메뉴를 사용하여 Windows PowerShell ISE에서 디버깅 작업을 수행하고 스크립팅을 사용하여 콘솔 창에서 더 넓은 범위의 명령을 수행하는 방법을 설명합니다.

중단점을 설정하려면

중단점은 저장한 후에만 스크립트에서 설정할 수 있습니다. 줄 중단점을 설정할 줄을 마우스 오른쪽 단추로 클릭한 다음 중단점 설정/해제를 클릭합니다. 또는 줄 중단점을 설정할 줄을 클릭하고 F9 키를 누르거나 디버그 메뉴에서 중단점 토글을 클릭합니다.

다음 스크립트는 Set-PSBreakpoint cmdlet을 사용하여 콘솔 창에서 변수 중단점을 설정하는 방법의 예입니다.

# This command sets a breakpoint on the Server variable in the Sample.ps1 script.
Set-PSBreakpoint -Script sample.ps1 -Variable Server

모든 중단점 나열

현재 Windows PowerShell 세션의 모든 중단점을 표시합니다.

디버그 메뉴에서 중단점 목록을 클릭합니다. 다음 스크립트는 Get-PSBreakpoint cmdlet을 사용하여 콘솔 창의 모든 중단점을 나열하는 방법의 예입니다.

# This command lists all breakpoints in the current session.
Get-PSBreakpoint

중단점 제거

중단점을 제거하면 중단점이 삭제됩니다.

나중에 다시 사용하려는 경우 중단점을 사용하지 않도록 설정하는 것이 좋습니다. 중단점을 제거할 줄을 마우스 오른쪽 단추로 클릭한 다음 ToggleBreakpoint를 클릭합니다. 또는 중단점을 제거할 줄을 클릭한 다음 디버그 메뉴에서 중단점 설정/해제를 클릭합니다. 다음 스크립트는 Remove-PSBreakpoint cmdlet을 사용하여 콘솔 창에서 지정된 ID가 있는 중단점을 제거하는 방법의 예입니다.

# This command deletes the breakpoint with breakpoint ID 2.
Remove-PSBreakpoint -Id 2

모든 중단점 제거

현재 세션에 정의된 모든 중단점을 제거하려면 디버그 메뉴에서 모든 중단점 제거를 클릭합니다.

다음 스크립트는 Remove-PSBreakpoint cmdlet을 사용하여 콘솔 창에서 모든 중단점을 제거하는 방법의 예입니다.

# This command deletes all of the breakpoints in the current session.
Get-PSBreakpoint | Remove-PSBreakpoint

중단점 사용 안 함

중단점을 사용하지 않도록 설정해도 중단점은 제거되지 않습니다. 사용하도록 설정될 때까지 해제됩니다. 특정 줄 중단점을 사용하지 않도록 설정하려면 중단점을 사용하지 않도록 설정할 줄을 마우스 오른쪽 단추로 클릭한 다음 중단점 사용 안 함을 클릭합니다.

또는 중단점을 사용하지 않도록 설정할 줄을 클릭하고 F9 키를 누르거나 디버그 메뉴에서 중단점 사용 안 함을 클릭합니다. 다음 스크립트는 Disable-PSBreakpoint cmdlet을 사용하여 콘솔 창에서 지정된 ID가 있는 중단점을 제거하는 방법의 예입니다.

# This command disables the breakpoint with breakpoint ID 0.
Disable-PSBreakpoint -Id 0

모든 중단점 사용 안 함

중단점을 사용하지 않도록 설정해도 중단점이 제거되지는 않습니다. 사용하도록 설정될 때까지 꺼집니다. 현재 세션의 모든 중단점을 사용하지 않도록 설정하려면 디버그 메뉴에서 모든 중단점 사용 안 함을 클릭합니다. 다음 스크립트는 Disable-PSBreakpoint cmdlet을 사용하여 콘솔 창에서 모든 중단점을 사용하지 않도록 설정하는 방법의 예입니다.

# This command disables all breakpoints in the current session.
# You can abbreviate this command as: "gbp | dbp".
Get-PSBreakpoint | Disable-PSBreakpoint

중단점 사용

특정 중단점을 사용하도록 설정하려면 중단점을 사용하도록 설정할 줄을 마우스 오른쪽 단추로 클릭한 다음 중단점 사용을 클릭합니다. 또는 중단점을 사용하도록 설정할 줄을 클릭한 다음 F9 키를 누르거나 디버그 메뉴에서 중단점 사용을 클릭합니다. 다음 스크립트는 Enable-PSBreakpoint cmdlet을 사용하여 콘솔 창에서 특정 중단점을 사용하도록 설정하는 방법의 예입니다.

# This command enables breakpoints with breakpoint IDs 0, 1, and 5.
Enable-PSBreakpoint -Id 0, 1, 5

모든 중단점 사용

현재 세션에서 정의된 모든 중단점을 사용하도록 설정하려면 디버그 메뉴에서 모든 중단점 사용을 클릭합니다. 다음 스크립트는 Enable-PSBreakpoint cmdlet을 사용하여 콘솔 창에서 모든 중단점을 사용하도록 설정하는 방법의 예입니다.

# This command enables all breakpoints in the current session.
# You can abbreviate the command by using their aliases: "gbp | ebp".
Get-PSBreakpoint | Enable-PSBreakpoint

디버깅 세션을 관리하는 방법

디버깅을 시작하기 전에 하나 이상의 중단점을 설정해야 합니다. 디버그하려는 스크립트가 저장되지 않으면 중단점을 설정할 수 없습니다. 중단점을 설정하는 방법에 대한 지침은 중단점을 관리하는 방법 또는 Set-PSBreakpoint를 참조하세요. 디버깅을 시작한 후에는 디버깅을 중지할 때까지 스크립트를 편집할 수 없습니다. 하나 이상의 중단점이 설정된 스크립트는 실행되기 전에 자동으로 저장됩니다.

디버깅을 시작하려면

F5 키를 누르거나 도구 모음에서 스크립트 실행 아이콘을 클릭하거나 디버그 메뉴에서 실행/계속을 클릭합니다. 스크립트는 첫 번째 중단점이 발생할 때까지 실행됩니다. 작업을 일시 중지하고 일시 중지된 줄을 강조 표시합니다.

디버깅을 계속하려면

F5 키를 누르거나 도구 모음에서 스크립트 실행 아이콘을 클릭하거나 디버그 메뉴에서 실행/계속을 클릭하거나 콘솔 창에서 입력 C 한 다음 Enter 키를 누릅니다. 이렇게 하면 스크립트가 다음 중단점이나 더 이상 중단점이 없는 경우 스크립트의 끝까지 계속 실행됩니다.

호출 스택을 보려면

호출 스택은 스크립트의 현재 실행 위치를 표시합니다. 스크립트가 다른 함수에 의해 호출된 함수에서 실행 중인 경우 출력의 추가 행이 표시합니다. 맨 아래에 있는 행은 원래 스크립트와 함수가 호출된 스크립트의 줄을 표시합니다. 다음 줄은 해당 함수와 다른 함수가 호출되었을 수 있는 줄을 보여줍니다. 맨 위에 있는 행은 중단점이 설정된 현재 줄의 현재 컨텍스트를 보여 줍니다.

일시 중지된 동안 현재 호출 스택을 보려면 Ctrl+Shift+D를 누르거나, 디버그 메뉴에서 호출 스택 표시를 클릭하거나, 콘솔 창에서 K를 입력하고 Enter 키를 누릅니다.

디버깅을 중지하려면

Shift+F5 키를 누르거나 디버그 메뉴에서 디버거 중지를 클릭하거나 콘솔 창에서 Enter 키를 입력 Q 한 다음 누릅니다.

디버깅하는 동안 단계별 실행, 단계별 실행 및 단계별 실행 방법

단계별 실행은 한 번에 하나의 문을 실행하는 프로세스입니다. 코드 줄에서 중지하고 변수 값과 시스템 상태를 검사할 수 있습니다. 다음 표에서는 단계별 실행, 단계별 실행 및 실행과 같은 일반적인 디버깅 작업에 대해 설명합니다.

디버깅하는 동안 변수 값을 표시하는 방법

코드를 단계별로 실행하면 스크립트에서 변수의 현재 값을 표시할 수 있습니다.

표준 변수의 값을 표시하려면

다음 방법 중 하나를 사용하십시오.

• 스크립트 창에서 변수를 마우스로 가리키면 해당 값이 도구 설명으로 표시됩니다.

• 콘솔 창에서 변수 이름을 입력하고 Enter 키를 누릅니다.

ISE에서 모든 창은 항상 동일한 범위입니다. 따라서 스크립트를 디버깅하는 동안 콘솔 창에 입력하는 명령은 스크립트 범위에서 실행됩니다. 이렇게 하면 콘솔 창을 사용하여 변수 값을 찾고 스크립트에만 정의된 함수를 호출할 수 있습니다.

자동 변수의 값을 표시하려면

이전 메서드를 사용하여 스크립트를 디버깅하는 동안 거의 모든 변수의 값을 표시할 수 있습니다. 그러나 다음과 같은 자동 변수에는 이러한 방법을 사용할 수 없습니다.

• $_

• $Input

• $MyInvocation

• $PSBoundParameters

• $Args

이러한 변수의 값을 표시하려고 하면 스크립트의 변수 값이 아니라 디버거가 사용하는 내부 파이프라인에서 해당 변수의 값을 가져옵니다. 다음 메서드를 사용하여 몇 가지 변수($_, , $Input$MyInvocation, $PSBoundParameters및$Args)에 대해 이 작업을 수행할 수 있습니다.

1. 스크립트에서 자동 변수의 값을 새 변수에 할당합니다.

2. 스크립트 창에서 새 변수를 마우스로 가리키거나 콘솔 창에 새 변수를 입력하여 새 변수의 값을 표시합니다.

예를 들어 변수 값을 $MyInvocation 표시하려면 스크립트에서 값을 새 변수(예: $scriptName새 변수)에 할당한 다음 변수를 마우스로 가리키거나 입력 $scriptName 하여 해당 값을 표시합니다.

# In C:\ps-test\MyScript.ps1
$scriptName = $MyInvocation.PSCommandPath

# In the Console Pane:
.\MyScript.ps1
$scriptName

C:\ps-test\MyScript.ps1

참고 항목

Windows PowerShell ISE 탐색