현재 콘솔의 중단점을 해제합니다.
구문
Disable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Disable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
설명
Disable-PSBreakpoint cmdlet은 중단점을 해제하여 스크립트가 실행되는 동안 중단점에 도달하지 않도록 합니다. 이 cmdlet을 사용하여 모든 중단점을 해제할 수도 있고 중단점 개체 또는 중단점 ID를 전송하여 중단점을 지정할 수도 있습니다.
기술적으로 보면 이 cmdlet은 중단점 개체의 Enabled 속성 값을 False로 변경합니다. 중단점을 다시 설정하려면 Enable-PSBreakpoint cmdlet을 사용합니다. Set-PSBreakpoint cmdlet을 사용하여 중단점을 만드는 경우 중단점이 기본적으로 설정됩니다.
중단점은 스크립트의 명령을 검사할 수 있도록 실행이 일시적으로 중지되는 스크립트의 한 지점입니다. Disable-PSBreakpoint는 Windows PowerShell 스크립트를 디버깅하는 데 사용되는 여러 cmdlet 중 하나입니다. Windows PowerShell 디버거에 대한 자세한 내용은 about_Debuggers를 참조하십시오.
매개 변수
-Breakpoint <Breakpoint[]>
해제할 중단점을 지정합니다. 중단점 개체가 포함된 변수를 입력하거나 중단점 개체를 가져오는 명령(예: Get-PSBreakpoint 명령)을 입력합니다. 중단점 개체를 Disable-PSBreakpoint cmdlet으로 파이프할 수도 있습니다.
필수 여부 |
true |
위치 |
1 |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
true (ByValue) |
와일드카드 문자 적용 여부 |
false |
-Id <Int32[]>
지정된 중단점 ID를 가진 중단점을 해제합니다. ID 또는 ID가 포함된 변수를 입력합니다. ID를 Disable-PSBreakpoint로 파이프할 수 없습니다.
필수 여부 |
true |
위치 |
1 |
기본값 |
|
파이프라인 입력 적용 여부 |
true (ByPropertyName) |
와일드카드 문자 적용 여부 |
false |
-PassThru
설정된 중단점을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Confirm
명령을 실행하기 전에 확인 메시지를 표시합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-WhatIf
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
입력 |
System.Management.Automation.Breakpoint 중단점 개체를 Disable-PSBreakpoint로 파이프할 수 있습니다. |
출력 |
없음 또는 System.Management.Automation.Breakpoint PassThru 매개 변수를 사용할 경우 Disable-PSBreakpoint는 해제된 중단점을 나타내는 개체를 반환합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다. |
예 1
C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable name C:\PS> $b | disable-psbreakpoint 설명 ----------- 이들 명령은 새로 만든 중단점을 해제합니다. 첫 번째 명령은 Set-PSBreakpoint cmdlet을 사용하여 Sample.ps1 스크립트의 Name 변수에 중단점을 만듭니다. 그런 다음 이 명령은 $b 변수에 중단점 개체를 저장합니다. 두 번째 명령은 Disable-PSBreakpoint cmdlet을 사용하여 새 중단점을 해제합니다. 이 명령은 파이프라인 연산자(|)를 사용하여 $b의 중단점 개체를 Disable-PSBreakpoint cmdlet으로 보냅니다. 이 명령을 실행하면 $b에 들어 있는 중단점 개체의 Enabled 속성 값이 False가 됩니다.
예 2
C:\PS>disable-psbreakpoint -id 0 설명 ----------- 이 명령은 중단점 ID가 0인 중단점을 해제합니다.
예 3
C:\PS>disable-psbreakpoint -breakpoint ($b = set-psbreakpoint -script sample.ps1 -line 5) C:\PS> $b 설명 ----------- 이 명령은 설정할 때까지 해제된 상태로 있는 새 중단점을 만듭니다. 이 명령은 Disable-PSBreakpoint cmdlet을 사용하여 중단점을 해제합니다. Breakpoint 매개 변수의 값은 새 중단점을 설정하고, 중단점 개체를 생성하고, 해당 개체를 $b 변수에 저장하는 Set-PSBreakpoint 명령입니다. 값으로 개체를 사용하는 cmdlet 매개 변수는 개체 또는 개체를 가져오거나 생성하는 명령이 포함된 변수를 사용할 수 있습니다. 이 경우 Set-PSBreakpoint는 중단점 개체를 생성하므로 Breakpoint 매개 변수의 값으로 사용될 수 있습니다. 두 번째 명령은 $b 변수 값에 있는 중단점 개체를 표시합니다.
예 4
C:\PS>get-psbreakpoint | disable-psbreakpoint 설명 ----------- 이 명령은 현재 콘솔의 모든 중단점을 해제합니다. 이 명령은 "gbp | dbp"로 축약할 수 있습니다.
참고 항목