ca-certificate
重要
這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。
管理目前 Azure Sphere 租使用者的證書頒發機構單位 （CA） 憑證。 如需詳細資訊，請參閱 管理租使用者 CA 憑證。
| 作業 | 描述 |
|---|---|
| 下載 | 將目前 Azure Sphere 租使用者的 CA 憑證下載為 X.509 .cer 檔案。 |
| download-chain | 將目前 Azure Sphere 租使用者的 CA 憑證鏈結下載為 PKCS#7 .p7b 檔案。 |
| 下載證明 | 將目前 Azure Sphere 租使用者的擁有證明憑證下載為 X.509 .cer 檔案。 |
| 清單 | 列出目前 Azure Sphere 租使用者的所有憑證。 |
下載
將目前 Azure Sphere 租使用者的 CA 憑證下載為 X.509 .cer 檔案。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --目的地 | String | 指定要儲存租使用者 CA 憑證的路徑和檔名。 檔案路徑可以是絕對路徑或相對路徑，但必須具有.cer擴展名。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --指數 | 整數 | 指定要下載之憑證的索引。 執行 azsphere ca-certificate list 以列出憑證和索引值。 如果未提供任何索引，則會下載使用中的憑證。 您可以指定索引值或指紋。 |
| --指紋 | String | 指定要下載之憑證的指紋。 執行 azsphere ca-certificate list 以列出憑證和指紋值。 如果未提供指紋，則會下載使用中的憑證。 您可以指定索引值或指紋。 |
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
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 ca-certificate download --destination ca-cert.cer --index 1
指定指紋以下載必要憑證的範例：
azsphere ca-certificate download --destination ca-cert.cer --thumbprint <value>
您應該會看到如下的輸出：
Succeeded
download-chain
將目前 Azure Sphere 租使用者的 CA 憑證鏈結下載為 PKCS#7 .p7b 檔案。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --目的地 | String | 指定要儲存租使用者 CA 憑證鏈結的路徑和檔名。 您可以提供相對或絕對路徑，而且必須使用 .p7b 擴展名。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --指數 | 整數 | 指定要下載之憑證的索引。 執行 azsphere ca-certificate list 以列出憑證和索引值。 如果未提供任何索引，則會下載使用中的憑證。 您可以指定索引值或指紋。 |
| --指紋 | String | 指定要下載之憑證的指紋。 執行 azsphere ca-certificate list 以列出憑證和指紋值。 如果未提供指紋，則會下載使用中的憑證。 您可以指定索引值或指紋。 |
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
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 ca-certificate download-chain --destination CA-cert-chain.p7b --index 1
Succeeded
下載證明
下載目前 Azure Sphere 租使用者的擁有權證明憑證、搭配提供的程式代碼使用，以及作為 X.509 .cer 檔案使用。 此憑證是裝置驗證和證明程式的一部分。 如需搭配 Azure IoT 使用 Azure Sphere 裝置的詳細資訊，請參閱 搭配 Azure Sphere 使用 Azure IoT。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --目的地 | String | 指定要儲存擁有證明憑證的路徑和檔名。 filepath 可以是絕對路徑或相對路徑，但必須使用.cer擴展名。 |
| --verification-code | String | 指定產生憑證時要使用的 Azure Sphere 安全性服務的驗證碼。 |
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --指數 | 整數 | 指定要下載之憑證的索引。 執行 azsphere ca-certificate list 以列出憑證和索引值。 如果未提供任何索引，則會下載使用中的憑證。 您可以指定索引值或指紋。 |
| --指紋 | String | 指定要下載之憑證的指紋。 執行 azsphere ca-certificate list 以列出憑證和指紋值。 如果未提供指紋，則會下載使用中的憑證。 您可以指定索引值或指紋。 |
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
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 ca-certificate download-proof --destination validation.cer --verification-code 123412341234 --index 1
Succeeded
清單
列出目前租使用者的所有憑證。
選擇性參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -t、 --tenant | GUID 或名稱 | 指定要在中執行這項作業的租使用者。 覆寫預設選取的租使用者。 您可以指定租使用者識別碼或租用戶名稱。 |
全域參數
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 ca-certificate list
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------
Index Thumbprint CertificateDetails Status StartDate EndDate
=========================================================================================================================================================
1 <value> CN: Microsoft Azure Sphere <tenant-ID> Active 09/06/2020 17:39:40 09/06/2022 17:39:40
O: Microsoft Corporation
L: Redmond
ST: Washington
C: US
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------
2 <value> CN: Microsoft Azure Sphere <tenant-ID> Ready 29/04/2020 22:51:47 29/04/2022 22:51:47
O: Microsoft Corporation
L: Redmond
ST: Washington
C: US
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------