管理租用戶

重要

這是 Azure Sphere （舊版）檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 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 命令。