az iot dps enrollment-group

  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.37.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az iot dps enrollment-group-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Registrierungsgruppen in einem Azure IoT Hub Device Provisioning Service.

Befehle

Name Beschreibung Typ Status
az iot dps enrollment-group compute-device-key

Generieren Sie einen abgeleiteten Geräte-SAS-Schlüssel für eine Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service.

 Durchwahl Allgemein verfügbar
az iot dps enrollment-group create

Erstellen Sie eine Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service.

 Durchwahl Allgemein verfügbar
az iot dps enrollment-group delete

Löschen Einer Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service.

 Durchwahl Allgemein verfügbar
az iot dps enrollment-group list

Auflisten von Registrierungsgruppen in einem Azure IoT Hub Device Provisioning Service.

 Durchwahl Allgemein verfügbar
az iot dps enrollment-group registration

Verwalten sie dienstseitige Geräteregistrierungen für eine Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service.

 Durchwahl Allgemein verfügbar
az iot dps enrollment-group registration delete

Löschen Einer Geräteregistrierung für eine Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service.

 Durchwahl Allgemein verfügbar
az iot dps enrollment-group registration list

Auflisten von Geräteregistrierungen für eine Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service.

 Durchwahl Allgemein verfügbar
az iot dps enrollment-group registration show

Rufen Sie eine Geräteregistrierung für eine Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service ab.

 Durchwahl Allgemein verfügbar
az iot dps enrollment-group show

Rufen Sie die Details einer Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service ab.

 Durchwahl Allgemein verfügbar
az iot dps enrollment-group update

Aktualisieren einer Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service.

 Durchwahl Allgemein verfügbar

az iot dps enrollment-group compute-device-key

Generieren Sie einen abgeleiteten Geräte-SAS-Schlüssel für eine Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service.

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

Beispiele

Berechnen Sie den Geräteschlüssel mit dem angegebenen symmetrischen Schlüssel.

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

Berechnen Sie den Geräteschlüssel mit der angegebenen Registrierungsgruppe.

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

Erforderliche Parameter

--registration-id --rid

ID der Geräteregistrierung.

Optionale Parameter

--auth-type

Gibt an, ob der Vorgang einen Richtlinienschlüssel automatisch ableiten oder die aktuelle Azure AD-Sitzung verwenden soll. Wenn der Authentifizierungstyp login ist und der Ressourcenhost bereitgestellt wird, wird die Ressourcensuche übersprungen, es sei denn, dies ist erforderlich. Sie können die Standardeinstellung mithilfe von az configure --defaults iotdps-data-auth-type=<auth-type-value>.

Zulässige Werte: key, login
Standardwert: key
--dps-name -n

Name oder Hostname des Azure IoT Hub Device Provisioning Service. Erforderlich, wenn --login nicht angegeben wird.

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

Registrierungsgruppen-ID.

--key --symmetric-key

Der symmetrische gemeinsam genutzte Zugriffsschlüssel für die Registrierungsgruppe. Dadurch wird die Registrierung des Gerätebereitstellungsdiensts umgangen und das SAS-Token direkt aus dem bereitgestellten symmetrischen Schlüssel ohne weitere Überprüfung generiert. Alle anderen Befehlsparameter werden außer der Registrierungs-ID ignoriert.

--login -l

Dieser Befehl unterstützt eine Entität Verbindungszeichenfolge mit Rechten zum Ausführen von Aktionen. Wird verwendet, um die Sitzungsanmeldung über "az login" zu vermeiden. Wenn sowohl eine Entität Verbindungszeichenfolge als auch ein Name angegeben werden, hat die Verbindungszeichenfolge Vorrang. Erforderlich, wenn --dps-name nicht angegeben wird.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot dps enrollment-group create

Erstellen Sie eine Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service.

Geben Sie das Zertifikatformat mithilfe der Base64 ASCII-Codierung an, und das Zertifikat sollte über übereinstimmende BEGIN- und END-Segmente verfügen, z. B. mit "-----BEGIN CERTIFICATE-----" beginnen und mit "-----END CERTIFICATE-----" enden.

az iot dps enrollment-group create --eid
                                   [--allocation-policy {custom, geoLatency, hashed, static}]
                                   [--api-version]
                                   [--auth-type {key, login}]
                                   [--ca-name]
                                   [--certificate-path]
                                   [--dps-name]
                                   [--edge-enabled {false, true}]
                                   [--ih]
                                   [--initial-twin-properties]
                                   [--initial-twin-tags]
                                   [--login]
                                   [--pk]
                                   [--provisioning-status {disabled, enabled}]
                                   [--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
                                   [--resource-group]
                                   [--scn]
                                   [--scp]
                                   [--secondary-key]
                                   [--webhook-url]

Beispiele

Erstellen Sie eine Registrierungsgruppe "{enrollment_id}" im Azure IoT-Bereitstellungsdienst "{dps_name}" in der Ressourcengruppe "{resource_group_name}" mithilfe eines Zwischenzertifikats als primäres Zertifikat.

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

Erstellen Sie eine Registrierungsgruppe "{enrollment_id}" im Azure IoT-Bereitstellungsdienst "{dps_name}" in der Ressourcengruppe "{resource_group_name}" mithilfe eines Zertifizierungsstellenzertifikats {certificate_name} als sekundäres Zertifikat".

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

Erstellen Sie eine Registrierungsgruppe '{enrollment_id}' im Azure IoT-Bereitstellungsdienst 'MyDps' in der Ressourcengruppe '{resource_group_name}' mit dem Bereitstellungsstatus 'enabled', den anfänglichen Zwillingseigenschaften '{"location":{"region":"US"}}' und den anfänglichen Twintags '{"version_dps":"1"}', die ein Zwischenzertifikat als primäres Zertifikat verwenden.

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'}"

Erstellen Sie eine Registrierungsgruppe "{enrollment_id}" im Azure IoT-Bereitstellungsdienst "{dps_name}" in der Ressourcengruppe "{resource_group_name}" mit dem Nachweistyp "symmetrisch".

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}

Erstellen sie eine Registrierungsgruppe "{enrollment_id}" mit benutzerdefinierter Zuordnungsrichtlinie,

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}

Erforderliche Parameter

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

Registrierungsgruppen-ID.

Optionale Parameter

--allocation-policy --ap

Typ der Zuordnungsrichtlinie, um zu bestimmen, wie ein Gerät einem IoT Hub zugewiesen wird. Wenn nicht angegeben, ist die Zuweisungsrichtlinie die aktuelle Standardeinstellung für die Zuordnungsrichtlinie für die Device Provisioning Service-Instanz.

Zulässige Werte: custom, geoLatency, hashed, static
--api-version --av

Die API-Version der Bereitstellungsdiensttypen, die in der benutzerdefinierten Zuordnungsanforderung gesendet werden. Mindestens unterstützte Version: 2018-09-01-preview.

--auth-type

Gibt an, ob der Vorgang einen Richtlinienschlüssel automatisch ableiten oder die aktuelle Azure AD-Sitzung verwenden soll. Wenn der Authentifizierungstyp login ist und der Ressourcenhost bereitgestellt wird, wird die Ressourcensuche übersprungen, es sei denn, dies ist erforderlich. Sie können die Standardeinstellung mithilfe von az configure --defaults iotdps-data-auth-type=<auth-type-value>.

Zulässige Werte: key, login
Standardwert: key
--ca-name --cn --root-ca-name

Der Name des primären Stammzertifizierungsstellenzertifikats. Wenn der Nachweis mit einem Stammzertifizierungsstellenzertifikat gewünscht wird, muss ein Name der Stammzertifizierungsstelle angegeben werden.

--certificate-path --cp

Der Pfad zu der Datei, die das primäre Zertifikat enthält. Wenn der Nachweis mit einem Zwischenzertifikat gewünscht wird, muss ein Zertifikatpfad angegeben werden.

--dps-name -n

Name oder Hostname des Azure IoT Hub Device Provisioning Service. Erforderlich, wenn --login nicht angegeben wird.

--edge-enabled --ee

Flag, das die Randaktivierung angibt.

Zulässige Werte: false, true
Standardwert: False
--ih --iot-hubs

Hostname des IoT Hub-Ziels, das der Zuordnungsrichtlinie zugeordnet ist. Verwenden Sie eine durch Leerzeichen getrennte Liste für mehrere IoT Hubs.

--initial-twin-properties --props

Anfängliche Geräte-Twin-Eigenschaften.

--initial-twin-tags --tags

Erste Geräte-Twin-Tags.

--login -l

Dieser Befehl unterstützt eine Entität Verbindungszeichenfolge mit Rechten zum Ausführen von Aktionen. Wird verwendet, um die Sitzungsanmeldung über "az login" zu vermeiden. Wenn sowohl eine Entität Verbindungszeichenfolge als auch ein Name angegeben werden, hat die Verbindungszeichenfolge Vorrang. Erforderlich, wenn --dps-name nicht angegeben wird.

--pk --primary-key

Der primäre symmetrische gemeinsam genutzte Zugriffsschlüssel, der im Base64-Format gespeichert ist.

--provisioning-status --ps

Aktivieren oder Deaktivieren des Registrierungseintrags.

Zulässige Werte: disabled, enabled
--reprovision-policy --rp

Richtlinie, um zu bestimmen, wie Gerätedaten bei der erneuten Bereitstellung für einen anderen IoT Hub behandelt werden sollen.

Zulässige Werte: never, reprovisionandmigratedata, reprovisionandresetdata
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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

Der Name des sekundären Stammzertifizierungsstellenzertifikats. Wenn der Nachweis mit einem Stammzertifizierungsstellenzertifikat gewünscht wird, muss ein Name der Stammzertifizierungsstelle angegeben werden.

--scp --secondary-certificate-path

Der Pfad zur Datei, die das sekundäre Zertifikat enthält. Wenn der Nachweis mit einem Zwischenzertifikat gewünscht wird, muss ein Zertifikatpfad angegeben werden.

--secondary-key --sk

Der sekundäre symmetrische gemeinsam genutzte Zugriffsschlüssel, der im Base64-Format gespeichert ist.

--webhook-url --wh

Die Azure Function-Webhook-URL, die für benutzerdefinierte Zuordnungsanforderungen verwendet wird.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot dps enrollment-group delete

Löschen Einer Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service.

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

Erforderliche Parameter

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

Registrierungsgruppen-ID.

Optionale Parameter

--auth-type

Gibt an, ob der Vorgang einen Richtlinienschlüssel automatisch ableiten oder die aktuelle Azure AD-Sitzung verwenden soll. Wenn der Authentifizierungstyp login ist und der Ressourcenhost bereitgestellt wird, wird die Ressourcensuche übersprungen, es sei denn, dies ist erforderlich. Sie können die Standardeinstellung mithilfe von az configure --defaults iotdps-data-auth-type=<auth-type-value>.

Zulässige Werte: key, login
Standardwert: key
--dps-name -n

Name oder Hostname des Azure IoT Hub Device Provisioning Service. Erforderlich, wenn --login nicht angegeben wird.

--etag -e

Etag oder Entitätstag, das dem letzten Status der Ressource entspricht. Wenn kein Etag angegeben wird, wird der Wert '*' verwendet.

--login -l

Dieser Befehl unterstützt eine Entität Verbindungszeichenfolge mit Rechten zum Ausführen von Aktionen. Wird verwendet, um die Sitzungsanmeldung über "az login" zu vermeiden. Wenn sowohl eine Entität Verbindungszeichenfolge als auch ein Name angegeben werden, hat die Verbindungszeichenfolge Vorrang. Erforderlich, wenn --dps-name nicht angegeben wird.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot dps enrollment-group list

Auflisten von Registrierungsgruppen in einem Azure IoT Hub Device Provisioning Service.

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

Optionale Parameter

--auth-type

Gibt an, ob der Vorgang einen Richtlinienschlüssel automatisch ableiten oder die aktuelle Azure AD-Sitzung verwenden soll. Wenn der Authentifizierungstyp login ist und der Ressourcenhost bereitgestellt wird, wird die Ressourcensuche übersprungen, es sei denn, dies ist erforderlich. Sie können die Standardeinstellung mithilfe von az configure --defaults iotdps-data-auth-type=<auth-type-value>.

Zulässige Werte: key, login
Standardwert: key
--dps-name -n

Name oder Hostname des Azure IoT Hub Device Provisioning Service. Erforderlich, wenn --login nicht angegeben wird.

--login -l

Dieser Befehl unterstützt eine Entität Verbindungszeichenfolge mit Rechten zum Ausführen von Aktionen. Wird verwendet, um die Sitzungsanmeldung über "az login" zu vermeiden. Wenn sowohl eine Entität Verbindungszeichenfolge als auch ein Name angegeben werden, hat die Verbindungszeichenfolge Vorrang. Erforderlich, wenn --dps-name nicht angegeben wird.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--top

Maximale Anzahl der zurückzugebenden Elemente. Verwenden Sie -1 für unbegrenzt.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot dps enrollment-group show

Rufen Sie die Details einer Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service ab.

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

Beispiele

Grundlegende Verwendung

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

Vollständige Nachweisinformationen in Ergebnisse für eine symmetrische Schlüsselregistrierungsgruppe einschließen

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

Erforderliche Parameter

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

Registrierungsgruppen-ID.

Optionale Parameter

--auth-type

Gibt an, ob der Vorgang einen Richtlinienschlüssel automatisch ableiten oder die aktuelle Azure AD-Sitzung verwenden soll. Wenn der Authentifizierungstyp login ist und der Ressourcenhost bereitgestellt wird, wird die Ressourcensuche übersprungen, es sei denn, dies ist erforderlich. Sie können die Standardeinstellung mithilfe von az configure --defaults iotdps-data-auth-type=<auth-type-value>.

Zulässige Werte: key, login
Standardwert: key
--dps-name -n

Name oder Hostname des Azure IoT Hub Device Provisioning Service. Erforderlich, wenn --login nicht angegeben wird.

--keys --show-keys

Schließen Sie Nachweisschlüssel und Informationen in die Ergebnisse der Registrierungsgruppe ein.

Zulässige Werte: false, true
--login -l

Dieser Befehl unterstützt eine Entität Verbindungszeichenfolge mit Rechten zum Ausführen von Aktionen. Wird verwendet, um die Sitzungsanmeldung über "az login" zu vermeiden. Wenn sowohl eine Entität Verbindungszeichenfolge als auch ein Name angegeben werden, hat die Verbindungszeichenfolge Vorrang. Erforderlich, wenn --dps-name nicht angegeben wird.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot dps enrollment-group update

Aktualisieren einer Registrierungsgruppe in einem Azure IoT Hub Device Provisioning Service.

Geben Sie das Zertifikatformat mithilfe der Base64 ASCII-Codierung an, und das Zertifikat sollte über übereinstimmende BEGIN- und END-Segmente verfügen, z. B. mit "-----BEGIN CERTIFICATE-----" beginnen und mit "-----END CERTIFICATE-----" enden.

az iot dps enrollment-group update --eid
                                   [--allocation-policy {custom, geoLatency, hashed, static}]
                                   [--api-version]
                                   [--auth-type {key, login}]
                                   [--ca-name]
                                   [--certificate-path]
                                   [--dps-name]
                                   [--edge-enabled {false, true}]
                                   [--etag]
                                   [--ih]
                                   [--initial-twin-properties]
                                   [--initial-twin-tags]
                                   [--login]
                                   [--pk]
                                   [--provisioning-status {disabled, enabled}]
                                   [--rc {false, true}]
                                   [--remove-secondary-certificate {false, true}]
                                   [--reprovision-policy {never, reprovisionandmigratedata, reprovisionandresetdata}]
                                   [--resource-group]
                                   [--scn]
                                   [--scp]
                                   [--secondary-key]
                                   [--webhook-url]

Beispiele

Aktualisieren Sie die Registrierungsgruppe "{enrollment_id}" im Azure IoT-Bereitstellungsdienst "{dps_name}" in der Ressourcengruppe "{resource_group_name}" mit anfänglichen Twin-Eigenschaften und anfänglichen Twin-Tags.

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=

Aktualisieren Sie die Registrierungsgruppe "{enrollment_id}" im Azure IoT-Bereitstellungsdienst "{dps_name}" in der Ressourcengruppe "{resource_group_name}" mit neuem primären Zwischenzertifikat, und entfernen Sie vorhandenes sekundäres Zwischenzertifikat.

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=

Aktualisieren Sie die Registrierungsgruppe "{enrollment_id}" im Azure IoT-Bereitstellungsdienst "{dps_name}" in der Ressourcengruppe "{resource_group_name}" mit dem neuen sekundären Zertifizierungsstellenzertifikat "{certificate_name}", und entfernen Sie das vorhandene primäre Zertifizierungsstellenzertifikat.

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=

Aktualisieren Sie die Registrierungsgruppe "{enrollment_id}" im Azure IoT-Bereitstellungsdienst "{dps_name}" in der Ressourcengruppe "{resource_group_name}" mit neuem Primärschlüssel.

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=

Erforderliche Parameter

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

Registrierungsgruppen-ID.

Optionale Parameter

--allocation-policy --ap

Typ der Zuordnungsrichtlinie, um zu bestimmen, wie ein Gerät einem IoT Hub zugewiesen wird. Wenn nicht angegeben, ist die Zuweisungsrichtlinie die aktuelle Standardeinstellung für die Zuordnungsrichtlinie für die Device Provisioning Service-Instanz.

Zulässige Werte: custom, geoLatency, hashed, static
--api-version --av

Die API-Version der Bereitstellungsdiensttypen, die in der benutzerdefinierten Zuordnungsanforderung gesendet werden. Mindestens unterstützte Version: 2018-09-01-preview.

--auth-type

Gibt an, ob der Vorgang einen Richtlinienschlüssel automatisch ableiten oder die aktuelle Azure AD-Sitzung verwenden soll. Wenn der Authentifizierungstyp login ist und der Ressourcenhost bereitgestellt wird, wird die Ressourcensuche übersprungen, es sei denn, dies ist erforderlich. Sie können die Standardeinstellung mithilfe von az configure --defaults iotdps-data-auth-type=<auth-type-value>.

Zulässige Werte: key, login
Standardwert: key
--ca-name --cn --root-ca-name

Der Name des primären Stammzertifizierungsstellenzertifikats. Wenn der Nachweis mit einem Stammzertifizierungsstellenzertifikat gewünscht wird, muss ein Name der Stammzertifizierungsstelle angegeben werden.

--certificate-path --cp

Der Pfad zu der Datei, die das primäre Zertifikat enthält. Wenn der Nachweis mit einem Zwischenzertifikat gewünscht wird, muss ein Zertifikatpfad angegeben werden.

--dps-name -n

Name oder Hostname des Azure IoT Hub Device Provisioning Service. Erforderlich, wenn --login nicht angegeben wird.

--edge-enabled --ee

Flag, das die Randaktivierung angibt.

Zulässige Werte: false, true
--etag -e

Etag oder Entitätstag, das dem letzten Status der Ressource entspricht. Wenn kein Etag angegeben wird, wird der Wert '*' verwendet.

--ih --iot-hubs

Hostname des IoT Hub-Ziels, das der Zuordnungsrichtlinie zugeordnet ist. Verwenden Sie eine durch Leerzeichen getrennte Liste für mehrere IoT Hubs.

--initial-twin-properties --props

Anfängliche Geräte-Twin-Eigenschaften.

--initial-twin-tags --tags

Erste Geräte-Twin-Tags.

--login -l

Dieser Befehl unterstützt eine Entität Verbindungszeichenfolge mit Rechten zum Ausführen von Aktionen. Wird verwendet, um die Sitzungsanmeldung über "az login" zu vermeiden. Wenn sowohl eine Entität Verbindungszeichenfolge als auch ein Name angegeben werden, hat die Verbindungszeichenfolge Vorrang. Erforderlich, wenn --dps-name nicht angegeben wird.

--pk --primary-key

Der primäre symmetrische gemeinsam genutzte Zugriffsschlüssel, der im Base64-Format gespeichert ist.

--provisioning-status --ps

Aktivieren oder Deaktivieren des Registrierungseintrags.

Zulässige Werte: disabled, enabled
--rc --remove-certificate

Flag zum Entfernen des aktuellen primären Zertifikats.

Zulässige Werte: false, true
--remove-secondary-certificate --rsc

Flag zum Entfernen des aktuellen sekundären Zertifikats.

Zulässige Werte: false, true
--reprovision-policy --rp

Richtlinie, um zu bestimmen, wie Gerätedaten bei der erneuten Bereitstellung für einen anderen IoT Hub behandelt werden sollen.

Zulässige Werte: never, reprovisionandmigratedata, reprovisionandresetdata
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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

Der Name des sekundären Stammzertifizierungsstellenzertifikats. Wenn der Nachweis mit einem Stammzertifizierungsstellenzertifikat gewünscht wird, muss ein Name der Stammzertifizierungsstelle angegeben werden.

--scp --secondary-certificate-path

Der Pfad zur Datei, die das sekundäre Zertifikat enthält. Wenn der Nachweis mit einem Zwischenzertifikat gewünscht wird, muss ein Zertifikatpfad angegeben werden.

--secondary-key --sk

Der sekundäre symmetrische gemeinsam genutzte Zugriffsschlüssel, der im Base64-Format gespeichert ist.

--webhook-url --wh

Die Azure Function-Webhook-URL, die für benutzerdefinierte Zuordnungsanforderungen verwendet wird.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.