共用方式為


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 來取得完整偵錯記錄。