Share via

Disable-PSBreakpoint

  • 참조
모듈:
Microsoft.PowerShell.Utility

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

Syntax

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

Description

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

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

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

예제

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

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

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

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

이 명령의 결과로 중단점 개체 $B 의 Enabled 속성 값은 False입니다.

예제 2: 중단점 사용 안 함

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

Disable-PSBreakpoint -Id 0

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

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

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

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

개체를 해당 값으로 사용하는 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

사용하지 않도록 설정할 중단점을 지정합니다. 중단점 개체 또는 명령과 같은 중단점 개체를 가져오는 명령이 포함된 변수를 Get-PSBreakpoint 입력합니다. 중단점 개체를 cmdlet에 Disable-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가 포함된 변수를 입력합니다. ID를 .에 파이프할 Disable-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에는 다음 별칭이 포함됩니다.Disable-PSBreakpoint

  • 모든 플랫폼:
    • dbp