Disable-PSBreakpoint

구문

Disable-PSBreakpoint
       [-PassThru]
       [-Breakpoint] <Breakpoint[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Disable-PSBreakpoint
       [-PassThru]
       [-Id] <Int32[]>
       [-Runspace <Runspace>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Disable-PSBreakpoint cmdlet은 중단점을 사용하지 않도록 설정하여 스크립트가 실행될 때 중단점이 적중되지 않도록 합니다. 이를 사용하여 모든 중단점을 사용하지 않도록 설정하거나 중단점 개체 또는 중단점 ID를 제출하여 중단점을 지정할 수 있습니다.

기술적으로 이 cmdlet은 중단점 개체의 Enabled 속성 값을 False로 변경합니다. 중단점을 다시 사용하도록 설정하려면 Enable-PSBreakpoint cmdlet을 사용합니다. 중단점은 Set-PSBreakpoint cmdlet을 사용하여 만들 때 기본적으로 사용하도록 설정됩니다.

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

예제

예제 1: 중단점 설정 및 사용 안 함

이러한 명령은 새로 만든 중단점을 사용하지 않도록 설정합니다.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

Set-PSBreakpoint cmdlet은 Sample.ps1 스크립트의 $Name 변수에 중단점을 만들고 중단점 개체를 $B 변수에 저장합니다. Disable-PSBreakpoint cmdlet은 새 중단점을 사용하지 않도록 설정합니다. 파이프라인 연산자(|)를 사용하여 $B 중단점 개체를 Disable-PSBreakpoint cmdlet으로 보냅니다.

이 명령의 결과로 중단점 개체의 Enabled 속성 값은 false.

예제 2: 중단점 사용 안 함

이 명령은 중단점 ID가 0인 중단점을 사용하지 않도록 설정합니다.

Disable-PSBreakpoint -Id 0

예제 3: 비활성화된 중단점 만들기

이 명령은 사용하도록 설정할 때까지 사용하지 않도록 설정된 새 중단점을 만듭니다.

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

Disable-PSBreakpoint cmdlet을 사용하여 중단점을 사용하지 않도록 설정합니다. 중단점 매개 변수의 값은 새 중단점을 설정하고 중단점 개체를 생성하며 개체를 $B 변수에 저장하는 Set-PSBreakpoint 명령입니다.

개체를 해당 값으로 사용하는 Cmdlet 매개 변수는 개체를 포함하거나 개체를 가져오거나 생성하는 명령을 포함하는 변수를 허용할 수 있습니다. 이 경우 Set-PSBreakpoint 중단점 개체를 생성하므로 중단점 매개 변수의 값으로 사용할 수 있습니다.

예제 4: 현재 콘솔에서 모든 중단점 사용 안 함

이 명령은 현재 콘솔의 모든 중단점을 사용하지 않도록 설정합니다.

`Get-PSBreakpoint` | Disable-PSBreakpoint

예제 5: Runspace에서 중단점 사용 안 함

이 예제에서는 작업이 시작되고 Set-PSBreakPoint 실행될 때 중단점이 중단되도록 설정됩니다. runspace는 변수에 저장되고 Runspace 매개 변수를 사용하여 Get-PSBreakPoint 명령에 전달됩니다. Get-PSBreakPoint 출력은 runspace에서 중단점을 사용하지 않도록 설정하기 위해 Disable-PSBreakpoint 파이프됩니다.

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

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace

매개 변수

-Breakpoint

-Confirm

-Id

-PassThru

-Runspace

-WhatIf

입력

Breakpoint

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

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

Breakpoint

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 비활성화된 중단점을 나타내는 중단점 개체를 반환합니다.

참고

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

• 모든 플랫폼:
  • dbp

관련 링크

• Enable-PSBreakpoint
• Get-PSBreakpoint
• Get-PSCallStack
• Remove-PSBreakpoint
• Set-PSBreakpoint