다음을 통해 공유

Disable-PSBreakpoint

  • 참조
모듈:
Microsoft.PowerShell.Utility

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

구문

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

Description

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

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

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

예제

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

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint

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

첫 번째 명령은 Set-PSBreakpoint cmdlet을 사용하여 Sample.ps1 스크립트의 Name 변수에 중단점을 만듭니다. 그런 다음 중단점 개체를 $B 변수에 저장합니다.

두 번째 명령은 Disable-PSBreakpoint cmdlet을 사용하여 새 중단점을 사용하지 않도록 설정합니다. 파이프라인 연산자(|)를 사용하여 $B 중단점 개체를 Disable-PSBreakpoint cmdlet으로 보냅니다.

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

예제 2: 중단점 사용 안 함

PS C:\> Disable-PSBreakpoint -Id 0

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

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

PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B

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

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

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

두 번째 명령은 $B 변수의 값에 중단점 개체를 표시합니다.

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

PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint

이 명령은 현재 콘솔의 모든 중단점을 사용하지 않도록 설정합니다. "gbp |"로 이 명령을 축약할 수 있습니다. dbp".

매개 변수

-Breakpoint

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

형식:Breakpoint[]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Confirm

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

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Id

중단점 ID를 포함하는 ID 또는 변수의 배열을 지정합니다. ID를 disable-PSBreakpoint파이프할 수 없습니다.

형식:Int32[]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PassThru

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Breakpoint

중단점 개체를 disable-PSBreakpoint파이프할 수 있습니다.

출력

None or System.Management.Automation.Breakpoint

PassThru 매개 변수를 사용하는 경우 Disable-PSBreakpoint 사용 안 함 중단점을 나타내는 개체를 반환합니다. 그렇지 않으면 이 cmdlet은 출력을 생성하지 않습니다.