Windowsデバイスポータル (デスクトップ用)

Windows Device Portal (WDP) は、デバイスの設定を構成および管理し、Web ブラウザーから HTTP 経由で診断情報を表示できるデバイス管理およびデバッグ ツールです。 その他のデバイスの WDP の詳細については、Windows デバイス ポータルの概要を参照してください。

WDP は次の目的で使用できます。

• デバイス設定の管理 (Windows 設定 アプリと同様)
• 実行中のプロセスの一覧を表示および操作する
• アプリのインストール、削除、起動、終了
• Wi-Fi プロファイルの変更、信号強度の表示、ipconfig の詳細の表示
• CPU、メモリ、I/O、ネットワーク、GPU 使用率のライブ グラフを表示する
• プロセス ダンプを収集
• ETW トレースを収集する
• サイドロードされたアプリの分離ストレージを操作する

デスクトップ デバイスで Windows デバイス ポータルを設定する

開発者モードを有効にする

開発者モードは、[設定] ([設定] -> [システム] -> [開発者向け]) の [開発者向け] セクションで有効にすることができます。 Windows 10 バージョン 1607 以降では、デスクトップ用の新しい機能の一部は、開発者モードが有効になっている場合にのみ使用できます。

重要

ネットワークまたは互換性の問題により、開発者モードがデバイスに正しくインストールされない場合があります。 これらの問題のトラブルシューティングについては、「デバイスの開発 を有効にする」の 関連するセクションを参照してください。

Windows デバイス ポータルを有効にする

WDP は、設定 の 開発者向け セクションで有効にすることができます (設定 -> システム - 開発者向け>)。

WDP が有効になると、[デバイス ポータル] セクションの下部に URI が表示されます。 一覧表示されている URL の末尾に追加されたポート番号を書き留めます。この数は、WDP が有効になっているときにランダムに生成されますが、デスクトップの再起動間で一貫性を保つ必要があります。

これらのリンクは、WDP に接続する方法として、ローカル ネットワーク (VPN を含む) 経由またはローカル ホスト経由の 2 つの方法を提供します。

Windows デバイス ポータル の スクリーンショット

Windows デバイス ポータルをオフにする

WDP は、Windows 設定の「開発者向け」セクション 無効にすることができます。

Windows デバイス ポータルに接続する

ローカル ホスト経由で接続するには、ブラウザー ウィンドウを開き、ここに示されている URI のいずれかを入力します (使用している接続の種類に基づいて)。

• Localhost: http://127.0.0.1:<PORT> または http://localhost:<PORT>
• ローカル ネットワーク: https://<IP address of the desktop>:<PORT>

認証とセキュリティで保護された通信には HTTPS が必要です。

WDP を保護された環境 (たとえば、ローカル ネットワーク上のすべてのユーザーを信頼し、デバイスに個人情報がなく、固有の要件があるテスト ラボ) で使用している場合は、[認証] オプションを無効にすることができます。 これにより、暗号化されていない通信が可能になり、コンピューターの IP アドレスを持つすべてのユーザーが接続して制御できるようになります。

Windows Device Portal のコンテンツ

WDP には、次の一連のページが用意されています。

• アプリ マネージャー
• Xbox Live
• ファイルエクスプローラー
• 実行中のプロセス
• パフォーマンス
• デバッグ
• ETW (Windows のイベント トレース) のログ記録
• パフォーマンス トレース
• デバイス マネージャー
• Bluetooth
• ネットワーキング
• クラッシュ データ
• 機能
• 複合現実
• ストリーミング インストール デバッガー
• 場所
• スクラッチ

Windows Device Portal を使用した MSIX アプリのテストとデバッグ

次のビデオでは、Windows デバイス ポータルを使用してリモート MSIX アプリ テストおよびデバッグする方法について説明します。

Windows デバイス ポータルのその他のオプション

以降のセクションでは、その他の Windows デバイス ポータル オプションについて詳しく説明します。

レジストリ ベースの構成

WDP のポート番号 (80 や 443 など) を選択する場合は、次の regkey を設定できます。

• HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WebManagement\Service の下
  • UseDynamicPorts: 必須の DWORD。 選択したポート番号を保持するには、これを 0 に設定します。
  • HttpPort: 必須の DWORD。 WDP が HTTP 接続をリッスンするポート番号を格納します。
  • HttpsPort: 必須の DWORD。 WDP が HTTPS 接続をリッスンするポート番号を格納します。

同じ regkey パスで、認証要件をオフにすることもできます。

• 無効の場合は UseDefaultAuthorizer - 0、有効の場合は 1。
  • これにより、各接続の基本的な認証要件と、HTTP から HTTPS へのリダイレクトの両方が制御されます。

Windows Device Portal のコマンド ライン オプション

管理コマンド プロンプトから、WDP の一部を有効にして構成できます。 ビルドでサポートされている最新のコマンド セットを表示するには、webmanagement /? を実行することができます。

• sc start webmanagement または sc stop webmanagement
  • サービスのオンとオフを切り替えます。 そのためには、開発者モードを有効にする必要があります。
• -Credentials <username> <password>
  • WDP のユーザー名とパスワードを設定します。 ユーザー名は基本認証標準に準拠している必要があるため、コロン (:)を含めることはできません。ブラウザーは標準の方法で完全な文字セットを解析しないため、[a-zA-Z0-9] など、標準の ASCII 文字から構築する必要があります。
• -DeleteSSL
  • これにより、HTTPS 接続に使用される SSL 証明書キャッシュがリセットされます。 (予想される証明書の警告ではなく) バイパスできない TLS 接続エラーが発生した場合、このオプションによって問題が解決される可能性があります。
• -SetCert <pfxPath> <pfxPassword>
  • 詳細については、「カスタム SSL 証明書 を使用した Windows Device Portal のプロビジョニング」を参照してください。
  • これにより、独自の SSL 証明書をインストールして、WDP で通常表示される SSL 警告ページを修正できます。
• -Debug <various options for authentication, port selection, and tracing level>
  • 特定の構成と表示されるデバッグ メッセージを使用して、WDP のスタンドアロン バージョンを実行します。 これは、パッケージ化されたプラグインを構築するのに最も便利です。
  • パッケージプラグインを完全にテストするためにこれをシステムとして実行する方法の詳細については、MSDNマガジンの記事 を参照してください。

トラブルシューティング

Windows デバイス ポータルを設定するときに発生する可能性がある一般的なエラーを次に示します。

WindowsUpdateSearch が無効な数の更新プログラムを返す (0x800f0950)

Windows のプレリリース ビルドに開発者パッケージをインストールしようとすると、このエラーが発生することがあります。 これらのオンデマンド機能 (FoD) パッケージは Windows Update 上にあり、プレリリース ビルドでダウンロードするには、テストプログラムに参加する必要があります。 インストールで適切なビルドとリングの組み合わせのフライティングをオプトインしていない場合、ペイロードはダウンロードできません。 次のことを再確認します。

1. 設定 > Windows Insider Program & セキュリティ > 更新プログラムに移動し、Windows Insider アカウント セクションに正しいアカウント情報があることを確認します。 このセクションが表示されない場合は、[Windows Insider アカウントをリンク を選択し、メール アカウントを追加し、Windows Insider アカウントの 見出しの下に表示されることを確認します (新しく追加されたアカウントを実際にリンクするには、Windows Insider アカウントをリンク もう一度選択する必要がある場合があります)。

2. どのようなコンテンツを受け取るか？という項目では、Windowsのアクティブな開発 が選択されていることを確認してください。

3. [新しいビルドを取得する頻度はどの程度を希望されますか?] の下で、[Windows Insider Fast]\(Windows Insider - 高速\) が選択されていることを確認します。

4. これで FoD をインストールできるようになります。 Windows Insider Fast を使用していて、FoD をインストールできない場合は、フィードバックを提供し、C:\Windows\Logs\CBSにログ ファイルを添付してください。

[SC]StartService: OpenService FAILED 1060: 指定されたサービスがインストール済みサービスとして存在しません

開発者パッケージがインストールされていない場合は、このエラーが発生する可能性があります。 開発者パッケージがない場合、Web 管理サービスはありません。 開発者パッケージをもう一度インストールしてみてください。

システムが従量制課金ネットワーク上にあるため、CBS はダウンロードを開始できません (CBS_E_METERED_NETWORK)

従量制課金インターネット接続を使用している場合は、このエラーが発生する可能性があります。 従量制課金接続で開発者パッケージをダウンロードすることはできません。

関連項目

• Windows Device Portal の概要
• Windows Device Portal コア API リファレンス