az iot dps enrollment-group

備註

此參考是 Azure CLI 的 azure-iot 延伸模組的一部分 （2.67.0 版或更新版本）。 擴充功能會在您第一次 執行 az iot dps enrollment-group 命令時自動安裝。 深入瞭解擴充功能。

管理 Azure IoT 中樞裝置佈建服務中的註冊群組。

命令

名稱	Description	類型	狀態
az iot dps enrollment-group compute-device-key	為 Azure IoT 中樞 裝置佈建服務中的註冊群組產生衍生裝置 SAS 金鑰。	擴充套件	GA
az iot dps enrollment-group create	在 Azure IoT 中樞裝置布建服務中建立註冊群組。	擴充套件	GA
az iot dps enrollment-group delete	刪除 Azure IoT 中樞裝置布建服務中的註冊群組。	擴充套件	GA
az iot dps enrollment-group list	列出 Azure IoT 中樞 裝置布建服務中的註冊群組。	擴充套件	GA
az iot dps enrollment-group registration	在 Azure IoT 中樞 裝置布建服務中管理註冊群組的服務端裝置註冊。	擴充套件	GA
az iot dps enrollment-group registration delete	刪除 Azure IoT 中樞 裝置布建服務中註冊群組的裝置註冊。	擴充套件	GA
az iot dps enrollment-group registration list	列出 Azure IoT 中樞 裝置布建服務中註冊群組的裝置註冊。	擴充套件	GA
az iot dps enrollment-group registration show	取得 Azure IoT 中樞 裝置布建服務中註冊群組的裝置註冊。	擴充套件	GA
az iot dps enrollment-group show	在 Azure IoT 中樞 裝置布建服務中取得註冊群組的詳細數據。	擴充套件	GA
az iot dps enrollment-group update	更新 Azure IoT 中樞裝置布建服務中的註冊群組。	擴充套件	GA

az iot dps enrollment-group compute-device-key

為 Azure IoT 中樞 裝置佈建服務中的註冊群組產生衍生裝置 SAS 金鑰。

az iot dps enrollment-group compute-device-key --registration-id --rid
                                               [--auth-type {key, login}]
                                               [--dps-name]
                                               [--eid --enrollment-id --gid --group-id]
                                               [--key --symmetric-key]
                                               [--login]
                                               [--resource-group]

範例

使用指定的對稱金鑰來計算裝置金鑰。

az iot dps enrollment-group compute-device-key --key {enrollement_group_symmetric_key} --registration-id {registration_id}

使用指定的註冊群組計算裝置密鑰。

az iot dps enrollment-group compute-device-key -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --registration-id {registration_id}

必要參數

--registration-id --rid

裝置註冊的標識碼。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--auth-type

指出作業是否應該自動衍生原則密鑰，或使用目前的 Azure AD 工作階段。 如果驗證類型是登入，而且會提供資源主機名，除非需要，否則將會略過資源查閱。您可以使用 來設定預設值 az configure --defaults iotdps-data-auth-type={auth-type-value}。

屬性	值
參數群組:	Access Control Arguments
預設值:	key
接受的值:	key, login

--dps-name -n

Azure IoT 中樞 裝置布建服務的名稱或主機名。 如果未提供 --login，則為必要項。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--eid --enrollment-id --gid --group-id

註冊群組標識碼。

--key --symmetric-key

註冊群組的對稱共用存取金鑰。 這會略過裝置佈建服務登錄，並直接從提供的對稱密鑰產生 SAS 令牌，而不需進一步驗證。 除了註冊標識碼之外，所有其他命令參數都會被忽略。

--login -l

此命令支援具有執行動作許可權的實體 連接字串。 使用來避免透過 「az login」 的工作階段登入。 如果提供實體 連接字串 和名稱，則 連接字串 優先使用。 如果未提供 --dps-name，則為必要專案。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--resource-group -g

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az iot dps enrollment-group create

在 Azure IoT 中樞裝置布建服務中建立註冊群組。

請使用Base64 ASCII編碼提供憑證格式，且憑證應該具有相符的BEGIN和END區段，例如：以 '-----BEGIN CERTIFICATE-----' 開頭，並以 '-----END CERTIFICATE-----' 結尾。

az iot dps enrollment-group create --eid --enrollment-id --gid --group-id
                                   [--allocation-policy --ap {custom, geoLatency, hashed, static}]
                                   [--api-version --av]
                                   [--auth-type {key, login}]
                                   [--ca-name --cn --root-ca-name]
                                   [--certificate-path --cp]
                                   [--cpn --credential-policy-name]
                                   [--dps-name]
                                   [--edge-enabled --ee {false, true}]
                                   [--ih --iot-hubs]
                                   [--initial-twin-properties --props]
                                   [--initial-twin-tags --tags]
                                   [--login]
                                   [--pk --primary-key]
                                   [--provisioning-status --ps {disabled, enabled}]
                                   [--reprovision-policy --rp {never, reprovisionandmigratedata, reprovisionandresetdata}]
                                   [--resource-group]
                                   [--scn --secondary-ca-name --secondary-root-ca-name]
                                   [--scp --secondary-certificate-path]
                                   [--secondary-key --sk]
                                   [--webhook-url --wh]

範例

使用中繼憑證作為主要憑證，在資源群組 '{resource_group_name} 的 Azure IoT 布建服務 '{dps_name}' 中建立註冊群組 '{enrollment_id}'。

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem

使用 CA 憑證 {certificate_name} 作為次要憑證，在資源群組 '{resource_group_name} 的 Azure IoT 布建服務 '{dps_name}' 中建立註冊群組 '{enrollment_id}'。

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name}

使用中繼憑證作為主要憑證，在資源群組 '{resource_group_name}' 的 Azure IoT 布建服務 'MyDps' 中建立註冊群組 '{enrollment_id}'、初始對應項屬性 '{“location”：{“region”：“US”}}' 和初始對應項標記 '{“version_dps”：“1”}'。

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/Certificate.pem --provisioning-status enabled --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version_dps':'1'}"

在資源群組 '{resource_group_name} 中，使用證明類型 'symmetrickey' 在 Azure IoT 布建服務 '{dps_name}' 中建立註冊群組 '{enrollment_id}'。

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {primary_key} --secondary-key {secondary_key}

使用自定義配置原則建立註冊群組 '{enrollment_id}'

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy custom --webhook-url {webhook_url} --api-version {api_version}

建立指定自訂裝置登錄命名空間認證原則的註冊群組。

az iot dps enrollment-group create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy hashed --credential-policy-name {policy_name}

必要參數

--eid --enrollment-id --gid --group-id

註冊群組標識碼。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--allocation-policy --ap

配置原則類型，以判斷裝置如何指派給IoT中樞。 如果未提供，則配置原則會是裝置布建服務實例目前的配置原則預設值。

屬性	值
參數群組:	Allocation Policy Arguments
接受的值:	custom, geoLatency, hashed, static

--api-version --av

自訂配置要求中傳送之布建服務類型的 API 版本。 最低支援版本：2018-09-01-preview。

屬性	值
參數群組:	Allocation Policy Arguments

--auth-type

指出作業是否應該自動衍生原則密鑰，或使用目前的 Azure AD 工作階段。 如果驗證類型是登入，而且會提供資源主機名，除非需要，否則將會略過資源查閱。您可以使用 來設定預設值 az configure --defaults iotdps-data-auth-type={auth-type-value}。

屬性	值
參數群組:	Access Control Arguments
預設值:	key
接受的值:	key, login

--ca-name --cn --root-ca-name

主要根 CA 憑證的名稱。 如果需要具有根 CA 憑證的證明，則必須提供根 CA 名稱。

屬性	值
參數群組:	Authentication Arguments

--certificate-path --cp

包含主要憑證之檔案的路徑。 如果需要中繼憑證的證明，則必須提供憑證路徑。

屬性	值
參數群組:	Authentication Arguments

--cpn --credential-policy-name

ADR 命名空間認證原則名稱。

屬性	值
參數群組:	ADR Credential Policy Arguments

--dps-name -n

Azure IoT 中樞 裝置布建服務的名稱或主機名。 如果未提供 --login，則為必要項。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--edge-enabled --ee

指出邊緣啟用的旗標。

屬性	值
預設值:	False
接受的值:	false, true

--ih --iot-hubs

與配置原則相關聯的目標IoT中樞主機名。 針對多個IoT中樞使用空格分隔清單。

屬性	值
參數群組:	Allocation Policy Arguments

--initial-twin-properties --props

初始裝置對應項屬性。

--initial-twin-tags --tags

初始裝置對應項標籤。

--login -l

此命令支援具有執行動作許可權的實體 連接字串。 使用來避免透過 「az login」 的工作階段登入。 如果提供實體 連接字串 和名稱，則 連接字串 優先使用。 如果未提供 --dps-name，則為必要專案。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--pk --primary-key

以base64格式儲存的主要對稱共用存取金鑰。

屬性	值
參數群組:	Authentication Arguments

--provisioning-status --ps

啟用或停用註冊專案。

屬性	值
接受的值:	disabled, enabled

--reprovision-policy --rp

決定重新布建至不同IoT中樞時應如何處理裝置數據的原則。

屬性	值
接受的值:	never, reprovisionandmigratedata, reprovisionandresetdata

--resource-group -g

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

--scn --secondary-ca-name --secondary-root-ca-name

次要根 CA 憑證的名稱。 如果需要具有根 CA 憑證的證明，則必須提供根 CA 名稱。

屬性	值
參數群組:	Authentication Arguments

--scp --secondary-certificate-path

包含次要憑證之檔案的路徑。 如果需要中繼憑證的證明，則必須提供憑證路徑。

屬性	值
參數群組:	Authentication Arguments

--secondary-key --sk

以base64格式儲存的次要對稱共用存取金鑰。

屬性	值
參數群組:	Authentication Arguments

--webhook-url --wh

用於自定義配置要求的 Azure 函式 Webhook URL。

屬性	值
參數群組:	Allocation Policy Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az iot dps enrollment-group delete

刪除 Azure IoT 中樞裝置布建服務中的註冊群組。

az iot dps enrollment-group delete --eid --enrollment-id --gid --group-id
                                   [--auth-type {key, login}]
                                   [--dps-name]
                                   [--etag]
                                   [--login]
                                   [--resource-group]

必要參數

--eid --enrollment-id --gid --group-id

註冊群組標識碼。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--auth-type

指出作業是否應該自動衍生原則密鑰，或使用目前的 Azure AD 工作階段。 如果驗證類型是登入，而且會提供資源主機名，除非需要，否則將會略過資源查閱。您可以使用 來設定預設值 az configure --defaults iotdps-data-auth-type={auth-type-value}。

屬性	值
參數群組:	Access Control Arguments
預設值:	key
接受的值:	key, login

--dps-name -n

Azure IoT 中樞 裝置布建服務的名稱或主機名。 如果未提供 --login，則為必要項。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--etag -e

對應至資源最後狀態的 Etag 或實體標記。 如果未提供任何 etag，則會使用 『*』 值。

--login -l

此命令支援具有執行動作許可權的實體 連接字串。 使用來避免透過 「az login」 的工作階段登入。 如果提供實體 連接字串 和名稱，則 連接字串 優先使用。 如果未提供 --dps-name，則為必要專案。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--resource-group -g

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az iot dps enrollment-group list

列出 Azure IoT 中樞 裝置布建服務中的註冊群組。

az iot dps enrollment-group list [--auth-type {key, login}]
                                 [--dps-name]
                                 [--login]
                                 [--resource-group]
                                 [--top]

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--auth-type

指出作業是否應該自動衍生原則密鑰，或使用目前的 Azure AD 工作階段。 如果驗證類型是登入，而且會提供資源主機名，除非需要，否則將會略過資源查閱。您可以使用 來設定預設值 az configure --defaults iotdps-data-auth-type={auth-type-value}。

屬性	值
參數群組:	Access Control Arguments
預設值:	key
接受的值:	key, login

--dps-name -n

Azure IoT 中樞 裝置布建服務的名稱或主機名。 如果未提供 --login，則為必要項。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--login -l

此命令支援具有執行動作許可權的實體 連接字串。 使用來避免透過 「az login」 的工作階段登入。 如果提供實體 連接字串 和名稱，則 連接字串 優先使用。 如果未提供 --dps-name，則為必要專案。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--resource-group -g

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

--top

要傳回的項目數目上限。 使用 -1 無限制。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az iot dps enrollment-group show

在 Azure IoT 中樞 裝置布建服務中取得註冊群組的詳細數據。

az iot dps enrollment-group show --eid --enrollment-id --gid --group-id
                                 [--auth-type {key, login}]
                                 [--dps-name]
                                 [--keys --show-keys {false, true}]
                                 [--login]
                                 [--resource-group]

範例

基本用法

az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}

在對稱金鑰註冊群組的結果中包含完整的證明資訊

az iot dps enrollment-group show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys

必要參數

--eid --enrollment-id --gid --group-id

註冊群組標識碼。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--auth-type

指出作業是否應該自動衍生原則密鑰，或使用目前的 Azure AD 工作階段。 如果驗證類型是登入，而且會提供資源主機名，除非需要，否則將會略過資源查閱。您可以使用 來設定預設值 az configure --defaults iotdps-data-auth-type={auth-type-value}。

屬性	值
參數群組:	Access Control Arguments
預設值:	key
接受的值:	key, login

--dps-name -n

Azure IoT 中樞 裝置布建服務的名稱或主機名。 如果未提供 --login，則為必要項。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--keys --show-keys

在註冊群組結果中包含證明密鑰和資訊。

屬性	值
接受的值:	false, true

--login -l

此命令支援具有執行動作許可權的實體 連接字串。 使用來避免透過 「az login」 的工作階段登入。 如果提供實體 連接字串 和名稱，則 連接字串 優先使用。 如果未提供 --dps-name，則為必要專案。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--resource-group -g

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az iot dps enrollment-group update

更新 Azure IoT 中樞裝置布建服務中的註冊群組。

請使用Base64 ASCII編碼提供憑證格式，且憑證應該具有相符的BEGIN和END區段，例如：以 '-----BEGIN CERTIFICATE-----' 開頭，並以 '-----END CERTIFICATE-----' 結尾。

az iot dps enrollment-group update --eid --enrollment-id --gid --group-id
                                   [--allocation-policy --ap {custom, geoLatency, hashed, static}]
                                   [--api-version --av]
                                   [--auth-type {key, login}]
                                   [--ca-name --cn --root-ca-name]
                                   [--certificate-path --cp]
                                   [--cpn --credential-policy-name]
                                   [--dps-name]
                                   [--edge-enabled --ee {false, true}]
                                   [--etag]
                                   [--ih --iot-hubs]
                                   [--initial-twin-properties --props]
                                   [--initial-twin-tags --tags]
                                   [--login]
                                   [--pk --primary-key]
                                   [--provisioning-status --ps {disabled, enabled}]
                                   [--rc --remove-certificate {false, true}]
                                   [--remove-secondary-certificate --rsc {false, true}]
                                   [--reprovision-policy --rp {never, reprovisionandmigratedata, reprovisionandresetdata}]
                                   [--resource-group]
                                   [--scn --secondary-ca-name --secondary-root-ca-name]
                                   [--scp --secondary-certificate-path]
                                   [--secondary-key --sk]
                                   [--webhook-url --wh]

範例

使用初始對應項屬性和初始對應項標記，更新資源群組 '{resource_group_name}' 中 Azure IoT 布建服務 '{dps_name}' 中的註冊群組 '{enrollment_id}'。

az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version_dps':'2'}" --etag AAAAAAAAAAA=

使用新的主要中繼憑證，更新資源群組 『{resource_group_name}』 中 Azure IoT 布建服務 '{dps_name}' 中的註冊群組 '{enrollment_id}'，並移除現有的次要中繼憑證。

az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/NewCertificate.pem --remove-secondary-certificate --etag AAAAAAAAAAA=

使用新的次要 CA 憑證 '{enrollment_id certificate_name}' 更新資源群組 '{resource_group_name}' 資源群組 '{resource_group_name}' 中的 Azure IoT 布建服務 '{dps_name}' 中的註冊群組 '{certificate_name}'，並移除現有的主要 CA 憑證。

az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --secondary-ca-name {certificate_name} --remove-certificate --etag AAAAAAAAAAA=

使用新的主鍵，更新資源群組 '{resource_group_name}' 中 Azure IoT 布建服務 '{dps_name}' 中的註冊群組 '{enrollment_id}'。

az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {new_primary_key} --etag AAAAAAAAAAA=

更新 Azure IoT 裝置布建服務 '{enrollment_id dps_name}' 中的註冊群組 '{}'，以使用自定義 ADR 命名空間認證原則。

az iot dps enrollment-group update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --credential-policy-name {my_policy}

必要參數

--eid --enrollment-id --gid --group-id

註冊群組標識碼。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--allocation-policy --ap

配置原則類型，以判斷裝置如何指派給IoT中樞。 如果未提供，則配置原則會是裝置布建服務實例目前的配置原則預設值。

屬性	值
參數群組:	Allocation Policy Arguments
接受的值:	custom, geoLatency, hashed, static

--api-version --av

自訂配置要求中傳送之布建服務類型的 API 版本。 最低支援版本：2018-09-01-preview。

屬性	值
參數群組:	Allocation Policy Arguments

--auth-type

指出作業是否應該自動衍生原則密鑰，或使用目前的 Azure AD 工作階段。 如果驗證類型是登入，而且會提供資源主機名，除非需要，否則將會略過資源查閱。您可以使用 來設定預設值 az configure --defaults iotdps-data-auth-type={auth-type-value}。

屬性	值
參數群組:	Access Control Arguments
預設值:	key
接受的值:	key, login

--ca-name --cn --root-ca-name

主要根 CA 憑證的名稱。 如果需要具有根 CA 憑證的證明，則必須提供根 CA 名稱。

屬性	值
參數群組:	Authentication Arguments

--certificate-path --cp

包含主要憑證之檔案的路徑。 如果需要中繼憑證的證明，則必須提供憑證路徑。

屬性	值
參數群組:	Authentication Arguments

--cpn --credential-policy-name

ADR 命名空間認證原則名稱。

屬性	值
參數群組:	ADR Credential Policy Arguments

--dps-name -n

Azure IoT 中樞 裝置布建服務的名稱或主機名。 如果未提供 --login，則為必要項。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--edge-enabled --ee

指出邊緣啟用的旗標。

屬性	值
接受的值:	false, true

--etag -e

對應至資源最後狀態的 Etag 或實體標記。 如果未提供任何 etag，則會使用 『*』 值。

--ih --iot-hubs

與配置原則相關聯的目標IoT中樞主機名。 針對多個IoT中樞使用空格分隔清單。

屬性	值
參數群組:	Allocation Policy Arguments

--initial-twin-properties --props

初始裝置對應項屬性。

--initial-twin-tags --tags

初始裝置對應項標籤。

--login -l

此命令支援具有執行動作許可權的實體 連接字串。 使用來避免透過 「az login」 的工作階段登入。 如果提供實體 連接字串 和名稱，則 連接字串 優先使用。 如果未提供 --dps-name，則為必要專案。

屬性	值
參數群組:	Device Provisioning Service Identifier Arguments

--pk --primary-key

以base64格式儲存的主要對稱共用存取金鑰。

屬性	值
參數群組:	Authentication Arguments

--provisioning-status --ps

啟用或停用註冊專案。

屬性	值
接受的值:	disabled, enabled

--rc --remove-certificate

要移除目前主要憑證的旗標。

屬性	值
參數群組:	Authentication Arguments
接受的值:	false, true

--remove-secondary-certificate --rsc

要移除目前次要憑證的旗標。

屬性	值
參數群組:	Authentication Arguments
接受的值:	false, true

--reprovision-policy --rp

決定重新布建至不同IoT中樞時應如何處理裝置數據的原則。

屬性	值
接受的值:	never, reprovisionandmigratedata, reprovisionandresetdata

--resource-group -g

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

--scn --secondary-ca-name --secondary-root-ca-name

次要根 CA 憑證的名稱。 如果需要具有根 CA 憑證的證明，則必須提供根 CA 名稱。

屬性	值
參數群組:	Authentication Arguments

--scp --secondary-certificate-path

包含次要憑證之檔案的路徑。 如果需要中繼憑證的證明，則必須提供憑證路徑。

屬性	值
參數群組:	Authentication Arguments

--secondary-key --sk

以base64格式儲存的次要對稱共用存取金鑰。

屬性	值
參數群組:	Authentication Arguments

--webhook-url --wh

用於自定義配置要求的 Azure 函式 Webhook URL。

屬性	值
參數群組:	Allocation Policy Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False