租戶
管理 Azure 球體租使用者。
重要
這些命令 azsphere tenant download-ca-certificate 、 azsphere tenant download-ca-certificate-chain 、以及 azsphere tenant download-validation-certificate 都已過時。 改用 azsphere ca-certificate download 、 azsphere ca-certificate download-chain 、 azsphere ca-certificate download-proof 、及 azsphere ca-certificate list 。
在 Azure 球體 CLI 中，建立租使用者時不會自動選取預設 租使用者。 您必須執行 azsphere 租使用者選取 命令，才能選取要用於電腦上目前使用者的預設租使用者。 這是為了確保預設租使用者在執行您無法復原的一次性作業時，使用的預設租使用者是正確的，例如 聲稱裝置。
| 操作 | 描述 |
|---|---|
| 創建 | 建立新的租使用者。 |
| download-error-report | 傳回目前租使用者內裝置的錯誤資訊。 |
| 清單 | 列出可用的 Azure 球體租使用者。 |
| 選擇 | 選取要在此電腦上使用的預設 Azure 球體租使用者。 |
| 顯示選取 | 顯示此電腦的預設 Azure 球體租使用者。 |
| 更新 | 更新租使用者的詳細資料，例如租使用者名稱。 |
創建
建立新的 Azure 球體租使用者。 需要連接的裝置才能執行此命令。 如需詳細資訊，請參閱 建立 Azure 球體租使用者。
如果您已經有租使用者，且確定要另一個租使用者，請使用參數 --force-additional 。 目前，您無法刪除 Azure 球體租使用者。
建立租使用者之後，請 執行 azsphere 租使用者選取 ，選取要在此電腦上用於目前使用者的預設租使用者。 您可以使用 azsphere 角色 新增命令，為目前 Azure 球體租使用者中的使用者新增角色。
azsphere 租使用者建立命令適用于本機連接的 Azure 球體裝置。 如果您嘗試的命令未連接裝置，您會收到錯誤訊息。 裝置識別碼會在您建立租使用者時進行記錄，而且每個裝置只能建立一個租使用者。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -n， --name | 字串 | 指定租使用者的名稱。 為您的租使用者命名時，請使用英數位元字元。 不允許特殊字元。 名稱不得超過 50 個字元且區分大小寫。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -d， --device | 字串 | 指定要在連接多個裝置時執行命令的裝置。 連接多個裝置時，必須使用此參數。 系統預設會使用目前連接的裝置。 您可以指定附加裝置的裝置識別碼、IP 位址或本機連線識別碼。 Azure 球體 CLI 支援 Windows 上的多個 MT3620 裝置，但您一次只能在 Linux 上連接一個裝置。 因此，Windows 支援此參數，但不支援 Linux。 如果您將此參數搭配 Linux 上的命令使用，就會傳回錯誤。 |
| --force-additional | 布林 | 強制建立新的 Azure 球體租使用者。 只有在您確定要使用目前帳戶使用附加裝置建立新的 Azure 球體租使用者時，才使用此命令。 |
| --disable-confirm-prompt | 布林 | 停用使用者確認提示。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere tenant create --name MyTenant
--force-additional--disable-confirm-prompt 如果您確定要使用此帳戶使用附加裝置建立新的 Azure 球體租使用者，請使用和參數。 先前用來建立 Azure 球體租使用者的裝置無法用來建立新的租使用者。
azsphere tenant create --name MyTenant --force-additional
You have logged in with the following account:
bob@contoso.com
Do you want to use this account to create a new Azure Sphere tenant using the attached device?
You cannot change the tenant name 'MyTenant1' once it has been created.
Enter 'yes' to continue. Enter anything else to exit.
yes
> verbose: TraceId: c761ba73-761e-4df2-94f5-3f87384d71b7
Created a new Azure Sphere tenant:
--> Tenant Name: MyTenant1
--> Tenant ID: 768c2cd6-059a-49ad-9f53-89f5271cea15
Please use 'azsphere tenant select --tenant MyTenant' to select the created tenant.
提示
建立租使用者之後，請確定您執行 azsphere 租使用者，選 取以選取要在此電腦上用於目前使用者的預設租使用者。
download-error-report
傳回目前租使用者內裝置回報錯誤的相關資訊。
此命令會從 Azure 球體安全性服務雲端提取事件資料，而不需要與特定裝置進行實體連線。 azsphere 租使用者下載錯誤報表命令適用于目前租使用者的內容，並傳回該租使用者內所有裝置的錯誤報表。
注意
最近報告的事件可能需要 24 小時才能下載。 如需詳細資訊，請參閱 收集和解譯錯誤資料。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --目的地 | 字串 | 指定輸出檔案的路徑和檔案名。 |
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
清單
列出 Azure 球體租使用者。
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
選擇
選取此電腦上目前使用者使用的預設 Azure 球體租使用者。
若要顯示目前的預設租使用者，請使用azsphere 租使用者顯示選取。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
顯示選取
顯示此電腦上目前使用者的預設 Azure 球體租使用者詳細資料。
這是使用 azsphere 租使用者選取命令選取的租 使用者。
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
更新
更新租使用者的詳細資料，例如租使用者名稱。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -n，--new-name | 字串 | 指定租使用者的新名稱。 為您的租使用者命名時，請使用英數位元字元。 不允許特殊字元。 名稱不得超過 50 個字元且區分大小寫。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t， --租使用者 | GUID 或名稱 | 指定租使用者在中執行此作業。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租使用者名稱。 |
全域參數
下列全域參數適用于 Azure 球體 CLI：
| 參數 | 描述 |
|---|---|
| --調試 | 增加記錄詳細資訊以顯示所有偵錯記錄。 如果您發現錯誤，請在提交錯誤報表時提供含有標幟的 --debug 輸出。 |
| -h， --說明 | 列印 CLI 參照命令及其引數的相關資訊，並列出可用的子群組和命令。 |
| --only-show-errors | 僅顯示錯誤，隱藏警告。 |
| -o， --output | 變更輸出格式。 可用的輸出格式為 json、jsonc (色彩化 JSON) 、tsv (Tab 分隔值) 、表格 (人性化的 ASCII 資料表) ，以及 yaml。 根據預設，CLI 輸出 。 table 若要深入瞭解可用的輸出格式，請參閱 Azure 球體 CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure 球體安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學課程 和 查詢 Azure CLI 命令輸出 。 |
| --詳細 | 列印工作期間在 Azure 球體中建立之資源的相關資訊及其他實用資訊。 用於 --debug 完整偵錯記錄。 |
注意
如果您使用的是 Azure 球體傳統 CLI，請參閱 全域參數 以取得可用選項的詳細資訊。
例子
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2 Administrator
Contributor
------------------------------------ --------------------- -------------
提示
如果您尚未選取預設租使用者，則會顯示可用租使用者的清單。 選取其中一個選項來設定您的預設租使用者。