Share via

Windows 10 IoT Core コマンド ライン ユーティリティ

  • [アーティクル]

デバイスの一部の設定を構成しようと考えていますか。 以下のツールを自由に利用できます。 デバイスに接続した後、PowerShell を使用してこれらのコマンドを実行します。

注意

これらのツールは事前に読み込まれていません。これらのツールをイメージに含めるには、適切な機能 ID を含める必要があります。

IoT Core 固有のコマンド ライン ユーティリティ

スタートアップ アプリの設定

スタートアップ エディターを使用して、Windows IoT Core デバイスでスタートアップ アプリを構成します。 次のいずれかのオプションを使用して IotStartup を実行します。

  • IotStartup list では、インストールされているアプリケーションを一覧表示します
  • IotStartup list headed では、インストールされているヘッド付きアプリケーションを一覧表示します
  • IotStartup list headless では、インストールされているヘッドレス アプリケーションを一覧表示します
  • IotStartup list [MyApp] では、パターン MyApp と一致する、インストールされているアプリケーションを一覧表示します
  • IotStartup add では、ヘッド付きおよびヘッドレス アプリケーションを追加します
  • IotStartup add headed [MyApp] では、パターン MyApp と一致するヘッド付きアプリケーションを一覧表示します パターンは、1 つのアプリケーションにのみ一致しなければなりません。
  • IotStartup add headless [Task1] では、パターン Task1 と一致するヘッドレス アプリケーションを一覧表示します
  • IotStartup remove では、ヘッド付きおよびヘッドレス アプリケーションを削除します
  • IotStartup remove headed [MyApp] では、パターン MyApp と一致するヘッド付きアプリケーションを一覧表示します
  • IotStartup remove headless [Task1] では、パターン Task1 と一致するヘッドレス アプリケーションを一覧表示します
  • IotStartup startup では、スタートアップ用に登録されたヘッド付きアプリケーションとヘッドレス アプリケーションを一覧表示します
  • IotStartup startup [MyApp] では、パターン MyApp に一致するスタートアップ用に登録されたヘッド付きおよびヘッドレス アプリケーションを一覧表示します
  • IotStartup startup headed [MyApp] では、MyApp に一致するスタートアップ用に登録されたヘッド付きアプリケーションを一覧表示します
  • IotStartup startup headless [Task1] では、Task1 に一致するスタートアップ用に登録されたヘッドレス アプリケーションを一覧表示します
  • IotStartup run [MyApp] では、MyApp で識別されるアプリを起動します
  • IotStartup stop [MyApp] では、MyApp で識別されるアプリを停止します
  • 詳細については、IotStartup help を試行してください

リージョンとユーザーまたは音声言語の設定を変更する

IoTSettings ツールでは、地域、ユーザー言語、または音声言語が変更されます。 これは、ProcessLauncher API を使用してアプリケーションから呼び出すことができるコマンド ライン ツールです。 これらのコマンドは、管理者ではなく、既定のアカウントとして実行する必要があります。

  • IotSettings del account {all | username} では、システム上のすべての MSA または Azure AD アカウント、または特定のアカウントを削除します。 特定のアカウントは username@provider.com の形式を取ります
  • IotSettings del diagnostics では、現在のデバイスのクラウド内の診断情報を削除します。 これにより、呼び出しの時点までの履歴が削除されることに注意してください。 新しい診断情報は引き続きログに記録されます。
  • IotSettings list account では、デバイスにサインインしているすべての MSA または Azure AD アカウントを一覧表示します。
  • IotSettings list uilanguage では、すべての UI 言語を一覧表示します
  • IotSettings list speechlanguage では、すべての音声認識の言語を一覧表示します
  • IotSettings get uilanguage では、現在の UI 言語を表示します
  • IotSettings get speechlanguage では、現在の音声認識の言語を表示します
  • IotSettings get region では、現在のリージョンを表示します
  • IotSettings set uilanguage language\_tag - (e.g. fr-CA) では、既定の UI 言語をフランス語 (カナダ) に設定します
  • IotSettings set speechlanguage language\_tag - (e.g. fr-CA) では、音声認識の言語をフランス語 (カナダ) に設定します
  • IotSettings set region region\_code - (e.g. CA) では、既定のリージョンをカナダに設定します)
  • IotSettings set bluetoothpref {sink | source} では、IOT_BLUETOOTH_A2DP_SOURCE 機能と IOT_BLUETOOTH_A2DP_SINK 機能の両方でビルドされたデバイスが両方のルールをサポートする別のデバイスに接続するときに選択する、Bluetooth のルールの設定を指定します。
  • IotSettings get bluetoothpref では、IOT_BLUETOOTH_A2DP_SOURCE と IOT_BLUETOOTH_A2DP_SINK の両方でビルドされたデバイスの現在の Bluetooth のロール設定を返します。 既定値は source です。

ヒント

IoTSettings -list uiLanguage では、サポートされている UI 言語のリストを返します (実行対象となった Windows IoT コア イメージのバージョンで)

既定のオーディオ デバイスとボリュームを変更する

IoTCoreAudioControlTool ツールでは、既定のキャプチャ デバイスと再生デバイスの設定やボリュームの変更など、オーディオ関連のオプションを制御します。 パラメーターの完全な一覧を表示するには、IoTCoreAudioControlTool h を実行します。

を手動でインストールします。APPX ファイル

DeployAppx を使用すると、開発シナリオで .APPX パッケージをインストールおよび削除できます。 実稼働イメージに .APPX パッケージをインストールする正しい方法は、アプリのインストールの件名に記載されているプロビジョニング パッケージを使用することです。 DeployAppx は、.APPX パッケージ情報のクエリもサポートしています。

  • DeployAppx install MyApp.appx では、.APPX と、見つかった場合は同じ名前の証明書をインストールします。
  • DeployAppx install force MyApp.appx では、新しい .APPX をインストールする前に、現在インストールされている .APPX が見つかった場合、同じパッケージ名で強制的にアンインストールします。 これは、現在インストールされている .APPX と同じかそれ以下のバージョン番号で .APPX をインストールする場合に便利です。
  • DeployAppx install retry MyApp.appx では、失敗時に .APPX のインストールを 10 回再試行します。試行の間隔は 2 秒です。
  • DeployAppx uninstall App_1.0.1.0_x86__publisherid123 では、一致するパッケージのフル ネームで .appx をアンインストールします。
  • DeployAppx uninstall MyApp.appx では、パッケージ ファミリ名が一致するインストール済みの .APPX をアンインストールします。
  • DeployAppx getpackages では、インストールされているパッケージのフル ネームを一覧表示します。
  • DeployAppx getpackageid IotCoreDefaultApp.appx では、.APPX のパッケージ名、パッケージ ファミリ名、およびパッケージのフル ネームを出力します。
DeployAppx getpackageid IotCoreDefaultApp.appx
         Package Name: 16454Windows10IOTCore.IOTCoreDefaultApplication
  Package Family Name: 16454Windows10IOTCore.IOTCoreDefaultApplication_rz84sjny4rf58
    Package Full Name: 16454Windows10IOTCore.IOTCoreDefaultApplication_2.0.8.0_arm__rz84sjny4rf58
  • DeployAppx register appxmanifest.xml はサポートされていません

一般的なコマンド ライン ユーティリティ

アカウント パスワードの更新

管理者アカウントの既定のパスワードを更新することを強くお勧めします。 これを行うには、次のコマンドを実行できます。net user Administrator [new password] ここで、[new password] は選択した強力なパスワードを表します。

ローカル ユーザー アカウントを作成します。

他のユーザーに Windows IoT Core デバイスへのアクセスを許可する場合は、net user [username] [password] /add と入力して、PS を使用して追加のローカル ユーザー アカウントを作成できます。 このユーザーを管理者グループなどの他のグループに追加する場合は、net localgroup Administrators [username] /add を使用します。

パスワードの設定

デバイス上のアカウントのパスワードを変更するには、net user [account-username] [new-password] を実行してアカウントのパスワードを変更します。

デバイス名のクエリと設定

現在のデバイス名を特定するには、hostname と入力します。 Windows IoT Core デバイスの名前を変更するには、SetComputerName [new machinename] と入力します。 名前の変更を有効にするには、デバイスの再起動が必要になる場合があります。

基本的なネットワーク構成

ping.exe、netstat.exe、netsh.exe、ipconfig.exe、tracert.exe、arp.exe などのコマンドを含む、既に使い慣れている基本的なネットワーク構成ユーティリティの多くは、Windows IoT Core で使用できます。

コピー ユーティリティ

Microsoft では、sfpcopy.exe や xcopy.exe などの使い慣れたツールを提供しています。

プロセス管理

現在実行中のプロセスを表示するには、get-process または tlist.exe のいずれかを試すことができます。 実行中のプロセスを停止するには、kill.exe [pid or process name] と入力します。

ブート オプションの設定 (ヘッドレスブートとヘッドブート)

Windows IoT Core デバイスは、ヘッド付き (ディスプレイ機能が必要な場合) またはヘッドレス (ディスプレイが不要または使用不可の場合) デバイス モードに設定できます。 この設定を変更するには、setbootoption.exe [headed | headless] を使用します。

注意

この設定を変更した場合、変更を有効にするには再起動が必要です。

タスク スケジューラ

スケジュールされたタスクの現在の一覧を表示するには、schtasks.exe コマンドを使用します。 /create スイッチを使用して新しいタスクを作成することも、/run スイッチを使用してオンデマンド タスクを実行することもできます。 サポートされているパラメーターの完全な一覧については、schtasks.exe /? を使用します

デバイス ドライバー

デバイス コンソール ユーティリティは、インストールされているデバイスとドライバーを識別および管理するのに役立ちます。 パラメーターの完全な一覧を表示するには、devcon.exe /? を使用します

レジストリへのアクセス

レジストリにアクセスして設定を表示または変更する必要がある場合は、reg.exe /? コマンドを使用して、サポートされているパラメーターの完全な一覧を参照してください。

サービス

Windows サービスの管理は、net.exe コマンドを使用して行うことができます。 実行中のサービスの一覧を表示するには、net start と入力します。 特定のサービスを開始または停止するには、net [start | stop] [service name] と入力します。 または、sc.exe コマンドでサービス コントロール マネージャーを使用することもできます。

ブート構成

Windows IoT Core デバイスのブート構成を変更するには、bcdedit.exe を使用します。 たとえば、bcdedit –set testsigning on コマンドを使用して testsigning を有効にすることができます。

デバイスのシャットダウン/再起動

デバイスをシャットダウンするには、shutdown /s /t 0 と入力します。 デバイスを再起動するには、コマンド shutdown /r /t 0 ではなく /r スイッチを使用します。

表示設定の表示と変更

SetDisplayResolution ツールを使用すると、現在の表示設定を一覧表示したり、サポートされている値の一覧を表示したりできます。 さらに、プラットフォームでサポートされている値に対して、ディスプレイの解像度、リフレッシュレート、向きを調整できます。 ユーティリティは、次のコマンド ライン引数を受け入れます。

  • SetDisplayResolution 現在の画面の解像度を一覧表示します。
  • SetDisplayResolution -list サポートされている画面の解像度を一覧表示します。
  • SetDisplayResolution -orientation:[n] 表示の向きを変更します。ここで、n=0、90、180、または 270 を指定します。
  • SetDisplayResolution [width] [height] 幅と高さをピクセル単位で変更します
  • SetDisplayResolution [width] [height] [refreshrate] 幅、高さ、リフレッシュ レートを変更します。ここで、幅と高さはピクセル単位で、リフレッシュ レートは Hz 単位です
  • SetDisplayResolution [width] [height] [refreshrate] [orientation] 幅、高さ、リフレッシュ レート、画面の向きを変更します。幅と高さはピクセル単位、リフレッシュ レートは Hz 単位、向きは 0、90、180、270 のいずれかです。

スクリーンショットを撮る

Windows IoTCore デバイスのスクリーンショットは、ScreenCapture.exe を使用して取ることができます。 たとえば、ScreenCapture c:\folder\screencap.jpg を実行すると、スクリーンショットが取られ、screencap.jpg ファイルに保存されます。

ネットワーク アダプターに関する情報を取得する

使用可能なすべてのネットワーク アダプターの一覧を表示するには、GetAdapterInfo ツールを実行します。

UWP アプリのフォルダーのアクセス許可を設定する

ユニバーサル Windows アプリからデバイス上のすべてのフォルダーにアクセスできるわけではありません。 UWP アプリからフォルダーにアクセスできるようにするには、FolderPermissions ツールを使用します。 たとえば、UWP アプリに c:\test フォルダーへのアクセス権を付与するには、FolderPermissions c:\test -e を実行します。 これは、たとえば、CreateFile2 などのネイティブの Win32 API でのみ機能することに注意してください。 StorageFolder や StorageFile などの WinRT API では使用できません。

シリアル ポートの操作

MinComm を使用すると、コマンド ラインからシリアル ポートを操作できます。 これは、サンプル プロジェクトとして、ms-iot サンプル リポジトリに用意されています。

Usage: MinComm.exe [-list] device_path [baud=<B>] [parity=<P>] [data=<D>] [stop=<S>] [xon={on|off}] [odsr={on|off}] [octs={on|off}] [dtr={on|off|hs}] [rts={on|off|hs|tg}] [idsr={on|off}]

  -list                List all available serial ports on the system and exit.
  device_path          Device path or COM port to open (e.g. COM1)
  baud=<B>             Specifies the transmission rate in bits per second.
  parity={n|e|o|m|s}   Specifies how the system uses the parity bit to check
                       for transmission errors. The abbreviations stand for
                       none, even, odd, mark, and space.
  data={5|6|7|8}       Specifies the number of data bits in a character.
  stop={1|1.5|2}       Specifies the number of stop bits that define the end of
                       a character.
  xon={on|off}         Specifies whether the xon or xoff protocol for data-flow
                       control is on or off.
  odsr={on|off}        Specifies whether output handshaking that uses the
                       Data Set Ready (DSR) circuit is on or off.
  octs={on|off}        Specifies whether output handshaking that uses the
                       Clear To Send (CTS) circuit is on or off.
  dtr={on|off|hs}      Specifies whether the Data Terminal Ready (DTR) circuit
                       is on or off or set to handshake.
  rts={on|off|hs|tg}   Specifies whether the Request To Send (RTS) circuit is
                       set to on, off, handshake, or toggle.
  idsr={on|off}        Specifies whether the DSR circuit sensitivity is on
                       or off.

Parameters that are not specified will default to the port's current
configuration. For more information on the connection parameters, see the
Technet documentation for the Mode command:
  https://technet.microsoft.com/library/cc732236.aspx

Examples:
  Connect to the first serial port found in the port's current configuration:
    MinComm.exe

  List all serial ports on the system:
    MinComm.exe -list

  Open COM1 in 115200 8N1 configuration:
    MinComm.exe COM1 baud=115200 parity=n data=8 stop=1

  Open COM1 in 115200 8N1 configuration:
    MinComm.exe \\.\COM1 baud=115200 parity=n data=8 stop=1

  Open device interface in 115200 8N1 configuration:
    MinComm.exe \\?\USB#VID_FFFF&PID_0005#{86e0d1e0-8089-11d0-9ce4-08003e301f73} baud=115200 parity=n data=8 stop=1