az iot hub certificate root-authority

注意

此參考是 Azure CLI 的 azure-iot 延伸模組的一部分 (2.37.0 版或更高版本)。 擴充功能會在您第一次執行 az iot hub certificate root-authority 命令時自動安裝。 深入了解擴充功能。

此命令群組已被取代,將在未來的版本中移除。

管理IoT 中樞實例的憑證根憑證授權單位。

命令

名稱 Description 類型 狀態
az iot hub certificate root-authority set

將IoT 中樞實例的憑證根憑證授權單位設定為特定版本。

副檔名 已取代
az iot hub certificate root-authority show

顯示IoT 中樞實例的目前憑證根憑證授權單位。

副檔名 已取代

az iot hub certificate root-authority set

已被取代

此命令已隱含取代,因為命令群組 'iot 中樞憑證跟授權單位' 已被取代,且將在未來的版本中移除。

將IoT 中樞實例的憑證根憑證授權單位設定為特定版本。

將此資源轉換為 DigiCert Global G2 根目錄 (v2) 上的憑證,或還原為 Baltimore 根目錄 (v1)。 進行此轉換之前,請確定所有裝置都會更新,以包含要轉換IoT 中樞之根目錄的公用部分。 裝置會使用新的根目錄中斷連線並重新連線。 建議您監視目前的連線,但使用者定義的計量可能更適合您的情況。

az iot hub certificate root-authority set --cav {v1, v2}
                                          --hub-name
                                          [--resource-group]
                                          [--yes {false, true}]

範例

將目標IoT 中樞根憑證授權單位轉換為 Digicert。

az iot hub certificate root-authority set --hub-name {iothub_name} --certificate-authority v2

將目標IoT 中樞憑證授權單位單位還原為 Baltimore。

az iot hub certificate root-authority set --hub-name {iothub_name} --certificate-authority v1

必要參數

--cav --certificate-authority

憑證授權單位單位版本。 v1 代表 Baltimore CA,v2 代表 Digicert CA。

接受的值: v1, v2
--hub-name

IoT 中樞名稱。 如果未提供 --login,則為必要項。

選擇性參數

--resource-group -g

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

--yes -y

略過使用者提示。 表示接受動作。 主要用於自動化案例。 預設:false。

接受的值: false, true
預設值: False
全域參數
--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 root-authority show

已被取代

此命令已隱含取代,因為命令群組 'iot 中樞憑證跟授權單位' 已被取代,且將在未來的版本中移除。

顯示IoT 中樞實例的目前憑證根憑證授權單位。

az iot hub certificate root-authority show --hub-name
                                           [--resource-group]

範例

顯示目標IoT 中樞憑證授權單位單位。

az iot hub certificate root-authority show --hub-name {iothub_name}

必要參數

--hub-name

IoT 中樞名稱。 如果未提供 --login,則為必要項。

選擇性參數

--resource-group -g

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

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