BCDEdit /dbgsettings
/dbgsettings オプションは、コンピューターの現在のグローバル デバッガー設定を設定または表示します。 カーネル デバッガーを有効または無効にするには、 BCDEdit /debug オプションを使用します。
Note
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 サーバーが存在しないことがわかっている場合にのみ使用してください。 ほとんどの場合、KDNET トランスポートは、このオプションが設定されておらず、DHCP が有効な場合に最適です。
busparams=Bus.Device.Function ターゲット コントローラーを指定します。 Bus でバス番号、Device でデバイス番号、Function で関数番号を指定します。
バス パラメーターを指定するには、デバイス マネージャーを開き、デバッグに使用するネットワーク アダプターを見つけます。 ネットワーク アダプターのプロパティ ページを開き、バス番号、デバイス番号、および関数番号をメモします。 これらの値は、General タブの Location の下のデバイス マネージャーに表示されます。管理者特権のコマンド プロンプト ウィンドウで、次のコマンドを入力します。ここで、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
重要
ネットワークデバッグを手動で設定することは、複雑でエラーが発生しやすいプロセスです。 ネットワークデバッグを自動的に設定するには、 「KDNET Networkカーネルデバッグを自動的に設定する」 を参照してください。 すべてのデバッガーユーザーには、KDNETユーティリティを使用することを強くお勧めします。
手動セットアップの詳細については、「 ネットワーク ケーブル経由でのカーネル モード デバッグの手動設定を参照してください。
ローカル
LOCAL オプションは、グローバル デバッグ オプションをローカル デバッグに設定します。 これは、1 台のコンピューター上でのカーネルモード デバッグです。 つまり、デバッガーは、デバッグ中の同じコンピューター上で実行されます。 ローカル デバッグを使用すると、状態を調べることができますが、OS の実行を停止させるカーネル モード プロセスに分割することはできません。
例
次のコマンドは、グローバル デバッガー設定をローカル デバッグに設定します。
bcdedit /dbgsettings LOCAL
LOCAL オプションは、Windows 8.0 および Windows Server 2012 以降で使用できます。
ローカル カーネル モードのデバッグを手動で設定する方法については、「 単一コンピューターのローカル カーネル デバッグを手動で設定するを参照してください。
シリアル
ターゲット コンピューターとホスト コンピューターがデバッグにシリアル接続を使用することを指定します。 このオプションを使用する場合は、 DEBUGPORT パラメーターと BAUDRATE パラメーターを指定する必要があります。
BAUDRATE:baud
使用するボー レートを指定します。 このパラメーターは省略可能です。 audの有効な値は、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" または "DEBUG" を使用すると、デバッグは正しく機能しません。
- 文字列に使用できる文字は、ハイフン(-)、アンダースコア(_)、数字の0~9、アルファベットのA~Z(大文字または小文字)のみです。
- 文字列の長さは最大で 24 文字です。
例
次のコマンドは、デバッグに USB 接続を使用するようにターゲット コンピューターを構成します。 このコマンドでは、ホスト コンピューターがターゲット コンピューターへの接続に使用できるターゲット名も指定します。
bcdedit /dbgsettings usb targetname:myTarget
詳細については、以下を参照してください:
1394
重要
1394 トランスポートは、Windows 10 バージョン 1607 およびそれ以前で使用できます。 それより後のバージョンの Windows では使用できません。 イーサネットを使用して KDNET などの他のトランスポートにプロジェクトを移行する必要があります。 そのトランスポートの詳細については、「KDNET ネットワーク カーネル デバッグの自動設定」を参照してください。
ターゲット コンピューターとホスト コンピューターがデバッグに IEEE 1394 (FireWire) 接続を使用することを指定します。 このオプションを使用すると、 CHANNEL パラメーターも含めることができます。
CHANNEL:channel
(接続の種類が 1394 の場合にのみ使用)。使用する 1394 チャネルを指定します。 channel の値は、0 から 62 までの 10 進整数で、ホスト コンピューターで使用されるチャネル番号と一致する必要があります。 このパラメーターで指定されたチャネルは、アダプターで選択された物理 1394 ポートに依存しません。 channel の既定値は 0 です。
詳細については、「 1394 ケーブルでのカーネル モード デバッグの手動設定を参照してください。
デバッガーの全般設定
/start startpolicy
このオプションは、デバッガーの開始ポリシーを指定します。 次の表に、 startpolicy のオプションを示します。
オプション | 説明 |
---|---|
アクティブ | カーネル デバッガーがアクティブであることを指定します。 |
AUTOENABLE | 例外またはその他の重大なイベントが発生したときに、カーネル デバッガーを自動的に有効にすることを指定します。 それまでは、デバッガーはアクティブですが無効になっています。 |
DISABLE | kdbgctrl を入力して enable ブロックをクリアすると、カーネル デバッガーが有効になっていることを指定します。 それまでは、デバッガーはアクティブですが無効になっています。 |
開始ポリシーが指定されていない場合は、ACTIVE が既定です。
/noumex
カーネル デバッガーがユーザー モードの例外を無視することを指定します。 既定では、STATUS_BREAKPOINTやSTATUS_SINGLE_STEPなど、特定のユーザー モードの例外に対してカーネル デバッガーが中断されます。 /noumex パラメーターは、プロセスにアタッチされているユーザー モード デバッガーがない場合にのみ有効です。
Comments
/dbgsettings オプションはデバッグ設定を構成しますが、デバッグは有効にしません。 特定のブート エントリのデバッグを有効にするには、 /debug オプションを使用する必要があります。 特定のブート エントリに対してデバッグ設定が指定されていない場合は、既定のデバッグ設定が使用されます。
Dbgsettingsの既定値を次の表に示します。
dbgsettingパラメーター | 規定値 |
---|---|
debugtype | ローカル |
debugstart | アクティブです |
noumex | はい |
関連項目
Windowsデバッグツールの詳細については、 「Windowsデバッグ」 を参照してください。
カーネルモードのデバッグセッションの設定と構成の詳細については、 「カーネルモードデバッグの手動設定」 と 「KDNET Networkカーネルデバッグの自動設定」 を参照してください。