Windows Device Portal の概要Windows Device Portal overview

Windows Device Portal では、ネットワーク経由でリモートから、または USB 接続によって、デバイスの構成と管理を行えます。The Windows Device Portal lets you configure and manage your device remotely over a network or USB connection. また、トラブルシューティングを行うし、Windows デバイスのリアルタイムのパフォーマンスの表示に役立つ高度な診断ツールも提供します。It also provides advanced diagnostic tools to help you troubleshoot and view the real-time performance of your Windows device.

Windows Device Portal は、PC 上の web ブラウザーからに接続できるデバイスで web サーバーです。Windows Device Portal is a web server on your device that you can connect to from a web browser on a PC. デバイスでは、web ブラウザーには、するはそのデバイスのブラウザーでローカルに接続もできます。If your device has a web browser, you can also connect locally with the browser on that device.

Windows Device Portal は各デバイス ファミリで使用できますが、機能とセットアップは、各デバイスの要件に基づいて変化します。Windows Device Portal is available on each device family, but features and setup vary based on each device's requirements. ここでは、Device Portal の一般的な説明と、各デバイス ファミリに関するさらに詳細な情報が掲載されている記事へのリンクを示します。This article provides a general description of Device Portal and links to articles with more specific information for each device family.

Windows Device Portal の機能が実装されているREST Apiことは、データにアクセスし、デバイスの管理をプログラム的に直接使用することができます。The functionality of the Windows Device Portal is implemented with REST APIs that you can use directly to access data and control your device programmatically.

セットアップSetup

Device Portal への接続の具体的な手順はデバイスによって異なりますが、どのデバイスでも次の一般的な手順が必要です。Each device has specific instructions for connecting to Device Portal, but each requires these general steps:

  1. (構成、設定アプリで) デバイスで開発者モードとデバイスのポータルを有効にします。Enable Developer Mode and Device Portal on your device (configured in the Settings app).
  2. ローカル ネットワーク経由または USB デバイスと PC を接続します。Connect your device and PC through a local network or with USB.
  3. ブラウザーでデバイス ポータルのページに移動します。Navigate to the Device Portal page in your browser. 次の表は、ポートと各デバイス ファミリで使用されるプロトコルを示します。This table shows the ports and protocols used by each device family.
デバイス ファミリDevice family 既定でオンになっているかOn by default? HTTPHTTP HTTPSHTTPS USBUSB
HoloLensHoloLens 開発者モードでオンYes, in Dev Mode 80 (既定)80 (default) 443 (既定)443 (default) http://127.0.0.1:10080
IoTIoT 開発者モードでオンYes, in Dev Mode 80808080 レジストリ キーで有効化するEnable via regkey なしN/A
XboxXbox 開発者モードで有効化するEnable inside Dev Mode DisabledDisabled 1144311443 なしN/A
DesktopDesktop 開発者モードで有効化するEnable inside Dev Mode 50080*50080* 50043*50043* なしN/A
PhonePhone 開発者モードで有効化するEnable inside Dev Mode 8080 443443 http://127.0.0.1:10080

* これは常に場合は、デスクトップ上のデバイスのポータルが短期の範囲内のポートを要求として (> 50,000) デバイスで既存のポートのクレームとの競合を回避します。* This is not always the case, as Device Portal on desktop claims ports in the ephemeral range (>50,000) to prevent collisions with existing port claims on the device. 詳しくは、デスクトップに関する「ポート番号を設定する」のセクションをご覧ください。To learn more, see the Port Settings section for desktop.

デバイス固有のセットアップ手順については、以下をご覧ください。For device-specific setup instructions, see:

機能Features

ツールバーとナビゲーションToolbar and navigation

ページの上部にあるツールバーでは、一般的に使用される機能へのアクセスを提供します。The toolbar at the top of the page provides access to commonly used features.

  • Power:電源オプション のアクセス。Power: Access power options.
    • シャット ダウン:デバイスをオフにします。Shutdown: Turns off the device.
    • 再起動:デバイスの電源が循環します。Restart: Cycles power on the device.
  • ヘルプ:ヘルプ ページが開きます。Help: Opens the help page.

ページの左側にあるナビゲーション ウィンドウのリンクを使用して、デバイスの管理と監視に利用可能なツールに移動します。Use the links in the navigation pane along the left side of the page to navigate to the available management and monitoring tools for your device.

ここでは、デバイス ファミリに共通するツールについて説明します。Tools that are common across device families are described here. デバイスによってはその他のオプションを利用できる場合があります。Other options might be available depending on the device. 詳細については、デバイスの種類の特定のページを参照してください。For more info, see the specific page for your device type.

アプリ マネージャーApps manager

Apps manager には、インストール/アンインストールし、アプリの管理機能をパッケージ化し、ホスト デバイスにバンドルします。The Apps manager provides install/uninstall and management functionality for app packages and bundles on the host device.

デバイスのポータル アプリはマネージャー ページ

  • アプリを展開する:ローカルからのパッケージ アプリ、ネットワーク、または web ホストを展開し、ネットワーク共有から圧縮しないファイルを登録します。Deploy apps: Deploy packaged apps from local, network, or web hosts and register loose files from network shares.
  • アプリがインストールされている:ドロップダウン メニューを使用して、削除するか、デバイスにインストールされているアプリを起動します。Installed apps: Use the dropdown menu to remove or start apps that are installed on the device.
  • アプリを実行している:現在実行中、必要に応じてそれらを閉じるアプリに関する情報を取得します。Running apps: Get information about the apps that are currently running and close them as necessary.

(サイドロード) アプリをインストールします。Install (sideload) an app

Windows Device Portal を使用した開発中にアプリをサイドロードすることができます。You can sideload apps during development using Windows Device Portal:

  1. アプリ パッケージを作成した場合は、デバイス上にリモートでインストールできます。When you've created an app package, you can remotely install it onto your device. Visual Studio でビルドすると、出力フォルダーが生成されます。After you build it in Visual Studio, an output folder is generated.

アプリのインストール

  1. Windows Device Portal のに移動、 Apps managerページ。In Windows Device Portal, navigate to the Apps manager page.

  2. アプリを展開するセクションで、ローカル ストレージします。In the Deploy apps section, select Local Storage.

  3. アプリケーション パッケージを選択してを選択しますファイルの選択サイドロードするアプリ パッケージを参照します。Under Select the application package, select Choose File and browse to the app package that you want to sideload.

  4. アプリ パッケージの署名に使用される証明書の選択ファイル (.cer) を選択しますChoose Fileし、そのアプリのパッケージに関連付けられている証明書を参照します。Under Select certificate file (.cer) used to sign app package, select Choose File and browse to the certificate associated with that app package.

  5. 省略可能なインストールやアプリのインストールと共にフレームワーク パッケージを選択すると、それぞれのボックスをチェックして選択します。Check the respective boxes if you want to install optional or framework packages along with the app installation, and select Next to choose them.

  6. 選択インストールのインストールを開始します。Select Install to initiate the installation.

  7. デバイスが S のモードで Windows 10 を実行しているが初めてデバイスの特定の証明書がインストールされている場合、デバイスを再起動します。If the device is running Windows 10 in S mode, and it is the first time that the given certificate has been installed on the device, restart the device.

証明書をインストールします。Install a certificate

または、Windows Device Portal を使用して証明書をインストールし、他の手段でアプリをインストールします。Alternatively, you can install the certificate via Windows Device Portal, and install the app through other means:

  1. Windows Device Portal のに移動、 Apps managerページ。In Windows Device Portal, navigate to the Apps manager page.

  2. アプリを展開するセクションで、証明書のインストールします。In the Deploy apps section, select Install Certificate.

  3. アプリ パッケージの署名に使用される証明書の選択ファイル (.cer) を選択しますファイルの選択サイドロードするアプリ パッケージに関連付けられている証明書を参照します。Under Select certificate file (.cer) used to sign an app package, select Choose File and browse to the certificate associated with the app package that you want to sideload.

  4. 選択インストールのインストールを開始します。Select Install to initiate the installation.

  5. デバイスが S のモードで Windows 10 を実行しているが初めてデバイスの特定の証明書がインストールされている場合、デバイスを再起動します。If the device is running Windows 10 in S mode, and it is the first time that the given certificate has been installed on the device, restart the device.

アプリをアンインストールするUninstall an app

  1. アプリが実行中でないことを確認します。Ensure that your app is not running.
  2. 場合を参照してください。アプリを実行しているして閉じます。If it is, go to Running apps and close it. 場合は、アプリの実行中をアンインストールしようとすると、問題が生じるため、アプリを再インストールしようとしたときにします。If you attempt to uninstall while the app is running, it will cause issues when you attempt to reinstall the app.
  3. ドロップダウン リストとクリックからアプリを選択削除します。Select the app from the dropdown and click Remove.

実行中のプロセスRunning processes

このページには、ホスト デバイスで現在実行されているプロセスに関する詳細情報が表示されます。This page shows details about processes currently running on the host device. これには、アプリとシステムの両方のプロセスが含まれます。This includes both apps and system processes. (デスクトップや IoT、HoloLens) 一部のプラットフォームでは、プロセスを終了できます。On some platforms (Desktop, IoT, and HoloLens), you can terminate processes.

ページを処理するポータルを実行しているデバイス

エクスプローラーFile explorer

このページを表示およびサイドロードしたアプリによって保存されているファイルを操作できます。This page allows you to view and manipulate files stored by any sideloaded apps. 参照してください、アプリのファイル エクスプ ローラーを使用してブログの投稿をファイル エクスプ ローラーとその使用方法の詳細を参照してください。See the Using the App File Explorer blog post to learn more about the File explorer and how to use it.

デバイスのポータル ファイル エクスプ ローラー ページ

パフォーマンスPerformance

[パフォーマンス] ページには、電力使用状況、フレーム レートのようなシステム診断情報のリアルタイムのグラフが表示されます。 と CPU の負荷。The Performance page shows real-time graphs of system diagnostic info like power usage, frame rate, and CPU load.

利用可能なメトリックを次に示します。These are the available metrics:

  • CPU:使用可能な CPU 使用率の合計の割合CPU: Percent of total available CPU utilization
  • メモリ:内の合計、使用して、使用可能なコミット、ページング、および非ページMemory: Total, in use, available, committed, paged, and non-paged
  • I/O:読み取りと書き込みのデータ量I/O: Read and write data quantities
  • ネットワーク:受信および送信データNetwork: Received and sent data
  • GPU:使用可能な GPU エンジンの合計使用率の割合GPU: Percent of total available GPU engine utilization

デバイスのポータルのパフォーマンス ページ

Event Tracing for Windows (ETW) ログ記録Event Tracing for Windows (ETW) logging

ETW のログ記録 ページでは、デバイスのリアルタイムの Event Tracing for Windows (ETW) 情報を管理します。The ETW logging page manages real-time Event Tracing for Windows (ETW) information on the device.

デバイスのポータルの ETW のログ記録 ページ

[Hide Providers] (プロバイダを非表示にする) チェックボックスをオンにすると、イベントの一覧のみが表示されます。Check Hide providers to show the Events list only.

  • 登録済みプロバイダー:イベント プロバイダーは、トレース レベルを選択します。Registered providers: Select the event provider and the tracing level. トレース レベルでは、これらの値の 1 つです。The tracing level is one of these values:

    1. 異常終了または終了Abnormal exit or termination
    2. 重大なエラーSevere errors
    3. 警告Warnings
    4. エラーではない警告Non-error warnings
    5. 詳細なトレースDetailed trace

    トレースを開始するには、[Enable] (有効にする) をクリックまたはタップします。Click or tap Enable to start tracing. [Enabled Providers] (有効なプロバイダー) ドロップダウン リストにプロバイダーが追加されます。The provider is added to the Enabled Providers dropdown.

  • カスタム プロバイダー:カスタムの ETW プロバイダーと、トレース レベルを選択します。Custom providers: Select a custom ETW provider and the tracing level. GUID を使用してプロバイダーを識別します。Identify the provider by its GUID. GUID に角かっこは含めないでください。Do not include brackets in the GUID.

  • プロバイダーを有効になっている:これには、有効なプロバイダーが一覧表示します。Enabled providers: This lists the enabled providers. ドロップダウンからプロバイダーを選択し、[Disable] (無効にする) をクリックまたはタップしてトレースを停止します。Select a provider from the dropdown and click or tap Disable to stop tracing. すべてのトレースを中断するには、[Stop All] (すべて停止) をクリックまたはタップします。Click or tap Stop all to suspend all tracing.

  • プロバイダーの履歴:これは、現在のセッション中に有効にしていた ETW プロバイダーを表示します。Providers history: This shows the ETW providers that were enabled during the current session. 無効になっているプロバイダーをアクティブ化するには、[Enable] (有効にする) をクリックまたはタップします。Click or tap Enable to activate a provider that was disabled. 履歴をクリアするには、[Clear] (クリア) をクリックまたはタップします。Click or tap Clear to clear the history.

  • フィルター/イベント:イベントセクションには、テーブル形式で選択したプロバイダーから ETW イベントが一覧表示します。Filters / Events: The Events section lists ETW events from the selected providers in table format. テーブルは、リアルタイムで更新されます。The table is updated in real time. 使用して、フィルターメニューに表示されるイベントをカスタム フィルターを設定します。Use the Filters menu to set up custom filters for which events will be displayed. をクリックして、クリアテーブルからすべての ETW イベントを削除するボタンをクリックします。Click the Clear button to delete all ETW events from the table. これによってプロバイダーが無効になることはありません。This does not disable any providers. クリックすることができますファイルに保存する現在収集された ETW イベントをローカルの CSV ファイルにエクスポートします。You can click Save to file to export the currently collected ETW events to a local CSV file.

ETW のログ記録の使用に関する詳細については、次を参照してください。、デバイス ポータルでのデバッグ ログを表示するブログの投稿。For more details on using ETW logging, see the Use Device Portal to view debug logs blog post.

パフォーマンス トレースPerformance tracing

パフォーマンス トレース ページで表示できます、 Windows Performance Recorder (WPR)ホスト デバイスからのトレース。The Performance tracing page allows you for view the Windows Performance Recorder (WPR) traces from the host device.

デバイスのポータルのパフォーマンス トレースのページ

  • 使用可能なプロファイル:ドロップダウン リスト、およびクリックまたはタップしますから WPR プロファイルを選択開始トレースを開始します。Available profiles: Select the WPR profile from the dropdown, and click or tap Start to start tracing.
  • カスタム プロファイル:をクリックしてまたはタップします参照を PC から WPR プロファイルを選択します。Custom profiles: Click or tap Browse to choose a WPR profile from your PC. [Upload and start] (アップロードして開始) をクリックまたはタップすると、トレースが開始します。Click or tap Upload and start to start tracing.

トレースを停止するには、[Stop] (停止) をクリックします。To stop the trace, click Stop. トレース ファイルまで、このページに留まります (です。ETL) のダウンロードが完了するとします。Stay on this page until the trace file (.ETL) has finished downloading.

キャプチャされます。分析のために ETL ファイルを開くことが、 Windows Performance Analyzerします。Captured .ETL files can be opened for analysis in the Windows Performance Analyzer.

デバイス マネージャーDevice manager

デバイス マネージャー ページでは、デバイスに接続されているすべての周辺機器を列挙します。The Device manager page enumerates all peripherals attached to your device. それぞれのプロパティを表示する設定アイコンをクリックできます。You can click the settings icons to view the properties of each.

デバイスのポータルのデバイス マネージャー ページ

ネットワークNetworking

ネットワーク ページでは、デバイス上のネットワーク接続を管理します。The Networking page manages network connections on the device. USB 経由のデバイスのポータルに接続している場合を除き、これらの設定を変更する可能性がありますから切断されますをデバイスのポータルです。Unless you are connected to Device Portal through USB, changing these settings will likely disconnect you from Device Portal.

  • 使用可能なネットワーク:デバイスで使用できる、WiFi ネットワークを示しています。Available networks: Shows the WiFi networks available to the device. ネットワークをクリックまたはタップすると、そのネットワークに接続し、必要に応じてパスキーを提供できます。Clicking or tapping on a network will allow you to connect to it and supply a passkey if needed. デバイスのポータルは、エンタープライズ認証をまだサポートしていません。Device Portal does not yet support Enterprise Authentication. 使用することも、プロファイルドロップダウンを使用して既知のデバイスに Wi-fi プロファイルのいずれかに接続しようとしています。You can also use the Profiles dropdown to attempt to connect to any of the WiFi profiles known to the device.
  • IP 構成:アドレスの各ホスト デバイスのネットワーク ポートに関する情報を表示します。IP configuration: Shows address information about each of the host device's network ports.

デバイスのポータルのネットワーク ページ

サービスの機能と注意事項Service features and notes

DNS-SDDNS-SD

Device Portal は DNS-SD を使用して、ローカル ネットワーク上でその存在をアドバタイズしますDevice Portal advertises its presence on the local network using DNS-SD. Device Portal のすべてのインスタンスは、デバイスの種類に関係なく、"WDP._wdp._tcp.local" でアドバタイズします。All Device Portal instances, regardless of their device type, advertise under "WDP._wdp._tcp.local". サービス インスタンスの TXT レコードは、次の情報を提供します。The TXT records for the service instance provide the following:

KeyKey 種類Type 説明Description
SS intint Device Portal 用のセキュリティで保護されたポート。Secure port for Device Portal. 0 (ゼロ) の場合、Device Portal は HTTPS 接続をリッスンしていません。If 0 (zero), Device Portal is not listening for HTTPS connections.
DD stringstring デバイスの種類。Type of device. "Windows.*" の形式 (Windows.Xbox、Windows.Desktop など) になります。This will be in the format "Windows.*", e.g. Windows.Xbox or Windows.Desktop
AA stringstring デバイスのアーキテクチャ。Device architecture. これは、ARM、x86、AMD64 のいずれかです。This will be ARM, x86, or AMD64.
TT null 文字で区切られた string のリストnull-character delineated list of strings ユーザーが適用したデバイスのタグ。User-applied tags for the device. 使い方については、タグの REST API に関する説明をご覧ください。See the Tags REST API for how to use this. リストは 2 つの null で終了します。List is double-null terminated.

DNS-SD レコードでアドバタイズされる HTTP ポートですべてのデバイスがリッスンしているわけではないため、HTTPS ポートでの接続をお勧めします。Connecting on the HTTPS port is suggested, as not all devices are listening on the HTTP port advertised by the DNS-SD record.

CSRF に対する保護とスクリプトCSRF Protection and Scripting

CSRF 攻撃に対する保護のために、すべての非 GET 要求に一意のトークンが必要です。In order to protect against CSRF attacks, a unique token is required on all non-GET requests. このトークン、X-CSRF-Token 要求ヘッダーは、セッション Cookie、CSRF-Token から派生します。This token, the X-CSRF-Token request header, is derived from a session cookie, CSRF-Token. Device Portal の Web UI では、CSRF-Token Cookie が、各要求の X-CSRF-Token にコピーされます。In the Device Portal web UI, the CSRF-Token cookie is copied into the X-CSRF-Token header on each request.

重要

この保護は、(コマンド ライン ユーティリティ) などのスタンドアロン クライアントから REST Api の使用状況をできないようにします。This protection prevents usages of the REST APIs from a standalone client (such as command-line utilities). これは 3 つの方法で解決できます。This can be solved in 3 ways:

  • 「自動-」ユーザー名を使用します。Use an "auto-" username. クライアントはユーザー名の前に "auto-" を追加することによって、CSRF に対する保護を迂回できます。Clients that prepend "auto-" to their username will bypass CSRF protection. このユーザー名は、ブラウザーから Device Portal にログインするために使用しないでください。サービスが CSRF 攻撃を受ける可能性があります。It is important that this username not be used to log in to Device Portal through the browser, as it will open up the service to CSRF attacks. 以下に例を示します。デバイスのポータルのユーザー名が"admin"の場合curl -u auto-admin:password <args>CSRF 保護をバイパスするために使用する必要があります。Example: If Device Portal's username is "admin", curl -u auto-admin:password <args> should be used to bypass CSRF protection.
  • クライアントで cookie-to-header スキームを実装します。Implement the cookie-to-header scheme in the client. そのためには、GET 要求でセッション Cookie を確立し、それ以降のすべての要求にヘッダーと Cookie の両方を含めます。This requires a GET request to establish the session cookie, and then the inclusion of both the header and the cookie on all subsequent requests.
  • 認証を無効にして、HTTP を使用します。Disable authentication and use HTTP. CSRF に対する保護は HTTPS エンドポイントにのみ適用されるため、HTTP エンドポイントに接続する場合、上記のいずれの操作も必要ありません。CSRF protection only applies to HTTPS endpoints, so connections on HTTP endpoints will not need to do either of the above.

クロスサイト WebSocket ハイジャック (CSWSH) に対する保護Cross-Site WebSocket Hijacking (CSWSH) protection

CSWSH 攻撃を防御するために、Device Portal に対して WebSocket 接続を開くすべてのクライアントは、Host ヘッダーと一致する Origin ヘッダーも提供する必要があります。To protect against CSWSH attacks, all clients opening a WebSocket connection to Device Portal must also provide an Origin header that matches the Host header. これにより、Device Portal に対して、要求が Device Portal の UI または有効なクライアント アプリケーションからの要求であることを証明します。This proves to Device Portal that the request comes either from the Device Portal UI or a valid client application. Origin ヘッダーがない場合、要求は拒否されます。Without the Origin header your request will be rejected.