管理租用戶
Azure Sphere 租用戶提供了安全的方法,讓您組織可在與客戶裝置隔離的情況下,從遠端管理其 Azure Sphere 裝置。 您的組織必須建立 Azure Sphere 租用戶,然後將每個裝置宣告為該租用戶,如此就能安全地遠端管理這些裝置。
必要條件
建立 Azure Sphere 租使用者
Azure Sphere 租用戶會隔離您的 Azure Sphere 裝置,並提供組織及部署應用程式的方式。 建立租用戶的帳戶會自動為租使用者指派系統管理員角色。
提示
- 建立租用戶之後,就無法刪除租使用者,且無法在租用戶之間移轉裝置。 如果您的小組或組織已經有 Azure Sphere 租使用者,請考慮要求其存取權,而不是建立額外的租使用者。
若要建立 Azure Sphere 租使用者:
透過USB將 Azure Sphere 裝置連線到您的電腦。
使用 PowerShell、Windows 命令提示字元或 Linux 命令殼層開啟 Azure Sphere CLI。
依照這裡的指示登入 CLI。
若要建立租使用者,請輸入下列命令:
azsphere tenant create --name <tenant-name or tenant-ID>
將租用戶名稱>取代<為其他使用者可以辨識的名稱,例如 “Contoso Ltd” 或 “Contoso 洗碗機部門”。當您為租使用者命名時,只使用英數位元和空格。 如果您包含空格,請以引號括住名稱。 名稱不得以空格開頭或超過50個字元。 不允許使用特殊字元。 名稱區分大小寫。
當您建立租使用者時,Azure Sphere 安全性服務會記錄連結裝置的裝置識別碼。 每個裝置識別碼都只能用來建立一個 Azure Sphere 租使用者。
如果您的帳戶已有 Azure Sphere 租使用者的存取權,則命令將會失敗,建議您使用現有的租使用者。 如果您確定要建立新的租使用者,您可以使用 --force-additional
參數來強制建立新的 Azure Sphere 租使用者。
azsphere tenant create 命令會建立租使用者,但不會將裝置宣告至租使用者。 如需詳細資訊,請參閱 宣告您的裝置。
若要使用 API 建立租使用者,請使用 租使用者 - 建立 作業。
顯示並選取預設租使用者
執行 azsphere tenant show-selected 以確認選取的租用戶應該使用此電腦上的預設值。
若要修改或選取預設租使用者,請執行 azsphere tenant select。
提示
如果您註銷並再次登入 Azure Sphere 安全性服務,可能會提示您選取預設租使用者。 請務必使用您想要用來管理 Azure Sphere 裝置的帳戶登入。
列出租使用者
您可以使用下列選項列出可用的 Azure Sphere 租使用者:
執行下列命令以列出可用的 Azure Sphere 租使用者。
azsphere tenant list
若要使用 API 列出租使用者,請使用 租使用者 - 取得 作業。
更新現有的租使用者
您可以使用 Azure Sphere CLI 或 Azure Sphere 公用 API 來重新命名現有的 Azure Sphere 租使用者。 命名租使用者時,請使用英數位元。 不允許使用特殊字元。 名稱不得超過 50 個字元,且區分大小寫。
若要 使用 CLI 更新租 使用者,請執行 命令:
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
提示
如果未選取預設租使用者,可能會顯示訊息。 從清單中選取必要的租用戶,然後重試命令。
若要使用 API 更新租使用者,請使用 租使用者 - 修補 作業。
下載租用戶的錯誤報告
若要取得租使用者內所有裝置的錯誤報告,請使用 azsphere tenant download-error-report 命令。