BCDEdit /dbgsettings

[アーティクル]
07/08/2024

/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ユーティリティを使用することを強くお勧めします。

手動セットアップの詳細については、「ネットワークケーブル経由でのカーネルモードデバッグの手動設定を参照してください。

USB 経由のイーサネットエミュレーションの詳細については、「 KDNET を使用した USB EEM 経由のカーネルモードデバッグの設定」を参照してください。

LOCAL

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

詳細については、以下を参照してください:

USB 3.0 ケーブルを経由のカーネルモードデバッグの手動設定

1394

重要

1394 トランスポートは、Windows 10 バージョン 1607 およびそれ以前で使用できます。それより後のバージョンの Windows では使用できません。イーサネットを使用して KDNET などの他のトランスポートにプロジェクトを移行する必要があります。そのトランスポートの詳細については、「KDNET ネットワークカーネルデバッグの自動設定」を参照してください。

ターゲットコンピューターとホストコンピューターがデバッグに IEEE 1394 (FireWire) 接続を使用することを指定します。このオプションを使用すると、 CHANNEL パラメーターも含めることができます。

CHANNEL:channel
(接続の種類が 1394 の場合にのみ使用)。使用する 1394 チャネルを指定します。 channel の値は、0 から 62 までの 10 進整数で、ホストコンピューターで使用されるチャネル番号と一致する必要があります。このパラメーターで指定されたチャネルは、アダプターで選択された物理 1394 ポートに依存しません。 channel の既定値は 0 です。

デバッガーの全般設定

/start startpolicy
このオプションは、デバッガーの開始ポリシーを指定します。次の表に、 startpolicy のオプションを示します。

オプション	説明
アクティブ	カーネルデバッガーがアクティブであることを指定します。
AUTOENABLE	例外またはその他の重大なイベントが発生したときに、カーネルデバッガーを自動的に有効にすることを指定します。それまでは、デバッガーはアクティブですが無効になっています。
DISABLE	kdbgctrl を入力して enable ブロックをクリアすると、カーネルデバッガーが有効になっていることを指定します。それまでは、デバッガーはアクティブですが無効になっています。

開始ポリシーが指定されていない場合は、ACTIVE が既定です。

/noumex
カーネルデバッガーがユーザーモードの例外を無視することを指定します。既定では、STATUS_BREAKPOINTやSTATUS_SINGLE_STEPなど、特定のユーザーモードの例外に対してカーネルデバッガーが中断されます。 /noumex パラメーターは、プロセスにアタッチされているユーザーモードデバッガーがない場合にのみ有効です。

Comments

/dbgsettings オプションはデバッグ設定を構成しますが、デバッグは有効にしません。特定のブートエントリのデバッグを有効にするには、 /debug オプションを使用する必要があります。特定のブートエントリに対してデバッグ設定が指定されていない場合は、既定のデバッグ設定が使用されます。

Dbgsettingsの既定値を次の表に示します。

dbgsettingパラメーター	規定値
debugtype	ローカル
debugstart	アクティブです
noumex	はい

次の方法で共有