az iot hub certificate root-authority

注意

此參考是 Azure CLI 的 azure-iot 延伸模組的一部分（2.46.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 來取得完整偵錯記錄。