快速入门：配置网络并更新设备 OS
声明 Azure Sphere 设备后，为其配置网络，以便它可以从 Azure Sphere 安全服务接收云更新，以及与 Azure IoT 中心等服务通信。 配置和启用网络后，设备可以从云接收 OS 更新。
重要
本主题介绍如何将 Azure Sphere 设备连接到 Wi-Fi 网络。 如果设备支持其他网络机制且不支持 Wi-Fi，请使用该机制将其连接到 Internet，然后继续执行接收设备更新步骤。
先决条件
- 安装适用于 Windows 或 Linux 的 SDK
- 快速入门：选择目录并声明设备
在 Azure Sphere 设备上设置 Wi-Fi
执行以下步骤即可在 Azure Sphere 设备上配置 Wi-Fi：
将 Azure Sphere 设备连接到计算机。
使用 PowerShell、Windows 命令提示符或 Linux 命令行界面打开命令行界面。
如果网络环境有此要求，请注册设备的 MAC 地址。 使用以下命令获取 MAC 地址，然后根据适用于环境的过程进行注册：
az sphere device wifi show-status使用 az sphere device wifi add 命令将 Wi-Fi 网络添加到设备，如下所示：
az sphere device wifi add --ssid <SSID> --psk <EXAMPLEPSK>将 SSID> 替换为<网络的名称。 网络 SSID 区分大小写。 如果 SSID 已隐藏，请添加
--targeted-scan以尝试仍然连接到它。 可以使用 az sphere device wifi scan 获取可用 Wi-Fi 网络的列表。将 EXAMPLEPSK> 替换为 <WPA/WPA2 密钥。 Azure Sphere 设备不支持 WEP。 若要添加打开的网络，请省略
--psk。如果网络 SSID 或密钥具有嵌入空格或安和号，请将 SSID 或密钥括在单引号中。 如果 SSID 或密钥包含引号，请使用反斜杠对引号进行转义。 如果反斜杠是值的一部分，则不必进行转义。 例如：
az sphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"开发板上的网络通常需要几秒钟才能准备就绪，但可能需要更长时间，具体取决于网络环境。
使用 az sphere device wifi show-status 命令检查连接的状态：
az sphere device wifi show-status在更新期间， az sphere device wifi show-status 命令可能会暂时显示未知的配置状态。 以下示例显示了安全的 WPA2 连接成功的结果：
----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- ----------------- SSID ConfigurationState ConnectionState SecurityState Frequency Mode KeyManagement WpaState IpAddress MacAddress =============================================================================================================================== <value> enabled connected psk 2412 station WPA2-PSK COMPLETED <value> <value> ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
az sphere device wifi 命令支持多个其他选项。 键入 az sphere device wifi --help for a complete list， or az sphere device wifi option --help for help on an individual option.
执行以下步骤即可在 Azure Sphere 设备上配置 Wi-Fi：
将 Azure Sphere 设备连接到计算机。
展开你感兴趣的设备的“设备”节点。
展开 Wi-Fi 节点。 会看到下面这样的内容：
展开标记为“已断开连接”的节点，应会看到设备的 MAC 地址。 如果网络环境有此要求，请注册设备的 MAC 地址。 记下右侧的刷新按钮;连接到网络后，需要查看连接信息。
如果可能，请 展开“可用网络 ”节点。 将鼠标悬停在要连接到的网络上，然后选择“连接”（这显示为节点右侧的+）。 如果网络需要预共享密钥（PSK），请在出现的文本框中键入网络密码，然后按 Enter。
返回到之前标记为“已断开连接”的节点，该节点现在应读取“已连接到：<网络>”。 如果片刻后仍然看到 “已断开连接 ”，请单击此节点上的刷新按钮以查看设备的更新连接状态。
应会看到以下信息：
- SSID
- 配置状态
- 连接状态
- 安全状态
- 频率
- 模型
- 密钥管理类型
- WPA 状态
- IP 地址
- MAC 地址
这与 CLI 命令 az sphere device wifi show-status 报告的信息相同。
还应看到已连接的网络显示在 “已保存的网络 ”节点上。
执行以下步骤即可在 Azure Sphere 设备上配置 Wi-Fi：
将 Azure Sphere 设备连接到计算机。
展开你感兴趣的设备的“设备”节点。
展开 Wi-Fi 节点。 会看到下面这样的内容：
展开标记为“已断开连接”的节点，应会看到设备的 MAC 地址。 如果网络环境有此要求，请注册设备的 MAC 地址。 记下右侧的刷新按钮;连接到网络后，需要查看连接信息。
如果可能，请展开可用网络节点。 右键单击要连接到的网络，然后选择“ 连接”。 如果网络需要预共享密钥（PSK），请在 PSK 文本框中键入网络密码，然后按 Enter。
返回到之前标记为“已断开连接”的节点，该节点现在应读取“已连接到：<网络>”。 如果片刻后仍然看到 “已断开连接 ”，请单击此节点上的刷新按钮以查看设备的更新连接状态。
应会看到以下信息：
- IP 地址
- 安全状态
- MAC 地址
- WPA 状态
- 模型
- 频率
- 密钥管理类型
- 是否使用了目标扫描
这与 CLI 命令 az sphere device wifi show-status 报告的信息相同。
还应看到已连接的网络显示在 “已保存的网络 ”节点上。
启用或禁用 Wi-Fi 网络
可以使用 az sphere device wifi enable 命令启用配置的 Wi-Fi 网络：
az sphere device wifi enable --id <ID>
将 ID> 替换为<可以通过调用 az sphere device wifi list 获取的网络 ID。
可以使用 az sphere device wifi disable 命令禁用配置的 Wi-Fi 网络，如下所示：
az sphere device wifi disable --id <ID>
将 ID> 替换为<可以通过调用 az sphere device wifi list 获取的网络 ID。
若要在 Visual Studio Code 的 Azure Sphere 资源管理器中启用配置的 Wi-Fi 网络，请执行以下操作：
展开“已保存的网络”节点。
查找已禁用的网络;这些名称右侧将具有 Wi-Fi 符号。
选择 Wi-Fi 符号，或右键单击网络名称，然后选择“ 启用”。
若要在 Visual Studio Code 的 Azure Sphere 资源管理器中禁用配置的 Wi-Fi 网络，请执行以下操作：
展开“已保存的网络”节点。
查找已启用的网络;这些符号的 Wi-Fi 符号在其名称右侧带有反斜杠。
选择禁用的 Wi-Fi 符号，或右键单击网络名称，然后选择“ 禁用”。
若要在 Visual Studio 的 Azure Sphere 资源管理器中启用配置的 Wi-Fi 网络，请执行以下操作：
展开“已保存的网络”节点。
查找已禁用的网络;这些名称的右侧将具有连接符号。
选择连接符号，或右键单击网络名称，然后选择“ 启用”。
若要在 Visual Studio Code 的 Azure Sphere 资源管理器中禁用配置的 Wi-Fi 网络，请执行以下操作：
展开“已保存的网络”节点。
查找已启用的网络;这些项的名称右侧将有一个断开连接符号。
选择断开连接符号，或右键单击网络名称，然后选择“ 禁用”。
忘记 Wi-Fi 网络
可以使用 az sphere device wifi forget 命令忘记配置的 Wi-Fi 网络：
az sphere device wifi forget --id <ID>
将 ID> 替换为<可以通过调用 az sphere device wifi list 获取的网络 ID。
在 Visual Studio Code 的 Azure Sphere 资源管理器中忘记配置的 Wi-Fi 网络：
- 展开“已保存的网络”节点。
- 右键单击要忘记的网络，然后选择“ 忘记”。
在 Visual Studio 的 Azure Sphere 资源管理器中忘记配置的 Wi-Fi 网络：
- 展开“已保存的网络”节点。
- 右键单击要忘记的网络，然后选择“ 忘记”。
接收设备更新
Azure Sphere 设备在每次启动时都会检查 Azure Sphere OS 和应用程序更新情况，首次连接到 Internet 时检查一次，之后每隔 24 小时检查一次。 如果有可用的更新，下载和安装所需的时间可能长达 15-20 分钟，并且可能导致设备重启。
若要查看更新状态，请键入以下命令：
az sphere device show-deployment-status --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>
如果有较旧的 Seeed MT3620 开发工具包，可能需要手动更新它：
请通过 USB 将开发板连接到电脑。
使用 PowerShell、Windows 命令提示符或 Linux 命令行界面打开命令行界面。
使用恢复过程更新板：
如果遇到 Wi-Fi 问题，请首先确保 Wi-Fi 网络使用 802.11b/g/n；Azure Sphere 设备不支持 802.11a。
注意
Azure Sphere OS 更新是一个分阶段的过程，可能不到 15 分钟，也可能会更长，具体取决于互联网连接情况。 在各阶段之间，开发板将在下一组更新下载时显示为可操作。但在更新期间，开发板有时几分钟都可能没有响应。