显示设备信息

Azure Sphere 租户可以包含数千台设备，管理设备需要一种方法来获取每个设备的详细信息。 使用 CLI 命令，可以列出有关租户中的设备、产品和设备组的信息。 还可以将命令的标准输出重定向到文件进行详细审阅。

还可以使用 CLI 命令下载诊断和配置信息、有关错误的数据以及影响设备的其他事件。

重定向或分页结果

Azure Sphere 命令行接口 (CLI) 提供了以下命令，用于列出有关租户中的设备、产品和设备组的信息。

• azsphere device-group 设备列表 显示特定设备组中的所有设备。
• azsphere 设备列表 显示租户中的所有设备。
• azsphere product 设备列表 显示产品中的所有设备。

这些命令可以返回可重定向或分页的项的大型列表。 本部分介绍从这两个 CLI 重定向或分页输出的不同方法。

Azure Sphere CLI

Azure Sphere CLI 不支持交互式分页。 但是，可以通过管道连接到现有分页工具来对屏幕上的输出进行分页。

例如：

• 在 PowerShell (Windows) 中： azsphere device list | Out-Host –Paging
• 在命令提示符处 (Windows) ： azsphere device list | more
• 在 Bash shell (Linux) 中： azsphere device list | less

注意

此操作可能会很慢，具体取决于返回的数据量。

还可以将命令的标准输出重定向到文件。 在以下示例中，标准输出发送到 output.txt 标准错误将发送到 logs.txt。

azsphere device list --verbose > output.txt 2> logs.txt

Azure Sphere 经典 CLI

这些命令的默认操作是一次返回一页记录，其中页面大小通常设置为 100 条记录。 每页结果的底部都显示一条消息，可按任意键继续显示下一页结果。 页面大小根据数据库活动和可用网络带宽等因素自动调整。

可以通过指定参数的路径和文件名 --output 并将 参数添加到 --noninteractive 命令，将列表命令的结果重定向到 CSV) 文件中 (逗号分隔值，以便进行深入审阅。 参数 --noninteractive 从结果中删除分页，以便在 CSV 文件中捕获整个列表，而无需在每个页面的末尾手动继续。

显示支持信息

用于获取支持信息的命令将取决于你是在与 Microsoft 支持人员合作时收集单个 Azure Sphere 设备的客户支持数据，还是返回有关在租户内设备上运行的应用程序的错误情况的数据。 在大多数情况下，你将使用 azsphere tenant download-error-report 命令在所有设备上查询租户中的错误情况。 此方法将依赖于 Azure Sphere 安全服务通过 Internet 连接与设备的通信来收集匹配事件。

get-support-data

azsphere get-support-data 命令从计算机、云和附加的 Azure Sphere 设备收集并生成包含诊断和配置信息的日志文件。 这些日志文件中的信息可用于帮助你或技术支持团队分析和排查问题。 --destination使用 参数可指定要在其中保存支持数据的 .zip 文件的路径和文件名。 可以提供相对路径或绝对路径。

download-error-report

azsphere tenant download-error-report 命令返回有关租户内设备报告的错误的信息。 事件数据从 Azure Sphere 安全服务云中拉取，不需要与特定设备建立物理连接。 命令在当前租户的上下文中工作，并返回该租户内所有设备的错误报告。

--destination使用 参数可指定要在其中保存支持数据的 .csv 文件的路径和文件名。 可以提供相对路径或绝对路径。