ca-certificate
管理憑證授權單位單位 (目前 Azure 球體租使用者的 CA) 憑證。 如需詳細資訊，請參閱 管理租使用者 CA 憑證。
| 操作 | 描述 |
|---|---|
| 下載 | 將目前 Azure 球體租使用者的 CA 憑證下載為 X.509 .cer 檔案。 |
| download-chain | 將目前 Azure 球體租使用者的 CA 憑證鏈結下載為 PKCS#7 .p7b 檔案。 |
| 下載證明 | 下載目前 Azure 球體租使用者的憑證做為 X.509 .cer 檔案。 |
| 清單 | 列出目前 Azure 球體租使用者的所有憑證。 |
下載
將目前 Azure 球體租使用者的 CA 憑證下載為 X.509 .cer 檔案。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --目的地 | 字串 | 指定儲存租使用者 CA 憑證的路徑和檔案名。 檔案路徑可以是絕對或相對路徑，但必須有 .cer 副檔名。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --指數 | 整數 | 指定要下載的憑證索引。 執行 azsphere ca-certificate list 以列出憑證和索引值。 如果未提供索引，系統會下載使用中的憑證。 您可以指定索引值或縮圖。 |
| --指紋 | 字串 | 指定要下載之憑證的縮圖。 執行 azsphere ca-certificate list 以列出憑證和縮圖值。 如果沒有提供縮圖，則會下載使用中的憑證。 您可以指定索引值或縮圖。 |
| -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 ca-certificate download --destination ca-cert.cer --index 1
指定縮圖以下載必要憑證的範例：
azsphere ca-certificate download --destination ca-cert.cer --thumbprint <value>
您應該會看到如下所示的輸出：
Succeeded
download-chain
將目前 Azure 球體租使用者的 CA 憑證鏈結下載為 PKCS#7 .p7b 檔案。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --目的地 | 字串 | 指定儲存租使用者 CA 憑證鏈結的路徑和檔案名。 您可以提供相對或絕對路徑，而且必須使用 .p7b 擴充功能。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --指數 | 整數 | 指定要下載的憑證索引。 執行 azsphere ca-certificate list 以列出憑證和索引值。 如果未提供索引，系統會下載使用中的憑證。 您可以指定索引值或縮圖。 |
| --指紋 | 字串 | 指定要下載之憑證的縮圖。 執行 azsphere ca-certificate list 以列出憑證和縮圖值。 如果沒有提供縮圖，則會下載使用中的憑證。 您可以指定索引值或縮圖。 |
| -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 ca-certificate download-chain --destination CA-cert-chain.p7b --index 1
Succeeded
下載證明
下載目前 Azure 球體租使用者的憑證，以搭配提供的程式碼使用，以及做為 X.509 .cer 檔案。 此憑證是裝置驗證和證明程式的一部分。 如需搭配 Azure IoT 使用 Azure 球體裝置的詳細資訊，請參閱 搭配 Azure 球體使用 Azure IoT。
必要參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --目的地 | 字串 | 指定儲存憑證證明的路徑和檔案名。 檔路徑可以是絕對或相對路徑，但必須使用 .cer 副檔名。 |
| --verification-code | 字串 | 指定產生憑證時所要使用的 Azure 球體安全性服務的驗證碼。 |
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| --指數 | 整數 | 指定要下載的憑證索引。 執行 azsphere ca-certificate list 以列出憑證和索引值。 如果未提供索引，系統會下載使用中的憑證。 您可以指定索引值或縮圖。 |
| --指紋 | 字串 | 指定要下載之憑證的縮圖。 執行 azsphere ca-certificate list 以列出憑證和縮圖值。 如果沒有提供縮圖，則會下載使用中的憑證。 您可以指定索引值或縮圖。 |
| -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 ca-certificate download-proof --destination validation.cer --verification-code 123412341234 --index 1
Succeeded
清單
列出目前租使用者的所有憑證。
選用參數
| 參數 | 類型 | 描述 |
|---|---|---|
| -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 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
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------