Share via


Enable-PSBreakpoint

현재 콘솔에서 중단점을 사용하도록 설정합니다.

Syntax

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

Description

이 cmdlet은 Enable-PSBreakpoint 비활성화된 중단점을 다시 사용하도록 설정합니다. 이를 사용하여 중단점 개체 또는 ID를 제공하여 모든 중단점 또는 특정 중단점을 사용하도록 설정할 수 있습니다.

중단점은 스크립트의 상태를 검사할 수 있도록 실행이 일시적으로 중지되는 스크립트의 지점입니다. 새로 만든 중단점은 자동으로 사용하도록 설정되지만 Disable-PSBreakpoint.

기술적으로 이 cmdlet은 중단점 개체의 Enabled 속성 값을 True변경합니다.

Enable-PSBreakpoint 는 PowerShell 스크립트 디버깅을 위해 설계된 여러 cmdlet 중 하나입니다. PowerShell 디버거에 대한 자세한 내용은 about_Debuggers 참조하세요.

예제

예제 1: 모든 중단점 사용

다음은 현재 세션의 모든 중단점을 사용하도록 설정하는 예제입니다.

Get-PSBreakpoint | Enable-PSBreakpoint

별칭을 사용하여 이 예제를 다음과 같이 gbp | ebp축약할 수 있습니다.

예제 2: ID별로 중단점 사용

이 예제에서는 중단점 ID를 사용하여 여러 중단점을 사용하도록 설정합니다.

Enable-PSBreakpoint -Id 0, 1, 5

예제 3: 비활성화된 중단점 사용

이 예제에서는 사용하지 않도록 설정된 중단점을 다시 사용하도록 설정합니다.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable Name -PassThru
$B | Enable-PSBreakpoint -PassThru

AccessMode : Write
Variable   : Name
Action     :
Enabled    : False
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Set-PSBreakpoint는 변수에 중단점 개체를 저장하는 스크립트의 Sample.ps1 Name 변수에 $B 중단점을 만듭니다. PassThru 매개 변수는 중단점의 Enabled 속성 값이 False임을 표시합니다.

Enable-PSBreakpoint 중단점을 다시 사용하도록 설정합니다. 다시 PassThru 매개 변수를 사용하면 Enabled 속성의 값이 True임을 알 수 있습니다.

예제 4: 변수를 사용하여 중단점 사용

다음은 중단점 개체를 사용하여 중단점 집합을 사용하도록 설정하는 예제입니다.

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint 는 중단점을 가져오고 변수에 $B 저장합니다. 중단점 매개 변수 Enable-PSBreakpoint사용하여 중단점을 사용하도록 설정합니다.

이 예제는 실행 Enable-PSBreakpoint -Id 3, 5과 동일합니다.

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

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

Start-Job -ScriptBlock {
    $bp = Set-PSBreakpoint -Command Start-Sleep
    Disable-PSBreakpoint $bp
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

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

매개 변수

-Breakpoint

사용하도록 설정할 중단점을 지정합니다. 중단점이 포함된 변수 또는 중단점 개체를 가져오는 명령(예: Get-PSBreakpoint.)을 제공합니다. 중단점 개체를 .에 파이프할 Enable-PSBreakpoint수도 있습니다.

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

사용하도록 설정할 중단점의 ID 번호를 지정합니다. 기본값은 모든 중단점입니다. 숫자 또는 변수로 ID를 제공합니다. ID 번호를 .에 파이프Enable-PSBreakpoint수 없습니다. 중단점의 ID 를 찾으려면 cmdlet을 Get-PSBreakpoint 사용합니다.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

사용 중인 중단점을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Runspace

지정된 Runspace에서 중단점과 상호 작용할 수 있도록 Runspace 개체의 ID를 지정합니다.

이 매개 변수는 PowerShell 7.2에 추가되었습니다.

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

Breakpoint

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

출력

None

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

Breakpoint

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 사용 가능한 중단점을 나타내는 중단점 개체를 반환합니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.Enable-PSBreakpoint

  • 모든 플랫폼:

    • ebp
  • Enable-PSBreakpoint 이미 사용하도록 설정된 중단점을 사용하도록 설정하려고 하면 cmdlet이 오류를 생성하지 않습니다. 따라서 일부만 사용하지 않도록 설정된 경우에도 오류 없이 모든 중단점을 사용하도록 설정할 수 있습니다.

  • 중단점은 cmdlet을 사용하여 Set-PSBreakpoint 만들 때 사용하도록 설정됩니다. 새로 만든 중단점을 사용하도록 설정할 필요가 없습니다.