login
重要
這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。
登入 Azure Sphere 安全性服務。 根據預設，所有 azsphere 命令都會套用至目前使用者的登入身分識別和租使用者。 登入命令可讓您使用不同的身分識別。
當您使用 azsphere 時，Azure Sphere 安全性服務會使用 Microsoft Azure Active Directory （AAD） 來驗證您的身分識別。 AAD 使用單一登錄 （SSO），這通常預設為計算機上的現有身分識別。 如果此身分識別不適用於您的 Azure Sphere 租使用者，azsphere 命令可能會失敗。 如需詳細資訊，請參閱 連線Microsoft帳戶。
使用 登入 明確地登入 Azure Sphere 安全性服務。 成功時，此身分識別會用於後續的 azsphere 命令。 在大部分情況下，您只需要登入一次。
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --use-device-code | String | 根據裝置程式代碼提供替代登入機制。 如果 CLI 無法啟動瀏覽器，這將會用於驗證。 如需此形式的驗證詳細資訊，請參閱 裝置程式代碼流程 。 |
全域參數
Azure Sphere CLI 提供下列全域參數：
| 參數 | 描述 |
|---|---|
| --debug | 增加記錄詳細信息以顯示所有偵錯記錄。 如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。 |
| -h, --help | 列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。 |
| --only-show-errors | 只顯示錯誤，隱藏警告。 |
| -o, --output | 變更輸出格式。 可用的輸出格式為 json、jsonc（色彩化 JSON）、tsv （Tab-Separated Values）、數據表（人類可讀取的 ASCII 數據表），以及 yaml。 根據預設，CLI 會輸出 table。 若要深入瞭解可用的輸出格式，請參閱 Azure Sphere CLI 命令的輸出格式。 |
| --查詢 | 使用 JMESPath 查詢語言來篩選從 Azure Sphere 安全性服務傳回的輸出。 如需詳細資訊和範例，請參閱 JMESPath 教學 課程和 查詢 Azure CLI 命令輸出 。 |
| --verbose | 列印作業期間在 Azure Sphere 中建立之資源的相關信息和其他實用資訊。 使用 --debug 以取得完整的偵錯記錄。 |
注意
如果您使用 Azure Sphere 傳統 CLI，請參閱 全域參數 ，以取得可用選項的詳細資訊。
範例
azsphere login
---------------------
Name
=====================
bob@contoso.com
---------------------
回應中，您應該會看到一個對話框，提示您登入。 如果清單包含您用於 Azure Sphere 的身分識別，請選擇該身分識別。 如果沒有，請輸入適當的認證。