装置
管理 Azure Sphere 设备。
| 操作 | 描述 |
|---|---|
| 应用程序 | 更改设备上应用程序的状态。 |
| 能力 | 管理设备功能。 |
| 证书 | 管理设备证书存储。 |
| 索赔 | 向 Azure Sphere 租户声明以前未认领的设备。 |
| enable-cloud-test | 设置设备以禁用调试和接收更新。 |
| enable-development | 设置设备进行本地调试。 |
| 图像 | 管理设备的映像。 |
| 列表 | 显示租户中的所有设备。 |
| list-attached | Lists连接的设备。 |
| manufacturing-state | 管理附加设备的制造状态。 |
| 网络 | 提供有关设备上网络接口状态的信息。 |
| 恢复 | 使用特殊恢复模式将新固件加载到设备上。 |
| rescan-attached | 仅 windows) 重新扫描附加设备作为故障排除辅助 (。 |
| 重新 启动 | 重启连接的设备。 |
| 显示 | 显示有关设备的更新配置的详细信息。 |
| show-attached | 从设备本身显示有关附加设备的详细信息。 |
| show-count | 显示租户中的设备总数。 |
| show-deployment-status | 显示最新部署更新的状态。 |
| show-os-version | 显示本地设备操作系统版本。 |
| sideload | 将映像加载到连接的设备上。 |
| 更新 | 通过将设备放置在特定的设备组中来汇报设备。 |
| 无线 | 管理设备的 Wi-Fi 配置。 |
应用程序
管理设备上的应用程序。
许多应用选项都需要 appDevelopment 功能，可以使用 azsphere device enable-development 获取该功能。 若要启动、停止或调试 SDK 签名的应用程序或生产签名的应用程序，设备必须具有 appDevelopment 功能。
可以使用 azsphere device app stop 和 azsphere device app start 重启运行中支持实时的应用程序，以确定它运行的实时核心。
| 操作 | 描述 |
|---|---|
| show-memory-stats | 显示附加设备上的应用程序的内存统计信息。 |
| show-quota | 显示设备上当前应用程序使用的存储量。 |
| show-status | 返回设备上当前应用程序的状态。 |
| 开始 | 启动设备上加载的应用程序。 |
| 停止 | 停止在设备上运行的应用程序。 |
app show-memory-stats
显示附加设备上的应用程序的内存统计信息。 仅当配置 了 appDevelopment 设备功能时，此命令才可用。 如果配置 了堆内存分配跟踪 ，则会显示其他信息。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device app show-memory-stats
-------------- -------------
Name Usage (bytes)
============================
Total 434176
User Mode 147456
Peak User Mode 147456
-------------- -------------
app show-quota
显示附加设备上分配和使用中的可变存储量。
在应用程序清单中设置可变存储配额，Azure Sphere OS 在为文件分配扇区时强制实施配额。 因此，如果减小 MutableStorage 该值，则使用的存储量不会更改，但报告的分配值会有所不同。 例如，如果应用程序已使用 16 KB，并且将值更改为 MutableStorage 8 KB，则命令将报告应用程序使用分配的 16 KB（共 8 KB）。 数据保留在设备上。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -i、--component-id | Guid | 指定要获取其配额信息的组件的 ID。 如果省略，则显示所有组件的配额信息。 |
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device app show-quota
ae4714aa-03aa-492b-9663-962f966a9cc3: 0KB out of 8KB of mutable storage used.
app show-status
显示设备上的应用程序的当前状态。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -i、--component-id | Guid | 指定要显示其状态的组件的 ID。 如果省略，则显示所有组件的状态。 |
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device app show-status
9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
App state: running
应用启动
在设备上启动应用程序。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| --debug-mode | 布尔 | 启动应用程序进行调试。 --component-id必须提供 。 |
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| -i、--component-id | Guid | 指定要启动的组件的 ID。 如果省略，则启动所有应用程序。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device app start
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: running
Core : High-level
应用停止
停止设备上的应用程序。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -i、--component-id | Guid | 指定要停止的组件的 ID。 如果省略，则停止所有应用程序。 |
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped
能力
管理设备功能。 设备功能确定可在单个 Azure Sphere 设备上执行的操作。
设备功能使用 azsphere device capability download 命令作为文件从 Azure Sphere 安全服务下载。 可以使用 azsphere device capability update 命令将设备功能配置应用于附加的 Azure Sphere 设备，并使用 azsphere device capability select 命令创建维护会话。 有关设备功能的详细信息，请参阅 设备功能和通信。
| 操作 | 描述 |
|---|---|
| 下载 | 从 Azure Sphere 安全服务下载设备功能配置。 |
| 选择 | 选择要用于服务会话的下载功能文件。 |
| show-attached | 显示附加设备的功能配置。 |
| 更新 | 将设备功能配置应用于附加的设备。 |
功能下载
从 Azure Sphere 安全服务下载设备功能。
appDevelopment 功能允许旁加载 SDK 签名的应用程序，并在设备上启动、停止、调试或删除任何应用程序。 如果没有 appDevelopment 功能，只能加载云加载的应用程序，并禁止启动、停止、调试和删除。 appDevelopment 功能作为 azsphere device enable-development 命令的一部分应用。
下载 fieldServicing 功能会生成一个文件，其中包含单个 Azure Sphere 设备的功能。 fieldServicing 功能文件将下载到本地计算机，可与 azsphere device capability select 命令结合使用。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| --类型 | 功能类型 | 指定要下载的设备功能的类型。 值为 appDevelopment、 fieldServicing 或 none。 使用 none 可删除 appDevelopment 功能或 fieldServicing 功能。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定要运行命令的设备。 当附加了多个设备或未附加任何设备时，此参数是必需的。 默认使用当前附加的设备。 可以为未附加设备提供设备 ID，也可以指定附加设备的 IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| --目的地 | 字符串 | 指定要保存功能配置的路径和文件名。 包括绝对路径或相对路径。 如果未提供路径，该命令将使用命名约定<功能键入>< device ID.cap> 的前 8 个字符将文件存储在本地目录中。 |
| -t、--tenant | GUID 或名称 | 指定要在中执行此操作的租户。 重写默认所选租户。 可以指定租户 ID 或租户名称。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device capability download --type appDevelopment
The appdevelopment capability was saved as:
--------------------------------------------
Result
============================================
C:\capability-file\appdevelopment-<first eight characters of device ID>.cap
--------------------------------------------
功能选择
选择要与附加的 Azure Sphere 设备一起使用的功能文件。
azsphere device capability select 命令可与任何功能一起使用，但最常与 fieldServicing 功能一起使用，以启用服务会话。 任何用户角色都有权访问 azsphere device capability select 命令。
使用 fieldServicing 功能时，Azure Sphere 设备和包含功能文件的本地计算机之间将启用通信。 fieldServicing 功能文件用于本地计算机与 Azure Sphere 设备之间的会话，会话中的每个命令在前面附加一条消息，指示正在使用的功能文件。
若要结束服务会话，请使用 azsphere 设备功能，选择 --none。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| --capability-file | 字符串 | 指定要选择的设备功能配置文件的路径和文件名。 可以提供相对路径或绝对路径。 |
| -n、--none | - | 清除以前选择的任何设备功能配置。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device capability select --capability-file appdevcap
The capability session uses C:\capability-file\appdevcap.
功能 show-attached
显示附加设备上存储的功能配置。
注意
命令显示使用功能文件配置的功能，以及板上默认存在的部分（但不是全部）功能。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device capability show-attached
--------------------
DeviceCapabilities
====================
EnableFieldServicing
--------------------
azsphere device capability show-attached
--------------------
DeviceCapabilities
====================
EnableAppDevelopment
--------------------
功能更新
将设备功能配置应用于附加的设备。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| --capability-file | 字符串 | 指定要应用的设备功能文件的路径和文件名。 可以提供相对路径或绝对路径。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定要运行命令的设备。 当附加了多个设备或未附加任何设备时，此参数是必需的。 默认使用当前附加的设备。 可以为未附加设备提供设备 ID，也可以指定附加设备的 IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device capability update --capability-file appdevcap.bin
Using selected capability file: C:\capability-file\appdevcap.bin
The capability file C:\capability-file\appdevcap.bin was added on the device. The device will restart.
证书
管理附加设备上的证书。
| 操作 | 描述 |
|---|---|
| 添加 | 将证书添加到附加设备上的证书存储。 |
| 删除 | 从附加设备的证书存储中删除证书。 |
| 列表 | Lists附加设备的证书存储中可用的证书 ID。 |
| 显示 | 在附加设备的证书存储中显示证书的详细信息。 |
| show-quota | 显示附加设备的证书存储中的可用空间。 |
证书添加
将证书添加到附加设备的证书存储。
根 CA 和客户端证书必须采用 .pem 格式才能加载到 Azure Sphere 设备。 需要从相应的服务器获取根 CA 证书，以及客户端证书和私钥 (以及设备的私钥) （可选）的密码。 每个证书必须由 EAP-TLS 网络中相应的服务器生成和签名。 网络管理员或安全团队可以提供获取证书所需的详细信息。 有关获取根 CA 证书的详细信息，请参阅 获取和部署 EAP-TLS 网络的证书。
谨慎
由于证书 ID 在系统范围内适用于客户端和根 CA 证书，因此添加新证书的 azsphere 命令或函数调用可能会覆盖由早期命令或函数调用添加的证书，从而导致网络连接失败。 强烈建议你制定明确的证书更新过程，并仔细选择证书 ID。
有关详细信息 ，请参阅证书 ID 。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -i、--cert-id | 字符串 | 指定要添加的证书的标识符。 字符串标识符 (最多 16 个字符) 。 有效字符包括 A-Z) (大写字母、a-z) (小写字母、数字 (0-9) 、下划线 (_) 、句点 (.) 和连字符 (-) 。 此标识符还用于 EAP-TLS 网络的 Wi-Fi 配置。 |
| --cert-type | 字符串 | 指定要添加的证书类型（客户端或 rootca）。 |
| -p、--public-key-file | 字符串 | 指定公钥证书 .pem 文件的路径。 可以提供相对路径或绝对路径。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| --private-key-file | 字符串 | 指定客户端私钥证书 .pem 文件的路径。 添加客户端类型的证书时是必需的。 可以提供相对路径或绝对路径。 |
| -w、 --private-key-password | 字符串 | 指定客户端私钥的可选密码。 添加加密的客户端证书私钥时，需要密码。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device certificate add --cert-id certroot --cert-type rootca --public-key-file publiccert.pem
Certificate 'certroot' successfully added.
azsphere device certificate add --cert-id certclient --cert-type client --private-key-file privatekey.pem --private-key-password 1234 --public-key-file publiccert.pem
Certificate 'certclient' successfully added.
证书删除
从附加设备的证书存储中删除证书。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -c、--certificate 或 --cert-id [正在停用] |
字符串 | 指定要删除的证书的标识符。 参数 --cert-id 将停用，并将在未来版本中删除。 有关详细信息，请参阅 Azure Sphere CLI 中) (停用功能的重要更改。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device certificate delete --certificate certclient
证书列表
Lists设备的证书存储中可用的证书。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device certificate list
-----------
Identifiers
===========
rootCert
-----------
证书显示
显示设备证书存储中单个证书的详细信息。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -c、--certificate 或 --cert-id [正在停用] |
字符串 | 指定要显示其详细信息的证书的标识符。 参数 --cert-id 将停用，并将在未来版本中删除。 有关详细信息，请参阅 Azure Sphere CLI 中) (停用功能的重要更改。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device certificate show --certificate certclient
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
Id StartDate EndDate SubjectName IssuerName
==========================================================================================================================
certclient 06/08/2019 19:15:48 06/08/2069 19:25:44 /DC=local/DC=azsphere/CN=azsphereca /DC=local/DC=azsphere/CN=azsphereca
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
certificate show-quota
显示附加设备的证书存储中的可用空间。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device certificate show-quota
--------------
Available space (bytes)
==============
24514
--------------
索赔
为当前 Azure Sphere 租户声明以前未认领的设备。
重要
在认领设备之前，请确保已登录到正确的 Azure Sphere 租户。 设备只能声明一次。 声明后，设备无法移动到其他租户。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定要运行命令的设备。 当附加了多个设备或未附加任何设备时，此参数是必需的。 默认使用当前附加的设备。 可以为未附加设备提供设备 ID，也可以指定附加设备的 IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| -t、--tenant | GUID 或名称 | 指定要在中执行此操作的租户。 重写默认所选租户。 可以指定租户 ID 或租户名称。 |
| --力 | 布尔 | 强制在当前用户的所选 Azure Sphere 租户中声明设备。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device claim
warn: You are claiming a device to the following tenant:
warn: a323c263-2aa3-2559-aabb-a3fc32631900 (Tenant1)
warn: Do you want to claim the device ID 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968 to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
> yes
Claiming device.
Successfully claimed device ID '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968' into tenant 'Tenant1' with ID 'a323c263-2aa3-2559-aabb-a3fc32631900'.
enable-cloud-test
通过禁用应用程序开发、删除任何现有应用程序以及启用云加载的应用程序更新来读取附加设备以测试云加载。
它要求设备连接到电脑，并且仅在连接的设备上运行。
具体而言， enable-cloud-test：
- 删除附加设备的 appDevelopment 功能。
- 将设备分配给启用云加载的应用程序更新的设备组。
- 重新启动设备。
enable-cloud-test 执行的特定任务取决于是否已为此设备分配了产品和设备组。
如果 azsphere device enable-cloud-test 在没有参数的情况下运行，则设备将放置在设备当前产品的现场测试设备组中。 这是为每个产品自动创建的默认设备组之一，可启用应用程序更新。 如果设备没有产品，或者其中不存在现场测试设备组，则返回错误。
如果指定了产品，设备将放置在该产品的现场测试设备组中。 如果此设备组不存在，则返回错误。
如果指定了设备组，则会将设备置于其中。 如果目标设备组未启用应用程序更新，则返回错误。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| -p、--product | GUID 或名称 | 指定目标产品。 指定此项后，除非还指定，否则 --device-group 设备将移至此产品的默认现场测试设备组。 可以指定 Azure Sphere 产品的 ID 或名称。 |
| -t、--tenant | GUID 或名称 | 指定要在中执行此操作的租户。 重写默认所选租户。 可以指定租户 ID 或租户名称。 |
| -g、--device-group | GUID 或名称 | 指定要将设备移动到的设备组。 可以指定设备组 ID 或设备组名称。 若要使用设备组名称，必须以 格式提供产品名称和设备组名称 <product-name/device-group-name> 。 默认情况下，这是产品的现场测试设备组。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
示例 1. 按 ID 将设备分配到现有设备组
本示例将附加设备分配给现有产品和设备组。
azsphere device enable-cloud-test --device-group '3548b179-m16f-4f64-6dme-d3c643662e76'
Your internal capabilities will be retained, including the Enable App development capability. Sideloaded images may be removed by over-the-air application updates.
Getting device group by ID '3548b179-m16f-4f64-6dme-d3c643662e76'.
Leaving any existing applications on the device.
Setting device group to 'Field Test' with ID '3548b179-m16f-4f64-6dme-d3c643662e76')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: 'ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD')
示例 2. 将设备分配到不同的设备组
此示例与前面的示例类似，但保留设备的现有产品。 此处， enable-cloud-test 操作将更改设备所属的设备组，并删除 appDevelopment 功能。 此命令可用于将设备从未启用应用程序更新的开发环境移动到支持更新的生产环境。
azsphere device enable-cloud-test --device-group "Marketing/Field Test"
示例 3. 按产品名称分配设备
此示例启用云加载，并按名称将设备分配给产品。
azsphere device enable-cloud-test --product DW100
enable-development
通过在设备上启用旁加载和调试，并将其分配给禁用云中的应用程序更新的设备组，来启用设备进行开发。 默认情况下，这是设备产品的开发设备组，但可以指定其他设备组。 请勿在制造方案中使用。 有关详细信息 ，请参阅制造连接设备 。
具体而言， 启用开发：
- 下载并应用附加设备的 appDevelopment 功能。
- 将设备分配给不启用云加载的应用程序更新的设备组。
- 重新启动设备。
如果运行不带参数的 azsphere device enable-development 命令：
- 如果设备还没有产品或设备组，该命令将下载并应用附加设备的 appDevelopment 功能，并重新启动设备。 任何现有应用都保留在设备上，并且 OS 会更新。 声明设备的安装过程和生成高级应用程序的快速入门不受影响。
- 如果设备已有产品，该命令会将设备移动到产品的 开发 设备组。 默认情况下，会为此组禁用应用程序更新，从而确保不会覆盖旁加载的应用。
如果使用 参数运行 azsphere device enable-development 命令 --product ：
- Places产品的开发设备组中的设备。 如果此设备组不存在，则返回错误。
如果使用 参数运行 azsphere device enable-development 命令 --device-group ：
- Places指定了指定设备组中的设备。 目标设备组不得启用应用程序更新，否则将返回错误。
在某些情况下， azsphere device enable-development 会报告错误，并建议声明设备。 如果已认领设备，请使用 azsphere tenant show-selected 确保登录到在其中声明设备的租户。 如果没有，请使用 azsphere login 登录到正确的租户。 如果确定已登录到相应的租户，请使用 azsphere device 声明 来声明设备。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| -g、--device-group | GUID 或名称 | 指定要将设备移动到的设备组。 如果省略，则将设备分配给默认组。 可以指定设备组 ID 或设备组名称。 若要使用设备组名称，必须以 格式提供产品名称和设备组名称 <product-name/device-group-name> 。 |
| -r、--enable-rt-core-debugging | 布尔 | 安装调试在实时核心上运行的应用程序所需的驱动程序。 此选项需要管理员权限。 |
| -p、--product | GUID 或名称 | 指定目标产品。 指定此值时，除非还指定，否则--device-group设备将移至此产品的默认开发设备组。 可以指定 Azure Sphere 产品的 ID 或名称。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device enable-development
Capability configuration has been successfully cleared.
PS C:\Users\v-shypr> azsphere device enable-development
Getting device group 'Development' for product 'DW100'.
The device already has the 'Enable App development' capability. No changes will be applied to its existing capabilities.
Setting device group to 'Development' with ID '7f860cc1-4949-4000-a541-9a988ba4c3cd'.
Successfully disabled application updates.
Installing debugging server to device.
Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
Previous device capabilities retained. Ensure that you have the correct development capabilities installed before continuing.
Successfully set up device for application development, and disabled application updates.
(Device ID: '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968')
图像
返回有关在附加设备上安装或面向连接的设备的映像的信息。
| 操作 | 描述 |
|---|---|
| list-installed | 提供有关当前安装在附加设备上的映像的详细信息。 |
| list-targeted | 提供有关以附加设备为目标的图像的详细信息。 |
image list-installed
Lists附加设备上安装的映像。 信息列表包括组件 ID 和映像 ID。
注意
长图像名称被截断为 31 个字符。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| -f、--full | 布尔 | Lists设备上安装的所有软件映像。 默认情况下，仅列出应用程序映像、调试器和板配置映像。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device image list-installed
Installed images:
--> gdbserver
--> Image type: Application
--> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
--> Image ID: dc6205bd-4478-4c9b-81ad-5e41ac23ed68
--> CrashApplicatio
--> Image type: Application
--> Component ID: 9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
--> Image ID: cc77124e-6447-4c0f-9f99-fc0ad5ef46ef
image list-targeted
Lists已上传到 Azure Sphere 安全服务并在设备更新时安装的映像。 有关确保 Azure Sphere 设备已准备好接受基于云的应用程序更新的详细信息，请参阅 为设备启用基于云的部署。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定要运行命令的设备。 当附加了多个设备或未附加任何设备时，此参数是必需的。 默认使用当前附加的设备。 可以为未附加设备提供设备 ID，也可以指定附加设备的 IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| -t、--tenant | GUID 或名称 | 指定要在中执行此操作的租户。 重写默认所选租户。 可以指定租户 ID 或租户名称。 |
| -f、--full | 布尔 | Lists Azure Sphere 租户中的所有映像。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device image list-targeted
----------------------- ------------------------------------ ------------------------------------ ---------------- --------------------
Name ComponentId ImageId ImageType RegionalDataBoundary
=======================================================================================================================================
HelloWorld_HighLevelApp 1689d8b2-c835-2e27-27ad-e894d6d15fa9 50419cb6-a33b-4cbe-8bd0-425048664b6f Applications None
----------------------- ------------------------------------ ------------------------------------ -------------------------------------
列表
Lists租户中的所有设备。 列表在前 500 台设备之后截断。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -t、--tenant | GUID 或名称 | 指定要在中执行此操作的租户。 重写默认所选租户。 可以指定租户 ID 或租户名称。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device list
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
========================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
可以使用 --query 参数自定义为此命令显示的输出。 有关详细信息，请参阅 查询 CLI 命令输出。
以下示例演示如何仅选择“设备 ID”和“产品 ID”：
azsphere device list --query '[].{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 4f48d618-09f7-45dc-a5a4-1433cabbee91
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD 4f48d618-09f7-45dc-a5a4-1433cabbee91
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
提示
运行 azsphere product show --product <product-ID> 以查看产品名称，或者运行 azsphere device-group show --device-group <devicegroup-ID> 以查看设备组名称。
list-attached
Lists连接到本地电脑的设备。
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device list-attached
1 device attached:
--> Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
--> Is responsive: yes
--> IP address: 192.128.48.1
--> Connection path: 21143
manufacturing-state
管理附加设备的制造状态。
| 操作 | 描述 |
|---|---|
| 显示 | 显示附加设备的制造状态。 |
| 更新 | 汇报附加设备的制造状态。 |
谨慎
制造状态更改是永久性的且不可逆的。
manufacturing-state show
显示附加设备的制造状态。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device manufacturing-state show
------------------
ManufacturingState
==================
Module1Complete
------------------
manufacturing-state update
汇报附加设备的制造状态。 有关详细信息，请参阅 设置设备制造状态。
谨慎
制造状态更改是永久性的且不可逆的。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -s、--state | 制造状态 | 指定要为设备设置的制造状态。 可能的状态包括 DeviceComplete 和 Module1Complete。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device manufacturing-state update --state Module1Complete
Updating manufacturing state to Module1Complete.
Restarting device for changes to take effect.
The device was successfully restarted.
网络
提供有关附加设备上的网络接口状态的信息。
| 操作 | 描述 |
|---|---|
| 使 | 在连接的设备上启用网络接口。 |
| 禁用 | 禁用附加设备上的网络接口。 |
| list-firewall-rules | Lists附加设备的防火墙规则。 |
| list-interfaces | Lists附加设备的网络接口。 |
| 代理 | 管理网络代理设置。 |
| show-诊断 | 显示连接的设备上的一个或所有无线网络的网络诊断。 |
| show-status | 显示附加设备的网络状态。 |
| update-interface | 汇报设备的网络接口配置。 |
网络启用
在连接的设备上启用网络接口。
注意
此命令支持用于配置以太网 eth0 和 wlan0 连接。 如果配置 lo 或 azspheresvc，则返回错误。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| --接口 | 字符串 | 指定要启用的接口。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device network enable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.
网络禁用
禁用附加设备上的网络接口。
注意
此命令支持用于配置以太网 eth0 和 wlan0 连接。 如果配置 lo 或 azspheresvc，则返回错误。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| --接口 | 字符串 | 指定要启用的接口。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device network disable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.
network list-firewall-rules
Lists附加设备的防火墙规则。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
将显示以下规则：
- 防火墙规则集名称：显示防火墙规则集块的名称。
- 值为 PREROUTING、 POSTROUTING、 INPUT、 FORWARD 和 OUTPUT。
- 规则集是否有效：显示规则集的状态。 值为 True 或 False。
- 防火墙规则集规则：显示以下规则的值：
- 源 IP：显示发送计算机的 IP 地址。
- 源掩码：显示发送计算机的网络掩码。
- 目标 IP：显示目标计算机的 IP 地址。
- 目标掩码：显示取消自定义计算机的网络掩码。
- UID：显示应用于规则的用户标识。 4294967295 (0xFFFFFFFF) 意味着没有应用 UID，因此它适用于所有人。
- 操作：显示要执行的操作。 这些值可以是 接受 值，也可以 是删除值。
- 接口 IN 名称：显示输入接口名称。 例如 wlan0。
- 接口 OUT 名称：显示输出接口名称。 例如 wlan0。
- 状态：显示连接状态。 这些值为 none、 建立的或 相关的。
- TCP 掩码：显示 TCP 掩码数组。 值为 fin、 syn、 rst、 psh、 ack 和 urg。
- TCP Cmp：显示 TCP 标志的数组。 值为 urg、 ack、 psh、 rst、 syb 和 fin。
- TCP Inv：布尔值指示应反转 TCP 标志的感知。 值为 True 或 False。
- 协议：显示防火墙规则的协议。 值为 icmp、 igmp、 tcp、 udp。
- 源端口范围：显示来自发送流量的源的端口范围。 该值可以介于 0 和 65535 之间。
- 目标端口范围：显示接收流量的目标上的端口范围。 该值可以介于 0 和 65535 之间。
- 数据包：显示数据包数。
- 字节数：显示字节数。
下面列出了这些标志的简要摘要：
- URG：紧急指针字段重要
- ACK：确认字段显著
- PSH：Push 函数
- RST：重置连接
- SYN：同步序列号
- FIN：不再有来自发送方的数据
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device network list-firewall-rules
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
Ruleset IsValid SourceIp SourceMask DestinationIp DestinationMask UID Action InterfaceInName TcpInv Protocol SourcePortRange DestinationPortRange Packets Bytes TcpMask TcpCmp
=====================================================================================================================================================================================================
PREROUTING False None None None None None None None None None None None None None None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False any 0-65535 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept True tcp 0-65535 0-65535 823 394754 syn,ack syn
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True 192.168.35.1 <value> <value> <value> <value> accept azspheresvc False any 0-65535 0-65535 15 780 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
INPUT True <value> <value> <value> <value> <value> accept False udp 53-53 0-65535 0 0 None None
----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
network list-interfaces
Lists附加设备的网络接口。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device network list-interfaces
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
InterfaceName InterfaceUp ConnectedToNetwork IpAcquired IpAddresses ConnectedToInternet IpAssignment HardwareAddress
========================================================================================================================
azspheresvc True False False <value> False None None
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
eth0 True True True <value> True dynamic <value>
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
lo True False False <value> False None None
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
wlan0 True True True <value> True dynamic <value>
------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
网络代理
管理用于网络连接的代理地址。 有关配置 Azure Sphere 设备以通过代理服务器连接到 Internet 的详细信息，请参阅 通过代理服务器进行连接。
注意
目前仅支持 HTTP 代理。
| 操作 | 描述 |
|---|---|
| proxy apply | 在连接的设备上配置网络代理。 |
| 代理删除 | 删除附加设备上的代理连接。 |
| proxy show | 显示附加设备上的代理连接。 |
proxy apply
在连接的设备上配置网络代理。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -a、--address | 字符串 | 指定要使用的代理的网络地址。 |
| -t、--authentication | 字符串 | 指定要使用的身份验证类型。 允许的值： anonymous 或 basic。 如果代理需要用户名和密码，请将此项设置为 basic，否则使用 anonymous。 |
| -r、--port | 整数 | 指定要在网络地址上使用的端口。 该值必须等于或小于 65535。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| --使 | 字符串 | 指定是否应启用代理。 必须设置 --enable 或 --disable。 |
| --禁用 | 字符串 | 指定是否应禁用代理。 必须设置 --enable 或 --disable。 |
| -n、 --no-proxy-addresses | 字符串 | 指定一个以空间分隔的网络地址数组，设备应避免进行代理连接。 |
| -p、--password | 字符串 | 指定代理身份验证的密码，仅用于基本身份验证。 最大长度：64 个字符。 |
| -u、 --username | 字符串 | 指定代理身份验证的用户名。 仅用于基本身份验证。 最大长度：64 个字符。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device network proxy apply --address contoso.com --authentication anonymous --port 8080 --enable
----------- ------- ----- ------------------ ----------------
Address Enabled Port AuthenticationType NoProxyAddresses
=============================================================
contoso.com True 8080 anonymous
----------- ------- ----- ------------------ ----------------
代理删除
删除附加设备上的代理连接。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device network proxy delete
proxy show
显示附加设备上的代理连接。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device network proxy show
----------- ------- ----- ------------------ ----------------
Address Enabled Port AuthenticationType NoProxyAddresses
=============================================================
contoso.com True 8080 anonymous
----------- ------- ----- ------------------ ----------------
network show-诊断
显示附加设备上的一个或所有 Wi-Fi 网络的诊断。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| -n、--network | 整数 | 指定要显示其诊断的 Wi-Fi 网络的 ID。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device network show-diagnostics
------------------------- --------- ----- ------------- --------------- --------
Timestamp NetworkId Ssid ConfigState ConnectionState Error
================================================================================
2021-06-16T20:51:29+00:00 0 <value> temp-disabled disconnected WrongKey
------------------------- --------- ----- ------------- --------------- --------
network show-status
显示附加设备的网络状态。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device network show-status
--------------------------- --------------- -----
DeviceAuthenticationIsReady NetworkTimeSync Proxy
=================================================
True complete ready
--------------------------- --------------- -----
network update-interface
汇报设备的以太网网络接口。 有关设置设备的 MAC 地址的详细信息，请参阅 为以太网配置设备。
注意
此命令支持用于配置以太网 eth0 连接。 如果配置 lo、 或 wlan0，azspheresvc则返回错误。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| --hardware-address | 字符串 | 以以下格式之一指定要为设备设置的硬件地址： AA:BB:33:DD:EE:FF 或 aa:bb:33:dd:ee:ff。 |
| --接口 或 --interface-name [正在停用] |
字符串 | 指定要配置的接口的名称。 运行 azsphere device network list-interfaces 以查看附加设备的网络接口的详细信息。 参数 --interface-name 将停用，并将在未来版本中删除。 有关详细信息，请参阅 Azure Sphere CLI 中) (停用功能的重要更改。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device network update-interface --interface eth0 --hardware-address ba:98:76:54:32:10
恢复
替换设备上的系统软件。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定要在附加多个设备时运行命令的设备。 默认使用当前附加的设备。 指定设备的 ID、IP 地址或本地连接 ID。 |
| -c、--capability | 字符串 | 指定要在恢复期间应用于设备的设备功能映像。 |
| -i、--images | 字符串 | 指定包含要写入设备的图像包的文件夹的路径。 默认情况下，除非此标志提供了备用路径，否则恢复将使用 SDK 中的映像。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
示例 1：
azsphere device recover
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5443272 bytes to send)
Sent 1 of 17 images. (5440896 of 5443272 bytes remaining)
Sent 2 of 17 images. (5414844 of 5443272 bytes remaining)
Sent 3 of 17 images. (5311892 of 5443272 bytes remaining)
Sent 4 of 17 images. (5311500 of 5443272 bytes remaining)
Sent 5 of 17 images. (5041520 of 5443272 bytes remaining)
Sent 6 of 17 images. (5024908 of 5443272 bytes remaining)
Sent 7 of 17 images. (4994856 of 5443272 bytes remaining)
Sent 8 of 17 images. (2397456 of 5443272 bytes remaining)
Sent 9 of 17 images. (885796 of 5443272 bytes remaining)
Sent 10 of 17 images. (861220 of 5443272 bytes remaining)
Sent 11 of 17 images. (758608 of 5443272 bytes remaining)
Sent 12 of 17 images. (135796 of 5443272 bytes remaining)
Sent 13 of 17 images. (70048 of 5443272 bytes remaining)
Sent 14 of 17 images. (41164 of 5443272 bytes remaining)
Sent 15 of 17 images. (32768 of 5443272 bytes remaining)
Sent 16 of 17 images. (16384 of 5443272 bytes remaining)
Sent 17 of 17 images. (0 of 5443272 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.
示例 2：
azsphere device recover --capability "C:\Users\capability file\capability_352FE1F_5.bin"
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 16 images. (5474668 bytes to send)
Sent 1 of 16 images. (5447384 of 5474668 bytes remaining)
Sent 2 of 16 images. (5343788 of 5474668 bytes remaining)
Sent 3 of 16 images. (5343396 of 5474668 bytes remaining)
Sent 4 of 16 images. (5073416 of 5474668 bytes remaining)
Sent 5 of 16 images. (5056612 of 5474668 bytes remaining)
Sent 6 of 16 images. (5026240 of 5474668 bytes remaining)
Sent 7 of 16 images. (2479376 of 5474668 bytes remaining)
Sent 8 of 16 images. (889892 of 5474668 bytes remaining)
Sent 9 of 16 images. (865316 of 5474668 bytes remaining)
Sent 10 of 16 images. (754512 of 5474668 bytes remaining)
Sent 11 of 16 images. (135796 of 5474668 bytes remaining)
Sent 12 of 16 images. (70048 of 5474668 bytes remaining)
Sent 13 of 16 images. (41164 of 5474668 bytes remaining)
Sent 14 of 16 images. (32768 of 5474668 bytes remaining)
Sent 15 of 16 images. (16384 of 5474668 bytes remaining)
Sent 16 of 16 images. (0 of 5474668 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.
rescan-attached
通过重启其所有 FTDI 端口来重新扫描连接的设备，并显示附加设备的总计数。 在 Windows 上排查设备连接问题 时使用此命令。 此命令仅在 Windows 上运行。
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device rescan-attached
-----------
Count
===========
2
-----------
重新 启动
重启连接的设备。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device restart
Restarting device.
Device restarted successfully.
显示
显示 Azure Sphere 租户中附加设备的详细信息。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定要运行命令的设备。 当附加了多个设备或未附加任何设备时，此参数是必需的。 默认使用当前附加的设备。 可以为未附加设备提供设备 ID，也可以指定附加设备的 IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| -t、--tenant | GUID 或名称 | 指定要在中执行此操作的租户。 重写默认所选租户。 可以指定租户 ID 或租户名称。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device show
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
========================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
可以使用 --query 参数自定义为此命令显示的输出。 有关详细信息，请参阅 查询 CLI 命令输出。
以下示例演示如何仅选择“设备 ID”和“产品 ID”：
azsphere device show --device 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 --query '{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
show-attached
显示来自设备本身的附加设备的信息。 这些详细信息与 Azure Sphere 安全服务为设备存储的详细信息不同。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device show-attached
Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
IP address: 192.128.48.1
Connection path: 21143
show-deployment-status
显示设备的应用程序和操作系统更新的部署状态。
使用此命令可了解设备运行的 Azure Sphere OS 版本或当前部署更新是否已完成。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| -t、--tenant | GUID 或名称 | 指定要在中执行此操作的租户。 重写默认所选租户。 可以指定租户 ID 或租户名称。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device show-deployment-status
Your device is running Azure Sphere OS version <version-number>.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version <version-number>.
Your device has the expected version of the Azure Sphere OS: <version-number>.
在此示例中， <版本号> 表示当前操作系统版本。
show-count
显示当前租户中的设备数。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -t、--tenant | GUID 或名称 | 指定要在中执行此操作的租户。 重写默认所选租户。 可以指定租户 ID 或租户名称。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device show-count
------
Result
======
2
------
show-os-version
显示附加设备上的当前操作系统版本。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device show-os-version
Your device is running Azure Sphere OS version <version-number>
在此示例中， <版本号> 表示当前操作系统版本。
sideload
管理设备上的应用程序。
设备处于生产状态 DeviceComplete 后，某些旁加载选项需要其他功能。 通过 fieldServicing 功能，可以部署和删除临时生产签名的映像，并部署永久的生产签名映像。 appDevelopment 功能允许部署和删除生产签名映像和 SDK 签名映像。
| 操作 | 描述 |
|---|---|
| 删除 | 从设备中删除当前应用程序。 |
| 部署 | 将应用程序加载到设备上。 |
| set-deployment-timeout | 设置部署超时期限（以秒为单位）。 |
| show-deployment-timeout | 显示部署超时期限（以秒为单位）。 |
请注意，、 stopshow-status和 show-quota 的参数start已移动到 azsphere device app 命令。
sideload delete
从设备中删除应用程序。
仅当配置 了 appDevelopment 设备功能时，此命令才可用。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -i、--component-id | Guid | 指定要从设备中删除的应用程序的 ID。 如果省略，则删除所有应用程序。 |
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.
sideload deploy
将应用程序加载到连接的设备上并启动该应用程序。
如果应用程序清单请求设备上的应用程序正在使用的资源，则此命令将失败。 在这种情况下，请使用 azsphere device sideload delete 删除现有应用程序，然后再次尝试旁加载。 azsphere device sideload delete 命令删除高级应用程序和实时应用程序。 若要删除一个应用程序并保留另一个应用程序，请指定要删除的应用程序的组件 ID。
同一命令用于部署高级应用程序和支持实时的应用程序。
注意
安装使用外围设备的新应用程序并满足以下条件时，将触发设备重启：
- 设备的制造状态设置为 DeviceComplete。
- 设备上不存在 appDevelopment 功能。 有关详细信息，请参阅 外围设备配置锁定。
如果启动设备重新启动，请等到重新启动完成且设备响应迅速。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -p、--image-package | 字符串 | 指定要在设备上加载的映像包的路径和文件名。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| -m、--manual-start | 布尔 | 指定在加载应用程序后不自动启动应用程序。 |
| --力 | 布尔 | 强制部署使用可能不再受支持的 Beta API 的映像。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
Deploying 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' to the attached device.
Image package 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' has been deployed to the attached device.
sideload set-deployment-timeout
设置在设备上旁加载映像的部署超时值（以秒为单位）。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -v、--value | 整数 | 指定旁加载命令超时之前的持续时间（以秒为单位）。该值必须是正整数。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device sideload set-deployment-timeout --value 60
------------------
Deployment timeout
==================
60
------------------
旁加载 show-deployment-timeout
显示设备上旁加载映像的当前部署超时值（以秒为单位）。
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device sideload show-deployment-timeout
------------------
Deployment timeout
==================
60
------------------
更新
将设备移到 Azure Sphere 租户中的其他设备组中。
除了在产品中创建的设备组外，创建产品时还会添加五个默认设备组：
- 开发：仅接受系统软件更新。 不接受应用程序更新。
- 现场测试：接受来自 Azure Sphere 安全服务的所有更新。
- 生产：接受来自 Azure Sphere 安全服务的所有更新。
- 生产 OS 评估：接受来自 Azure Sphere 安全服务的所有更新。
- 现场测试 OS 评估：接受来自 Azure Sphere 安全服务的所有更新。
有关部署中涉及的基本元素的详细信息，请参阅 部署基础知识。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -g、--device-group | GUID 或名称 | 指定要在其中移动设备的设备组。 可以指定设备组 ID 或设备组名称。 若要使用设备组名称，必须以 格式提供产品名称和设备组名称 <product-name/device-group-name> 。 |
| -d、--device | 字符串 | 指定要运行命令的设备。 当附加了多个设备或未附加任何设备时，此参数是必需的。 默认使用当前附加的设备。 可以为未附加设备提供设备 ID，也可以指定附加设备的 IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| -t、--tenant | GUID 或名称 | 指定要在中执行此操作的租户。 重写默认所选租户。 可以指定租户 ID 或租户名称。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device update --device-group AW100/Marketing
------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
DeviceId TenantId ChipSku ProductId DeviceGroupId
==============================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
427D205E46A166B7E41135EB968
------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
可以使用 --query 参数自定义为此命令显示的输出。 有关详细信息，请参阅 查询 CLI 命令输出。
以下示例演示如何仅选择“设备 ID”和“产品 ID”：
azsphere device update --device-group AW100/Marketing --query '{DeviceId:deviceId, ProductId:productId}'
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
DeviceId ProductId
=====================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
无线
管理附加设备的 Wi-Fi 配置。
若要在 Wi-Fi 网络上使用设备，必须添加有关网络的信息并在设备上启用网络。 尽管可以在 SSSID 中输入非 ASCII 字符，但 azsphere 无法正确显示它们。
如果应用程序使用 Wi-Fi 配置 API，则还必须在应用程序的 app_manifest.json 文件中包括 WifiConfig 功能。
| 操作 | 描述 |
|---|---|
| 添加 | 将无线网络的详细信息添加到设备。 |
| 禁用 | 禁用设备上的无线网络。 |
| 使 | 在设备上启用无线网络。 |
| 忘记 | 从设备中删除无线网络的详细信息。 |
| 列表 | Lists设备的当前 Wi-Fi 配置。 |
| reload-config | 重新加载设备 Wi-Fi 配置。 |
| 扫描 | 扫描可用网络。 |
| 显示 | 显示 Wi-Fi 配置的详细信息。 |
| show-status | 显示无线接口的状态。 |
wifi add
将 Wi-Fi 网络的详细信息添加到附加的设备。
一个设备可以有多个 Wi-Fi 连接。 尽管可以在 SSSID 中输入非 ASCII 字符，但 azsphere 无法正确显示它们。
可以包含 --targeted-scan 参数以连接到隐藏的 SSD。 有关详细信息，请参阅 将 Azure Sphere 连接到 Wi-Fi。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -s、--ssid | 字符串 | 指定网络的 SSID。 网络 SSD 区分大小写。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| --client-cert-id | 字符串 | [EAP-TLS]指定标识符 (最多 16 个字符，) 标识包含公钥和私钥) 的客户端证书 (。 设置 EAP-TLS 网络所必需的。 |
| --client-id <user@domain> | 字符串 | [EAP-TLS]指定网络 RADIUS 服务器识别的身份验证 ID。 对于某些 EAP-TLS 网络是必需的。 |
| --config-name | 字符串 | 指定 (最多 16 个字符的字符串，) 指定网络配置的名称。 |
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
| --root-ca-cert-id | 字符串 | [EAP-tLS]指定标识符 (最多 16 个字符，) 标识设备对服务器进行身份验证的 EAP-TLS 网络的根 CA 证书。 |
| --targeted-scan | 布尔 | 即使网络未广播或因网络拥塞而隐藏，也会尝试连接到网络。 |
| -p、--psk | 字符串 | 指定新网络的 WPA/WPA2 密钥。 省略将 SSID 添加为开放网络。 如果密钥包含与号 (&) ，请将该键括在引号中。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device wifi add --ssid MyNetwork --psk MyPassword
Successfully added network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
1 MyNetwork enabled unknown psk False
----- -------- ------------------ --------------- ------------- ------------
如果网络 SSID 或密钥具有嵌入空格或和号，请将 SSID 或键括在单引号中。 如果 SSID 或键包含引号，请使用反斜杠来转义引号。 如果反斜杠是值的一部分，则不必进行转义。 有关详细信息，请参阅 引号和转义字符。 例如：
azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"
wifi 禁用
禁用附加设备上的 Wi-Fi 网络。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -i、--id | 整数 | 指定要禁用的网络的 ID。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device wifi disable --id 0
Successfully disabled network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0 MyNetwork disabled disconnected psk False
----- -------- ------------------ --------------- ------------- ------------
wifi 启用
在附加的设备上启用 Wi-Fi 网络。
若要在两个网络范围内从一个网络更改为另一个网络，请在启用新网络之前禁用当前连接的网络。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -i、--id | 整数 | 指定要启用的网络的 ID。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device wifi enable --id 0
Successfully enabled network:
----- -------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0 MyNetwork enabled disconnected psk False
----- -------- ------------------ --------------- ------------- ------------
wifi forget
从附加设备中删除 Wi-Fi 网络的详细信息。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -i、--id | 整数 | 指定要删除的网络的 ID。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device wifi forget --id 0
Successfully forgotten network.
wifi 列表
Lists附加设备的当前 Wi-Fi 配置。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device wifi list
----- --------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
=============================================================================
0 MyNetwork1 enabled connected psk False
----- --------- ------------------ --------------- ------------- ------------
1 MyNetwork2 enabled disconnected psk False
----- --------- ------------------ --------------- ------------- ------------
2 MyNetwork3 enabled disconnected eaptls False
----- --------- ------------------ --------------- ------------- ------------
wifi reload-config
在附加设备上重新加载 Wi-Fi 网络配置。 在添加或删除 (azsphere 设备 证书) 的证书后，请使用此命令，以确保 EAP-TLS 网络使用证书存储的最新内容。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device wifi reload-config
Wi-Fi configuration was successfully reloaded.
wifi 扫描
扫描附加设备可见的可用 Wi-Fi 网络。 该命令最多返回 64 个 Wi-Fi 网络，但显示的 Wi-Fi 网络数可能会受到环境因素的限制，例如范围内的接入点密度。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device wifi scan
----------------- ------------- ----------------- ----------- ---------
SSID SecurityState BSSID SignalLevel Frequency
=======================================================================
MyNetwork0 psk <value> -66 2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork1 psk <value> -75 2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork2 psk <value> -86 2412
----------------- ------------- ----------------- ----------- ---------
wifi show
显示附加设备上 Wi-Fi 网络的详细信息。
必需参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -i、--id | 整数 | 指定要显示的网络配置的 ID。 |
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device wifi show --id 0
----- --------- ------------------ --------------- ------------- ------------
ID SSID ConfigurationState ConnectionState SecurityState TargetedScan
=============================================================================
0 MyNetwork enabled disconnected psk False
----- --------- ------------------ --------------- ------------- ------------
wifi show-status
显示附加设备上 Wi-Fi 接口的状态。
可选参数
| 参数 | 类型 | 描述 |
|---|---|---|
| -d、--device | 字符串 | 指定附加多个设备时要运行命令的设备。 附加多个设备时，此参数是必需的。 默认使用当前附加的设备。 可以指定附加设备的设备 ID、IP 地址或本地连接 ID。 Azure Sphere CLI 支持 Windows 上的多个 MT3620 设备，但 Linux 上一次只能连接一台设备。 因此，Windows 支持此参数，但 Linux 不支持此参数。 如果在 Linux 上将此参数与 命令一起使用，则返回错误。 |
全局参数
以下全局参数可用于 Azure Sphere CLI：
| 参数 | 描述 |
|---|---|
| --调试 | 增加日志记录详细程度以显示所有调试日志。 如果发现 bug，请在提交 bug 报告时提供带有 --debug 标志的生成的输出。 |
| -h、--help | 打印有关命令及其参数的 CLI 参考信息，并列出可用的子组和命令。 |
| --only-show-errors | 仅显示错误，禁止显示警告。 |
| -o、--output | 更改输出格式。 可用的输出格式包括 json、jsonc (着色 JSON) 、tsv (Tab 分隔值) 、表 (人工可读的 ASCII 表) 和 yaml。 默认情况下，CLI 输出 table。 若要详细了解可用的输出格式，请参阅 Azure Sphere CLI 命令的输出格式。 |
| --查询 | 使用 JMESPath 查询语言筛选从 Azure Sphere 安全服务返回的输出。 有关详细信息和示例，请参阅 JMESPath 教程 和 查询 Azure CLI 命令输出 。 |
| --详细 | 打印有关在操作期间在 Azure Sphere 中创建的资源的信息和其他有用信息。 用于 --debug 完整的调试日志。 |
注意
如果使用 Azure Sphere 经典 CLI，请参阅 全局参数 ，详细了解可用选项。
例子
azsphere device wifi show-status
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
SSID ConfigurationState ConnectionState SecurityState Frequency Mode KeyManagement WpaState IpAddress MacAddress
================================================================================================================================
<value> enabled connected psk 2412 station WPA2-PSK COMPLETED <value> <value>
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------