Windows 10 IoT Core 命令行实用程序

项目
04/03/2023

正在寻找可用于配置设备上的某些设置的工具？以下工具供你随意使用。在连接到你的设备后，使用 PowerShell 运行这些命令。

注意

这些工具未预先加载，你需要具有相应的功能 ID 才能在映像中获取这些工具。

特定于 IoT 核心版的命令行实用程序

设置启动应用

使用启动编辑器在你的 Windows 10 IoT Core 设备上配置启动应用。借助以下选项之一，运行 IotStartup：

IotStartup list，用于列出已安装的应用程序
IotStartup list headed，用于列出已安装的有外设应用程序
IotStartup list headless，用于列出已安装的无外设应用程序
IotStartup list [MyApp]，用于列出已安装的与模式 MyApp 匹配的应用程序
IotStartup add，用于添加有外设和无外设应用程序
IotStartup add headed [MyApp]，用于添加与模式 MyApp 匹配的有外设应用程序模式必须只匹配一个应用程序。
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 功能构建的设备连接到同时支持这两种角色的另一台设备时，要选择的蓝牙角色首选项。
IotSettings get bluetoothpref，用于返回使用 IOT_BLUETOOTH_A2DP_SOURCE 和 IOT_BLUETOOTH_A2DP_SINK 构建的设备的当前蓝牙角色首选项。默认值为 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]。你可能需要重新启动你的设备才能使更改的名称生效。

基本网络配置

Windows IoT 核心板中将提供多种基本的网络配置实用程序（包括诸如 ping.exe、netstat.exe、netsh.exe、ipconfig.exe、tracert.exe 和 arp.exe 等命令），你可能已经对这些实用程序很熟悉了。

复制实用工具

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 命令使用服务控制管理器。

启动配置

可使用 bcdedit.exe 更改 Windows IoT 核心版设备的启动配置。例如，可以使用 bcdedit –set testsigning on 命令启用测试签名。

关闭/重启设备

若要关闭设备，请键入 shutdown /s /t 0。若要重新启动该设备，请使用 /r 开关而不是 shutdown /r /t 0 命令。

查看和更改显示器设置

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。

截取屏幕截图

可以使用 ScreenCapture.exe 生成 Windows IoTCore 设备的屏幕截图。例如，运行 ScreenCapture c:\folder\screencap.jpg 将生成屏幕截图并将其保存在 screencap.jpg 文件中。

获取有关网络适配器的信息

若要查看所有可用网络适配器的列表，请运行 GetAdapterInfo 工具。

设置 UWP 应用的文件夹权限

并非设备上的所有文件夹都可供通用 Windows 应用访问。若要使文件夹可供 UWP 应用访问，可以使用 FolderPermissions 工具。例如，运行 FolderPermissions c:\test -e 即可让 UWP 应用访问 c:\test 文件夹。请注意，这仅适用于本机 Win32 API（如 CreateFile2），而不适用于 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

通过