Windows デバイスポータルの概要

Windows デバイスポータル (WDP) は、ネットワークまたは USB 接続経由でデバイスの設定を構成および管理できる Windows デバイスに含まれる Web サーバーです (ローカル接続は、Web ブラウザーを使用するデバイスでもサポートされます)。

WDP には、Windows デバイスのリアルタイムパフォーマンスのトラブルシューティングと表示のための高度な診断ツールも用意されています。

WDP 機能は、 REST API のコレクションを通じてプログラムによって公開されます。

この記事では、Windows デバイスポータルの一般的な説明と、各Windowsデバイスファミリに関するより具体的な情報を含む記事へのリンクを示します。

Note

デバイスファミリは、デバイスのクラス全体で期待できる API、システム特性、および動作を識別します。

Warning

デバイスポータルは既定で無効になっています。使用する前に、開発者モードを有効にしてから、[ 設定] > [システム > 詳細設定] でデバイスポータルを明示的に有効にする必要があります。

セットアップ

各デバイスファミリには WDP のバージョンが用意されていますが、機能とセットアップはデバイスの要件によって異なります。

これらは、すべてのデバイスの基本的な手順です。

開発者モードを有効にします。手順については、開発者向けの設定を参照してください。
デバイスで Device Portal を有効にします ([設定] > システム > 詳細設定)。
デバイスと PC をローカルネットワークまたは USB 経由で接続します。
ブラウザーの [デバイスポータル] ページに移動します。次の表に、各デバイスファミリで使用されるポートとプロトコルを示します。

次の表に、WDP のデバイス固有の詳細を示します。

デバイスファミリ	既定ではオンですか?	HTTP	HTTPS	USB	手順
Desktop と IoT Enterprise	開発モード内で有効にする	50080*	50043*	N/A	Desktop または IoT Enterprise デバイス向け Device Portal

* デスクトップ上のデバイスポータルが、デバイス上の既存のポート要求との競合を防ぐために一時的な範囲 (>50,000) のポートを要求するため、これは常に当てはまるとは限りません。詳細については、デスクトップ用デバイスポータルのレジストリベースの構成セクションWindows参照してください。

Features

ページの上部にあるツールバーから、よく使用される機能にアクセスできます。

電源: 電源オプションにアクセスします。
- シャットダウン: デバイスをオフにします。
- 再起動: デバイスの電源を循環します。
ヘルプ: ヘルプページを開きます。

ページの左側にあるナビゲーションウィンドウのリンクを使用して、デバイスで使用可能な管理および監視ツールに移動します。

ここでは、デバイスファミリ間で共通のツールについて説明します。デバイスによっては、その他のオプションを使用できる場合があります。詳細については、デバイスの種類の特定のページを参照してください。

アプリマネージャー

Apps マネージャーは、ホストデバイス上のアプリパッケージとバンドルのインストール/アンインストールと管理機能を提供します。

Device Portal の [アプリマネージャー] ページ

アプリの展開: ローカル、ネットワーク、または Web ホストからパッケージアプリを展開し、ネットワーク共有からルーズファイルを登録します。
インストールされているアプリ: ドロップダウンメニューを使用して、デバイスにインストールされているアプリを削除または起動します。
実行中のアプリ: 現在実行中のアプリに関する情報を取得し、必要に応じて閉じます。

アプリをインストール (サイドロード) する

Windows Device Portal を使用して、開発中にアプリをサイドロードできます。

アプリパッケージを作成したら、デバイスにリモートでインストールできます。 Visual Studioでビルドすると、出力フォルダーが生成されます。
Windowsデバイスポータルで、[アプリマネージャー] ページに移動します。
[ アプリのデプロイ ] セクションで、[ ローカルストレージ] を選択します。
[ アプリケーションパッケージの選択] で [ ファイルの選択 ] を選択し、サイドロードするアプリパッケージを参照します。
[ アプリパッケージの署名に使用する証明書ファイルの選択 (.cer)] で、[ ファイルの選択 ] を選択し、そのアプリパッケージに関連付けられている証明書を参照します。
アプリのインストールと共にオプションまたはフレームワークパッケージをインストールする場合は、それぞれのボックスをオンにし、[ 次へ ] を選択して選択します。
[ インストール] を選択してインストールを開始します。
デバイスが S モードでWindows 10実行されていて、指定された証明書がデバイスに初めてインストールされた場合は、デバイスを再起動します。

証明書をインストールする

または、Windows Device Portal を使用して証明書をインストールし、他の方法でアプリをインストールすることもできます。

Windowsデバイスポータルで、[アプリマネージャー] ページに移動します。
[ アプリの展開 ] セクションで、[ 証明書のインストール] を選択します。
アプリ パッケージの署名に使用する証明書ファイルの選択 (.cer) で、[ ファイルの選択 ] を選択し、サイドロードするアプリパッケージに関連付けられている証明書を参照します。
[ インストール] を選択してインストールを開始します。
デバイスが S モードでWindows 10実行されていて、指定された証明書がデバイスに初めてインストールされた場合は、デバイスを再起動します。

アプリのアンインストール

アプリが実行されていないことを確認します。
その場合は、[実行中の アプリ ] に移動して閉じます。アプリの実行中にアンインストールしようとすると、アプリを再インストールしようとしたときに問題が発生します。
ドロップダウンからアプリを選択し、[ 削除] をクリックします。

プロセスの実行

このページには、ホストデバイスで現在実行されているプロセスの詳細が表示されます。これには、アプリとシステムプロセスの両方が含まれます。このページからアプリとシステムプロセスの両方を終了できます。

ファイルエクスプローラー

このページでは、サイドロードされたアプリによって保存されたファイルを表示および操作できます。エクスプローラーページでアプリのローカルストレージを表示し、アプリデータを表示および管理します。

Performance

[パフォーマンス] ページには、電力使用量、フレームレート、CPU 負荷などのシステム診断情報のリアルタイムグラフが表示されます。

使用可能なメトリックは次のとおりです。

CPU: 使用可能な CPU 使用率の合計に対する割合
メモリ: 合計メモリ、使用中のメモリ、使用可能なメモリ、コミットされたメモリ、ページメモリ、非ページメモリ
I/O: データ量の読み取りと書き込み
ネットワーク: データの送受信
GPU: 使用可能な GPU エンジンの使用率の合計に対する割合

Windows イベントトレーシング (ETW) ログ

ETW ログページでは、デバイス上のリアルタイムイベントトレーシングWindows (ETW) 情報が管理されます。

[ プロバイダーを非表示にする] をオンにして、[イベント] リストのみを表示します。

登録済みプロバイダー: イベントプロバイダーとトレースレベルを選択します。トレースレベルは、次のいずれかの値です。
1. 異常終了または強制終了
2. 重大なエラー
3. Warnings
4. エラー以外の警告
5. 詳細なトレース
[有効にする] をクリックまたはタップしてトレースを開始します。プロバイダーが [有効なプロバイダー ] ドロップダウンに追加されます。
カスタムプロバイダー: カスタム ETW プロバイダーとトレースレベルを選択します。 GUID でプロバイダーを識別します。 GUID には角かっこを含めないでください。
有効なプロバイダー: 有効なプロバイダーが一覧表示されます。ドロップダウンからプロバイダーを選択し、[ 無効] をクリックまたはタップしてトレースを停止します。 [ すべて停止] をクリックまたはタップして、すべてのトレースを中断します。
プロバイダー履歴: 現在のセッション中に有効にされた ETW プロバイダーが表示されます。無効にされたプロバイダーをアクティブ化するには、[ 有効] をクリックまたはタップします。 [ クリア ] をクリックまたはタップして履歴をクリアします。
フィルター/イベント: [イベント ] セクションには、選択したプロバイダーからの ETW イベントがテーブル形式で一覧表示されます。テーブルはリアルタイムで更新されます。 [フィルター] メニューを使用して、イベントを表示するカスタムフィルターを設定します。 [ クリア ] ボタンをクリックして、テーブルからすべての ETW イベントを削除します。これにより、プロバイダーは無効になりません。 [ ファイルに保存 ] をクリックすると、現在収集されている ETW イベントをローカル CSV ファイルにエクスポートできます。

パフォーマンストレース

Windows Performance Toolkit にはパフォーマンストレースページが含まれており、ホストデバイスの Windows Performance Recorder (WPR) トレースを表示できます。

使用可能なプロファイル: ドロップダウンから WPR プロファイルを選択し、[ 開始 ] をクリックまたはタップしてトレースを開始します。
カスタムプロファイル: [ 参照 ] をクリックまたはタップして、PC から WPR プロファイルを選択します。 [アップロード] をクリックまたはタップ してトレースを開始 します。

トレースを停止するには、[ 停止] をクリックします。トレースファイル (.ETL) のダウンロードが完了するまで、このページを表示したままにしてください。

キャプチャ済み。ETLファイルは、Windows パフォーマンスアナライザーで分析するために開くことができます。

デバイスマネージャー

[デバイスマネージャー] ページには、デバイスに接続されているすべての周辺機器が列挙されます。設定アイコンをクリックすると、それぞれのプロパティを表示できます。

ネットワーク

[ネットワーク] ページでは、デバイス上のネットワーク接続を管理します。 USB 経由で Device Portal に接続していない限り、これらの設定を変更すると、デバイスポータルから切断される可能性があります。

使用可能なネットワーク: デバイスで使用可能な WiFi ネットワークが表示されます。ネットワークをクリックまたはタップすると、ネットワークに接続し、必要に応じてパスキーを指定できます。 Device Portal では、エンタープライズ認証はまだサポートされていません。 [ プロファイル ] ドロップダウンを使用して、デバイスに認識されている任意の WiFi プロファイルへの接続を試みることもできます。
IP 構成: ホストデバイスの各ネットワークポートに関するアドレス情報を表示します。

サービスの機能と注意事項

DNS-SD

Device Portal は、DNS-SD を使用してローカルネットワーク上でそのプレゼンスをアドバタイズします。デバイスの種類に関係なく、すべての Device Portal インスタンスが "WDP._wdp._tcp.local" でアドバタイズされます。サービスインスタンスの TXT レコードには、次のものが用意されています。

Key	タイプ	Description
S	int	デバイスポータルのセキュリティで保護されたポート。 0 (ゼロ) の場合、Device Portal は HTTPS 接続をリッスンしていません。
D	文字列	デバイスの種類。これは "Windows.*" という形式になります。たとえば、Windows.Desktop または Windows.IoTEnterprise です。
A	文字列	デバイスアーキテクチャ。これは、Arm、x86、または AMD64 になります。
T	ヌル文字で区切られた文字列のリスト	デバイスにユーザーが適用したタグ。これを使用する方法については、Tags REST API を参照してください。リストが double-null で終わる。

すべてのデバイスが、DNS-SD レコードによってアドバタイズされた HTTP ポートでリッスンしているわけではないので、HTTPS ポートでの接続が推奨されます。

CSRF の保護とスクリプト

CSRF 攻撃から保護するには、GET 以外のすべての要求で一意のトークンが必要です。このトークン (X-CSRF-Token 要求ヘッダー) は、セッション Cookie である CSRF-Token から派生します。 Device Portal Web UI では、CSRF-Token Cookie が各要求の X-CSRF-Token ヘッダーにコピーされます。

Important

この保護により、スタンドアロンクライアント (コマンドラインユーティリティなど) から REST API を使用できなくなります。これは、次の 3 つの方法で解決できます。

"auto-" で始まるユーザー名を使用します。ユーザー名に "auto-" を付加するクライアントは、CSRF 保護をバイパスします。このユーザー名は、CSRF 攻撃に対するサービスを開くので、ブラウザー経由でデバイスポータルにログインするために使用されないことが重要です。例: Device Portal のユーザー名が "admin" の場合は、CSRF 保護をバイパスするために curl -u auto-admin:password <args> を使用する必要があります。
クライアントで Cookie からヘッダーへのスキームを実装します。これには、セッション Cookie を確立するための GET 要求と、後続のすべての要求にヘッダーと Cookie の両方を含める必要があります。
認証を無効にし、HTTP を使用します。 CSRF 保護は HTTPS エンドポイントにのみ適用されるため、HTTP エンドポイント上の接続で上記のいずれかを行う必要はありません。

クロスサイト WebSocket ハイジャック（CSWSH）対策

CSWSH 攻撃から保護するには、デバイスポータルへの WebSocket 接続を開くすべてのクライアントも、ホストヘッダーに一致する Origin ヘッダーを提供する必要があります。これは、要求が Device Portal UI または有効なクライアントアプリケーションから送信されたことを Device Portal に証明します。 Origin ヘッダーがない場合、要求は拒否されます。

こちらも参照ください

Device Portal コア API リファレンス

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-07-17