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

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

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

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

デスクトップ デバイス上で Windows Device Portal を設定する

デバイス ポータルを有効にする前に、開発者モードが必要です。

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

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

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

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

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 デバイス ポータルのコンテンツ

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

• アプリ マネージャー
• ファイル エクスプローラー
• プロセスの実行
• Performance
• Debug
• ETW (Windowsのイベント トレース) のログ記録
• パフォーマンス トレース
• デバイス マネージャー
• Bluetooth
• ネットワーク
• クラッシュデータ
• Features
• 場所
• Scratch

Windows Device Portal を使用して MSIX アプリをテストおよびデバッグする

次のビデオでは、Windows Device Portal を使用して 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 マガジンの記事 を参照してください。

Troubleshooting

以下は、Windows Device Portal のセットアップ時に発生する可能性がある一般的なエラーです。

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

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

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

2. [どのような種類のコンテンツを受信しますか?] で、[Windowsのアクティブな開発] が選択されていることを確認します。

3. [新しいビルドを取得するペース] で、[Windows Insider Fast] が選択されていることを確認します。

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

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

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

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

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

こちらも参照ください

• Windows デバイス ポータルの概要
• Windows Device Portal のコア API リファレンス