다음을 통해 공유

Wait-Debugger

  • 참조
모듈:
Microsoft.PowerShell.Utility

스크립트에서 다음 문을 실행하기 전에 디버거에서 스크립트를 중지합니다.

구문

Wait-Debugger []

Description

cmdlet 바로 뒤의 지점에서 PowerShell 스크립트 실행 엔진을 Wait-Debugger 중지하고 디버거가 연결될 때까지 기다립니다.

주의

작업을 완료한 Wait-Debugger 후 줄을 제거해야 합니다. 실행 중인 스크립트는 에서 Wait-Debugger중지될 때 중단된 것처럼 보입니다.

PowerShell의 디버깅에 대한 자세한 내용은 about_Debuggers 참조하세요.

예제

예제 1: 디버깅을 위한 중단점 삽입

파일에 dbgtest.ps1 함수 Test-Condition가 포함되어 있습니다. 이 Wait-Debugger 명령은 해당 시점에서 스크립트 실행을 중지하기 위해 함수에 삽입되었습니다. 함수를 실행하면 스크립트가 줄에서 Wait-Debugger 중지되고 명령줄 디버거를 입력합니다. 이 l 명령은 스크립트 줄을 나열하고 다른 디버거 명령을 사용하여 스크립트 상태를 검사할 수 있습니다.

function Test-Condition {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory)]
        [string]$Name,
        [string]$Message = "Hello, $Name!"
    )

    if ($Name -eq $env:USERNAME) {
        Write-Output "$Message"
    } else {
        # Remove after debugging
        Wait-Debugger

        Write-Output "$Name is not the current user."
    }
}

PS D:\> Test-Condition Fred
Entering debug mode. Use h or ? for help.

At D:\temp\test\dbgtest.ps1:13 char:9
+         Wait-Debugger
+         ~~~~~~~~~~~~~
[DBG]: PS D:\>> l

    8:
    9:      if ($Name -eq $env:USERNAME) {
   10:          Write-Output "$Message"
   11:      } else {
   12:          # Remove after debugging
   13:*         Wait-Debugger
   14:
   15:          Write-Output "$Name is not the current user."
   16:      }
   17:  }

[DBG]: PS D:\>> $env:USERNAME
User01
[DBG]: PS D:\>> exit
PS D:\>

이 출력은 l 스크립트 실행이 13줄에서 Wait-Debugger 중지되었음을 보여 줍니다.

예제 2: DSC 리소스 디버깅을 위한 중단점 삽입

이 예제에서는 Wait-Debugger DSC 리소스의 메서드에 CopyFile 명령이 삽입되었습니다. 이는 DSC 리소스에서 사용하는 Enable-RunspaceDebug -BreakAll 것과 비슷하지만 스크립트의 특정 지점에서 중단됩니다.

[DscResource()]
class FileResource
{
    [DscProperty(Key)]
    [string] $Path

    [DscProperty(Mandatory)]
    [Ensure] $Ensure

    [DscProperty(Mandatory)]
    [string] $SourcePath

    [DscProperty(NotConfigurable)]
    [Nullable[datetime]] $CreationTime


    [void] Set() {
        $fileExists = $this.TestFilePath($this.Path)
        if ($this.ensure -eq [Ensure]::Present) {
            if (! $fileExists) {
               $this.CopyFile()
            }
        } else {
            if ($fileExists) {
                Write-Verbose -Message "Deleting the file $($this.Path)"
                Remove-Item -LiteralPath $this.Path -Force
            }
        }
    }

    [bool] Test() {
        $present = Test-Path -LiteralPath $this.Path
        if ($this.Ensure -eq [Ensure]::Present) {
            return $present
        } else {
            return (! $present)
        }
    }

    [FileResource] Get() {
        $present = Test-Path -Path $this.Path
        if ($present) {
            $file = Get-ChildItem -LiteralPath $this.Path
            $this.CreationTime = $file.CreationTime
            $this.Ensure = [Ensure]::Present
        } else {
            $this.CreationTime = $null
            $this.Ensure = [Ensure]::Absent
        }
        return $this
    }

    [void] CopyFile() {
        # Testing only - Remove before deployment!
        Wait-Debugger

        if (! (Test-Path -LiteralPath $this.SourcePath)) {
            throw "SourcePath $($this.SourcePath) is not found."
        }
        if (Test-Path -LiteralPath $this.Path -PathType Container) {
            throw "Path $($this.Path) is a directory path"
        }
        Write-Verbose "Copying $($this.SourcePath) to $($this.Path)"
        Copy-Item -LiteralPath $this.SourcePath -Destination $this.Path -Force
    }
}

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.