다음을 통해 공유

BCDEdit /dbgsettings

  • 아티클

/dbgsettings 옵션은 컴퓨터에 대한 현재 전역 디버거 설정을 설정하거나 표시합니다. 커널 디버거를 사용하거나 사용하지 않도록 설정하려면 BCDEdit /debug 옵션을 사용합니다.

참고 항목

BCDEdit 옵션을 설정하기 전에 컴퓨터에서 BitLocker 및 보안 부팅을 사용하지 않도록 설정하거나 일시 중단해야 할 수 있습니다.

bcdedit /dbgsettings NET HOSTIP:ip PORT:port [KEY:key] [nodhcp] [newkey] [/start startpolicy] [/noumex] 

bcdedit /dbgsettings LOCAL [/start startpolicy] [/noumex] 

bcdedit /dbgsettings SERIAL [DEBUGPORT:port] [BAUDRATE:baud] [/start startpolicy] [/noumex] 

bcdedit /dbgsettings USB [TARGETNAME:targetname] [/start startpolicy] [/noumex] 

bcdedit /dbgsettings 1394 [CHANNEL:channel] [/start startpolicy] [/noumex] NOTE: The 1394 TRANSPORT IS DEPRECATED

매개 변수

NET

대상 컴퓨터와 호스트 컴퓨터가 디버깅에 이더넷 네트워크 연결을 사용하도록 지정합니다. 이 옵션을 사용하는 경우 HOSTIP 및 PORT 매개 변수도 포함되어야 합니다. 대상 컴퓨터에는 Windows용 디버깅 도구에서 지원하는 네트워크 어댑터가 있어야 합니다.

HOSTIP:ip
네트워크 디버깅의 경우 호스트 디버거의 IP 주소를 지정합니다.

KEY:key
네트워크 디버깅의 경우 연결을 암호화할 키를 지정합니다. [0-9] 및 [a-z]만 허용됩니다. newkey 매개 변수를 지정한 경우 이 매개 변수를 지정하지 마세요.

PORT:port
네트워크 디버깅의 경우 호스트 디버거에서 통신할 포트를 지정합니다. 49152 이상이어야 합니다.

newkey
네트워크 디버깅의 경우 연결에 대해 새 암호화 키를 생성해야 한다고 지정합니다. KEY 매개 변수를 지정한 경우 이 매개 변수를 지정하지 마세요.

nodhcp

nodhcp를 설정하면 DHCP를 사용하여 대상 IP 주소를 가져올 수 없습니다. 이 옵션은 작은 라우터도 DHCP를 지원하기 때문에 거의 필요하지 않습니다. nodhcp 옵션은 네트워크에 DHCP 서버가 없다는 것을 알고 있는 경우에만 사용해야 합니다. 대부분의 경우 이 옵션이 설정되지 않고 DHCP가 사용하도록 설정된 경우 KDNET 전송이 가장 적합합니다.

busparams=Bus.Device.Function 은 대상 컨트롤러를 지정합니다. 버스 는 버스 번호를 지정하고, 디바이스 는 디바이스 번호를 지정하고 , Function 은 함수 번호를 지정합니다.

버스 매개 변수를 지정하려면 장치 관리자 열고 디버깅에 사용할 네트워크 어댑터를 찾습니다. 네트워크 어댑터의 속성 페이지를 열고 버스 번호, 장치 번호 및 함수 번호를 기록해 둡니다. 이러한 값은 일반 탭의 위치 아래 장치 관리자 표시됩니다. 관리자 권한 명령 프롬프트 창에서 다음 명령을 입력합니다. 여기서 b, d 및 f는 10진수 형식의 버스, 디바이스 및 함수 번호입니다.

bcdedit /set "{dbgsettings}" busparams b.d.f

디버거 연결을 수동으로 구성하는 경우 버스 매개 변수를 지정해야 합니다. 자세한 내용은 수동으로 KDNET 네트워크 커널 디버깅 설정 및 USB 3.0 케이블을 통해 수동으로 커널 모드 디버깅 설정을 참조하세요.

예제

다음 명령은 디버깅에 이더넷 연결을 사용하도록 대상 컴퓨터를 구성하고 호스트 컴퓨터의 IP 주소를 지정합니다. 또한 이 명령은 호스트 컴퓨터가 대상 컴퓨터에 연결하는 데 사용할 수 있는 포트 번호를 지정합니다.

bcdedit /dbgsettings net hostip:10.125.5.10 port:50000

다음 명령은 포트 50000에서 통신하는 2001:48:d8:2f:5e:c0:42:28:4f5b에서 디버거 호스트와 함께 IPv6을 사용하여 네트워크 디버깅으로 전역 디버거 설정을 설정합니다.

bcdedit /dbgsettings NET HOSTIPV6:2001:48:d8:2f:5e:c0:42:28:4f5b PORT:50000

Important

네트워크 디버깅을 수동으로 설정하는 것은 복잡하고 오류가 발생하기 쉬운 프로세스입니다. 네트워크 디버깅을 자동으로 설정하려면 KDNET 네트워크 커널 디버깅 자동 설정을 참조 하세요. 모든 디버거 사용자에게는 KDNET 유틸리티를 사용하는 것이 좋습니다.

수동 설정에 대한 자세한 내용은 수동으로 네트워크 케이블을 통해 커널 모드 디버깅 설정을 참조 하세요.

LOCAL

LOCAL 옵션은 전역 디버깅 옵션을 로컬 디버깅으로 설정합니다. 단일 컴퓨터에서 커널 모드 디버깅입니다. 즉, 디버거는 디버그 중인 동일한 컴퓨터에서 실행됩니다. 로컬 디버깅을 사용하면 상태를 검사할 수 있지만 OS 실행을 중지하는 커널 모드 프로세스에 침입할 수는 없습니다.

예시

다음 명령은 전역 디버거 설정을 로컬 디버깅으로 설정합니다.

bcdedit /dbgsettings LOCAL

LOCAL 옵션은 Windows 8.0 및 Windows Server 2012 이상에서 사용할 수 있습니다.

로컬 커널 모드 디버깅을 수동으로 설정하는 방법에 대한 자세한 내용은 단일 컴퓨터의 로컬 커널 디버깅 수동 설정을 참조하세요.

직렬

대상 컴퓨터와 호스트 컴퓨터가 디버깅에 직렬 연결을 사용하도록 지정합니다. 이 옵션을 사용하면 DEBUGPORT 및 BAUDRATE 매개 변수를 지정해야 합니다.

BAUDRATE:baud
사용할 전송 속도를 지정합니다. 이 매개 변수는 선택 사항입니다. baud의 유효한 값은 9600, 19200, 38400, 57600 및 115200입니다. 기본 전송 속도는 115200 bps입니다.

DEBUGPORT:port
디버깅 포트로 사용할 직렬 포트를 지정합니다. 이는 선택적 설정입니다. 기본 포트는 1(COM 1)입니다.

예시

다음 명령은 디버깅에 직렬 연결을 사용하도록 대상 컴퓨터를 구성합니다. 또한 이 명령은 디버깅 연결에서 COM1과 115,200의 전송 속도를 사용하도록 지정합니다.

bcdedit /dbgsettings serial debugport:1 baudrate:115200

자세한 내용은 직렬 케이블을 통해 수동으로 커널 모드 디버깅 설정을 참조 하세요.

USB

대상 컴퓨터와 호스트 컴퓨터가 디버깅에 USB 2.0 또는 USB 3.0 연결을 사용하도록 지정합니다. 이 옵션을 사용하는 경우 TARGETNAME 매개 변수도 포함되어야 합니다.

TARGETNAME: targetname
대상 이름에 사용할 문자열 값을 지정합니다. TargetName은 대상 컴퓨터의 공식 이름이 아니어야 합니다. 이러한 제한 사항을 충족하는 한 만드는 모든 문자열일 수 있습니다.

  • 문자열은 대문자 또는 소문자를 조합하여 TargetName의 아무 곳이나 "디버그"를 포함해서는 안 됩니다. 예를 들어 대상 이름에서 "DeBuG" 또는 "DEBUG"를 사용하는 경우 디버깅이 제대로 작동하지 않습니다.
  • 문자열의 유일한 문자는 하이픈(-), 밑줄(_), 숫자 0~9, 문자 A~Z(대문자 또는 소문자)입니다.
  • 문자열의 최대 길이는 24자입니다.

예시

다음 명령은 디버깅에 USB 연결을 사용하도록 대상 컴퓨터를 구성합니다. 또한 이 명령은 호스트 컴퓨터가 대상 컴퓨터에 연결하는 데 사용할 수 있는 대상 이름을 지정합니다.

bcdedit /dbgsettings usb targetname:myTarget

자세한 내용은 다음을 참조하세요.

1394

Important

1394 전송은 Windows 10 버전 1607 이하에서 사용할 수 있습니다. 이후 버전의 Windows에서는 사용할 수 없습니다. 이더넷을 사용하여 KDNET과 같은 다른 전송으로 프로젝트를 전환해야 합니다. 해당 전송에 대한 자세한 내용은 KDNET 네트워크 커널 디버깅 자동 설정을 참조 하세요.

대상 컴퓨터와 호스트 컴퓨터가 디버깅에 IEEE 1394(FireWire) 연결을 사용하도록 지정합니다. 이 옵션을 사용하면 CHANNEL 매개 변수도 포함될 수 있습니다.

채널:채널
(연결 형식이 1394인 경우에만 사용됩니다.) 사용할 1394 채널을 지정합니다. 채널 값은 0에서 62 사이의 10진수 정수여야 하며 호스트 컴퓨터에서 사용하는 채널 번호와 일치해야 합니다. 이 매개 변수에 지정된 채널은 어댑터에서 선택한 실제 1394 포트에 따라 달라지지 않습니다. 채널의 기본값은 0입니다.

자세한 내용은 수동으로 1394 케이블을 통해 커널 모드 디버깅 설정을 참조 하세요.

일반 디버거 설정

/startpolicy
이 옵션은 디버거 시작 정책을 지정합니다. 다음 표에서는 시작에 대한 옵션을 보여줍니다.

옵션 설명
활성 커널 디버거가 활성 상태임을 지정합니다.
AUTOENABLE 예외 또는 기타 중요한 이벤트가 발생할 때 커널 디버거를 자동으로 사용하도록 지정합니다. 그때까지 디버거는 활성 상태이지만 사용하지 않도록 설정되었습니다.
DISABLE kdbgctrl을 입력하여 사용 블록을 지울 때 커널 디버거를 사용하도록 지정합니다. 그때까지 디버거는 활성 상태이지만 사용하지 않도록 설정되었습니다.

시작 정책을 지정하지 않으면 ACTIVE가 기본값입니다.

/noumex
커널 디버거가 사용자 모드 예외를 무시함을 지정합니다. 기본적으로 커널 디버거는 STATUS_BREAKPOINT 및 STATUS_SINGLE_STEP 같은 특정 사용자 모드 예외에 대해 중단됩니다. /noumex 매개 변수는 프로세스에 연결된 사용자 모드 디버거가 없는 경우에만 유효합니다.

설명

/dbgsettings 옵션은 디버깅 설정을 구성하지만 디버깅을 사용하도록 설정하지는 않습니다. /debug 옵션을 사용하여 특정 부팅 항목에 대한 디버깅을 사용하도록 설정해야 합니다. 특정 부팅 항목에 대해 지정된 디버깅 설정이 없는 경우 기본 디버그 설정이 사용됩니다.

dbgsettings의 기본값은 다음 표에 나와 있습니다.

dbgsetting 매개 변수 Default value
debugtype Local
debugstart 활성
noumex 예

참고 항목

Windows 디버깅 도구에 대한 자세한 내용은 Windows 디버깅을 참조 하세요.

커널 모드 디버깅 세션을 설정하고 구성하는 방법에 대한 자세한 내용은 수동으로 커널 모드 디버깅 설정 및 KDNET 네트워크 커널 디버깅 자동 설정을 참조하세요.