az iot hub certificate

參考

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。安裝每個擴充功能以受益于其擴充功能。深入了解擴充功能。

管理 IoT 中樞憑證。

命令

名稱	Description	類型	狀態
az iot hub certificate create	建立/上傳Azure IoT 中樞憑證。	核心	GA
az iot hub certificate delete	刪除Azure IoT 中樞憑證。	核心	GA
az iot hub certificate generate-verification-code	產生Azure IoT 中樞憑證的驗證碼。	核心	GA
az iot hub certificate list	列出包含在Azure IoT 中樞內的所有憑證。	核心	GA
az iot hub certificate root-authority	管理IoT 中樞實例的憑證根憑證授權單位。	副檔名	已取代
az iot hub certificate root-authority set	將IoT 中樞實例的憑證根憑證授權單位設定為特定版本。	副檔名	已取代
az iot hub certificate root-authority show	顯示IoT 中樞實例的目前憑證根憑證授權單位。	副檔名	已取代
az iot hub certificate show	顯示特定Azure IoT 中樞憑證的相關資訊。	核心	GA
az iot hub certificate update	更新Azure IoT 中樞憑證。	核心	GA
az iot hub certificate verify	驗證Azure IoT 中樞憑證。	核心	GA

az iot hub certificate create

編輯

建立/上傳Azure IoT 中樞憑證。

如需 Azure IoT 中樞中 CA 憑證的詳細說明，請參閱 https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview 。

az iot hub certificate create --hub-name
                              --name
                              --path
                              [--resource-group]
                              [--verified {false, true}]

範例

將已驗證的 CA 憑證 PEM 檔案上傳至 IoT 中樞。

az iot hub certificate create --hub-name MyIotHub --name MyCertificate --path /certificates/Certificate.pem --verified

將 CA 憑證 CER 檔案上傳至 IoT 中樞。

az iot hub certificate create --hub-name MyIotHub --name MyCertificate --path /certificates/Certificate.cer

建立/上傳Azure IoT 中樞憑證（自動產生）

az iot hub certificate create --hub-name MyIotHub --name MyCertificate --path /certificates/Certificate.cer --resource-group MyResourceGroup --subscription MySubscription

必要參數

--hub-name

IoT 中樞名稱。

--name -n

憑證的易記名稱。

--path -p

包含憑證之檔案的路徑。

選擇性參數

--resource-group -g

資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

--verified -v

布林值，指出是否已驗證憑證。

接受的值: false, true

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az iot hub certificate delete

編輯

刪除Azure IoT 中樞憑證。

如需 Azure IoT 中樞中 CA 憑證的詳細說明，請參閱 https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview 。

az iot hub certificate delete --etag
                              --name
                              [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--subscription]

範例

刪除 MyCertificate

az iot hub certificate delete --hub-name MyIotHub --name MyCertificate --etag AAAAAAAAAAA=

必要參數

--etag -e

物件的實體標記（etag）。

--name -n

憑證的易記名稱。

選擇性參數

--hub-name

IoT 中樞名稱。

--ids

一或多個資源識別碼 (以空格分隔)。它應該是包含「資源識別碼」引數所有資訊的完整資源識別碼。您應該提供 --ids 或其他「資源識別碼」引數。

--resource-group -g

資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az iot hub certificate generate-verification-code

編輯

產生Azure IoT 中樞憑證的驗證碼。

此驗證碼可用來完成憑證的擁有證明步驟。使用此驗證碼作為以根憑證私密金鑰簽署之新憑證的 CN。如需 Azure IoT 中樞中 CA 憑證的詳細說明，請參閱 https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview 。

az iot hub certificate generate-verification-code --etag
                                                  --name
                                                  [--hub-name]
                                                  [--ids]
                                                  [--resource-group]
                                                  [--subscription]

範例

產生 MyCertificate 的驗證碼

az iot hub certificate generate-verification-code --hub-name MyIotHub --name MyCertificate --etag AAAAAAAAAAA=

產生Azure IoT 中樞憑證的驗證碼（自動產生）

az iot hub certificate generate-verification-code --etag AAAAAAAAAAA= --hub-name MyIotHub --name MyCertificate --resource-group MyResourceGroup --subscription MySubscription

必要參數

--etag -e

物件的實體標記（etag）。

--name -n

憑證的易記名稱。

選擇性參數

--hub-name

IoT 中樞名稱。

--ids

一或多個資源識別碼 (以空格分隔)。它應該是包含「資源識別碼」引數所有資訊的完整資源識別碼。您應該提供 --ids 或其他「資源識別碼」引數。

--resource-group -g

資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az iot hub certificate list

編輯

列出包含在Azure IoT 中樞內的所有憑證。

如需 Azure IoT 中樞中 CA 憑證的詳細說明，請參閱 https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview 。

az iot hub certificate list [--hub-name]
                            [--ids]
                            [--resource-group]
                            [--subscription]

範例

列出 MyIotHub 中的所有憑證

az iot hub certificate list --hub-name MyIotHub

選擇性參數

--hub-name

IoT 中樞名稱。

--ids

一或多個資源識別碼 (以空格分隔)。它應該是包含「資源識別碼」引數所有資訊的完整資源識別碼。您應該提供 --ids 或其他「資源識別碼」引數。

--resource-group -g

資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az iot hub certificate show

編輯

顯示特定Azure IoT 中樞憑證的相關資訊。

如需 Azure IoT 中樞中 CA 憑證的詳細說明，請參閱 https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview 。

az iot hub certificate show --name
                            [--hub-name]
                            [--ids]
                            [--resource-group]
                            [--subscription]

範例

顯示 MyCertificate 的詳細資料

az iot hub certificate show --hub-name MyIotHub --name MyCertificate

顯示特定Azure IoT 中樞憑證的相關資訊（自動產生）

az iot hub certificate show --hub-name MyIotHub --name MyCertificate --resource-group MyResourceGroup --subscription MySubscription

必要參數

--name -n

憑證的易記名稱。

選擇性參數

--hub-name

IoT 中樞名稱。

--ids

一或多個資源識別碼 (以空格分隔)。它應該是包含「資源識別碼」引數所有資訊的完整資源識別碼。您應該提供 --ids 或其他「資源識別碼」引數。

--resource-group -g

資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az iot hub certificate update

編輯

更新Azure IoT 中樞憑證。

上傳新的憑證，以相同名稱取代現有的憑證。如需 Azure IoT 中樞中 CA 憑證的詳細說明，請參閱 https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview 。

az iot hub certificate update --etag
                              --name
                              --path
                              [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--subscription]
                              [--verified {false, true}]

範例

更新 IoT 中樞中的 CA 憑證，方法是上傳新的 PEM 檔案。

az iot hub certificate update --hub-name MyIotHub --name MyCertificate --path /certificates/NewCertificate.pem --etag AAAAAAAAAAA=

更新 IoT 中樞中的 CA 憑證，方法是上傳新的 CER 檔案。

az iot hub certificate update --hub-name MyIotHub --name MyCertificate --path /certificates/NewCertificate.cer --etag AAAAAAAAAAA=

必要參數

--etag -e

物件的實體標記（etag）。

--name -n

憑證的易記名稱。

--path -p

包含憑證之檔案的路徑。

選擇性參數

--hub-name

IoT 中樞名稱。

--ids

一或多個資源識別碼 (以空格分隔)。它應該是包含「資源識別碼」引數所有資訊的完整資源識別碼。您應該提供 --ids 或其他「資源識別碼」引數。

--resource-group -g

資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verified -v

布林值，指出是否已驗證憑證。

接受的值: false, true

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az iot hub certificate verify

編輯

驗證Azure IoT 中樞憑證。

藉由上傳包含呼叫 generate-verification-code 所取得之驗證碼的驗證憑證，以驗證憑證。這是控管程式證明的最後一個步驟。如需 Azure IoT 中樞中 CA 憑證的詳細說明，請參閱 https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview 。

az iot hub certificate verify --etag
                              --name
                              --path
                              [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--subscription]

範例

驗證 MyCertificate 私密金鑰的擁有權。

az iot hub certificate verify --hub-name MyIotHub --name MyCertificate --path /certificates/Verification.pem --etag AAAAAAAAAAA=

驗證Azure IoT 中樞憑證（自動產生）

az iot hub certificate verify --etag AAAAAAAAAAA= --hub-name MyIotHub --name MyCertificate --path /certificates/Verification.pem --resource-group MyResourceGroup --subscription MySubscription

必要參數

--etag -e

物件的實體標記（etag）。

--name -n

憑證的易記名稱。

--path -p

包含憑證之檔案的路徑。

選擇性參數

--hub-name

IoT 中樞名稱。

--ids

一或多個資源識別碼 (以空格分隔)。它應該是包含「資源識別碼」引數所有資訊的完整資源識別碼。您應該提供 --ids 或其他「資源識別碼」引數。

--resource-group -g

資源組名。您可以使用來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

共用方式為

az iot hub certificate

命令

az iot hub certificate create

範例

必要參數

選擇性參數

az iot hub certificate delete

範例

必要參數

選擇性參數

az iot hub certificate generate-verification-code

範例

必要參數

選擇性參數

az iot hub certificate list

範例

選擇性參數

az iot hub certificate show

範例

必要參數

選擇性參數

az iot hub certificate update

範例

必要參數

選擇性參數

az iot hub certificate verify

範例

必要參數

選擇性參數

其他資源