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. (設定アプリで構成されている) デバイスで開発者モードと Device Portal を有効にします。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 無効Disabled 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

* デスクトップ上の Device Portal が、デバイス上の既存のポート要求との競合を避ける目的で ephemeral ポートの範囲 (>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: Access power options.
    • [Shutdown] (シャットダウン): デバイスをオフにします。Shutdown: Turns off the device.
    • [Restart] (再起動): デバイスの電源を入れ直します。Restart: Cycles power on the device.
  • [Help] (ヘルプ): ヘルプ ページを開きます。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

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

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

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

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

  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. アプリのインストール
  2. Device Portal のアプリ マネージャーのセクションでは、追加] をクリックし、ローカル記憶域からのアプリ パッケージのインストールを選択します。In the Device Portal's Apps manager section, click Add and select Install app package from local storage.
  3. 参照をクリックし、アプリ パッケージを検索します。Click browse and find your app package.
  4. [参照] をクリックし、(必要ありませんすべてのデバイスで)。 証明書 (.cer) ファイルを検索Click browse and find the certificate (.cer) file (not required on all devices.)
  5. フレームワーク パッケージと共にアプリのインストール オプションをインストールする場合、それぞれのボックスを確認します。Check the respective boxes if you want to install optional or framework packages along with the app installation. 1 つ以上ある場合は、それぞれを個別に追加します。If you have more than one, add each one individually.
  6. [次へ] をクリックして、インストールを開始するため、次の手順とインストールに移動します。Click Next to move to the next step and Install to initiate the installation.

アプリをアンインストールする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

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

Windows トレーシング (ETW) のイベント ログEvent Tracing for Windows (ETW) logging

ETW ログ] ページでは、デバイスでのリアルタイムのイベント 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. トレース レベルは、これらの値のいずれかを示します。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.

  • [Custom providers] (カスタム プロバイダー): カスタム 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 プロバイダー。 これにより、有効なプロバイダーを一覧表示します。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.

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

  • [Available profiles] (利用可能なプロファイル): ドロップダウン リストから WPR プロファイルを選択し、[Start] (開始) をクリックまたはタップすると、トレースを開始できます。Available profiles: Select the WPR profile from the dropdown, and click or tap Start to start tracing.
  • [Custom profiles] (カスタム プロファイル): [Browse] (参照) をクリックまたはタップして、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 経由の Device Portal に接続している場合を除き、これらの設定を変更する切断される可能性が Device Portal からです。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 はまだサポートされていませんエンタープライズ認証します。Device Portal does not yet support Enterprise Authentication. 既知のデバイスに WiFi プロファイルのいずれかに接続しようとするのにプロファイルドロップダウン リストを使用することもできます。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:

キーKey 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:

  • "Auto-"というユーザー名を使用します。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. 例: Device Portal のユーザー名が "admin" である場合、CSRF に対する保護を迂回するために curl -u auto-admin:password <args> を使用します。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.