az iot dps

Verwalten von Device Provisioning Service in Azure IoT Hub

Befehle

az iot dps certificate	Verwalten von Zertifikaten für eine Azure IoT Hub Device Provisioning Service-Instanz.
az iot dps certificate create	Erstellen/Hochladen eines Certficates in eine Azure IoT Hub Device Provisioning Service-Instanz.
az iot dps certificate delete	Löschen Sie ein Zertifikat in einer Azure IoT Hub Device Provisioning Service-Instanz.
az iot dps certificate generate-verification-code	Generieren Sie einen Überprüfungscode für ein Zertifikat in einer Azure IoT Hub Device Provisioning Service-Instanz.
az iot dps certificate list	Listet alle Zertifikate auf, die in einer Azure IoT Hub Device Provisioning Service-Instanz enthalten sind.
az iot dps certificate show	Zeigen Sie Informationen zu einem bestimmten Zertifikat in einer Azure IoT Hub Device Provisioning Service-Instanz an.
az iot dps certificate update	Aktualisieren eines Zertifikats in einer Azure IoT Hub Device Provisioning Service-Instanz.
az iot dps certificate verify	Überprüfen Sie ein Zertifikat in einer Azure IoT Hub Device Provisioning Service-Instanz.
az iot dps compute-device-key	Generieren Sie einen abgeleiteten Geräte-SAS-Schlüssel.
az iot dps connection-string	Verwalten von Verbindungszeichenfolgen für eine Azure IoT Hub Device Provisioning Service-Instanz.
az iot dps connection-string show	Zeigen Sie die Verbindungszeichenfolgen für die angegebene Gerätebereitstellungsdienste mithilfe des angegebenen Richtliniennamens und schlüssels an.
az iot dps create	Erstellen einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps delete	Löschen einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps enrollment	Verwalten sie einzelne Geräteregistrierungen in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps enrollment create	Erstellen Sie eine einzelne Geräteregistrierung in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps enrollment delete	Löschen Sie eine einzelne Geräteregistrierung in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps enrollment list	Listen Sie einzelne Geräteregistrierungen in einem Azure IoT Hub Gerätebereitstellungsdienst auf.
az iot dps enrollment registration	Verwalten von dienstseitigen Geräteregistrierungen für eine einzelne Registrierung in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps enrollment registration delete	Löschen Sie eine Geräteregistrierung für eine einzelne Registrierung in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps enrollment registration show	Rufen Sie eine Geräteregistrierung für eine einzelne Registrierung in einem Azure IoT Hub Gerätebereitstellungsdienst ab.
az iot dps enrollment show	Rufen Sie einzelne Geräteregistrierungsdetails in einem Azure IoT Hub Gerätebereitstellungsdienst ab.
az iot dps enrollment update	Aktualisieren sie eine einzelne Geräteregistrierung in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps enrollment-group	Verwalten von Registrierungsgruppen in einem Azure IoT Hub Gerätebereitstellungsdienst.
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 Gerätebereitstellungsdienst.
az iot dps enrollment-group create	Erstellen Sie eine Registrierungsgruppe in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps enrollment-group delete	Löschen Sie eine Registrierungsgruppe in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps enrollment-group list	Listet Registrierungsgruppen in einem Azure IoT Hub Gerätebereitstellungsdienst auf.
az iot dps enrollment-group registration	Verwalten von dienstseitigen Geräteregistrierungen für eine Registrierungsgruppe in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps enrollment-group registration delete	Löschen Sie eine Geräteregistrierung für eine Registrierungsgruppe in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps enrollment-group registration list	Auflisten von Geräteregistrierungen für eine Registrierungsgruppe in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps enrollment-group registration show	Rufen Sie eine Geräteregistrierung für eine Registrierungsgruppe in einem Azure IoT Hub Gerätebereitstellungsdienst ab.
az iot dps enrollment-group show	Rufen Sie die Details einer Registrierungsgruppe in einem Azure IoT Hub Gerätebereitstellungsdienst ab.
az iot dps enrollment-group update	Aktualisieren einer Registrierungsgruppe in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps linked-hub	Verwalten von verknüpften IoT Hubs in einer Azure IoT Hub Device Provisioning Service-Instanz.
az iot dps linked-hub create	Erstellen eines verknüpften IoT-Hubs in einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps linked-hub delete	Aktualisieren eines verknüpften IoT-Hubs in einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps linked-hub list	Auflisten aller verknüpften IoT-Hubs in einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps linked-hub show	Anzeigen von Details zu einem verknüpften IoT-Hub in einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps linked-hub update	Aktualisieren eines verknüpften IoT-Hubs in einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps list	Auflisten einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps policy	Verwalten von Freigegebenen Zugriffsrichtlinien für eine Azure IoT Hub Gerätebereitstellungsdienstinstanz.
az iot dps policy create	Erstellen einer neuen SAS-Richtlinie in einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps policy delete	Löschen einer SAS-Richtlinie in einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps policy list	Auflisten aller SAS-Richtlinien in einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps policy show	Zeigen Sie Details zu einer freigegebenen Zugriffsrichtlinien in einer Azure IoT Hub Device Provisioning Service-Instanz an.
az iot dps policy update	Aktualisieren einer SAS-Richtlinie in einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps registration	Verwalten von Geräteregistrierungen für eine Registrierungsgruppe in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps registration delete	Löschen Sie eine Geräteregistrierung in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps registration list	Auflisten von Geräteregistrierungen für eine Registrierungsgruppe in einem Azure IoT Hub Gerätebereitstellungsdienst.
az iot dps registration show	Rufen Sie eine Geräteregistrierung für eine Registrierungsgruppe in einem Azure IoT Hub Gerätebereitstellungsdienst ab.
az iot dps show	Abrufen der Details einer Azure IoT Hub Device Provisioning Service-Instanz
az iot dps update	Aktualisieren einer Azure IoT Hub Device Provisioning Service-Instanz

az iot dps compute-device-key

Generieren Sie einen abgeleiteten Geräte-SAS-Schlüssel.

Generieren Sie einen abgeleiteten Geräteschlüssel für eine DPS-Registrierungsgruppe.

az iot dps 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 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 compute-device-key -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --registration-id {registration_id}

Erforderliche Parameter

--registration-id

ID der Geräteregistrierung.

Optionale Parameter

--auth-type

Gibt an, ob der Vorgang einen Richtlinienschlüssel automatisch abgeleitet oder die aktuelle Azure AD-Sitzung verwenden soll. Sie können die Standardeinstellung mithilfe az configure --defaults iotdps-data-auth-type=<auth-type-value>von .

Zulässige Werte: key, login

Standardwert: key

--dps-name -n

Name des Azure IoT Hub Gerätebereitstellungsdiensts. Erforderlich, wenn die Anmeldung nicht bereitgestellt wird.

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

Registrierungsgruppen-ID.

--key --symmetric-key

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

--login -l

Dieser Befehl unterstützt eine Entitätsverbindungszeichenfolge mit Rechten zum Ausführen von Aktionen. Verwenden Sie die Verwendung, um die Sitzungsanmeldung über "az login" zu vermeiden. Wenn sowohl eine Entitätsverbindungszeichenfolge als auch ein Name bereitgestellt werden, wird die Verbindungszeichenfolge vorrangig verwendet. Erforderlich, wenn --dps-name nicht bereitgestellt 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.

--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 create

Erstellen einer Azure IoT Hub Device Provisioning Service-Instanz

Eine Einführung in den Azure IoT Hub Gerätebereitstellungsdienst finden Sie unter https://docs.microsoft.com/azure/iot-dps/about-iot-dps.

az iot dps create --name
                  --resource-group
                  [--edr {false, true}]
                  [--location]
                  [--sku {S1}]
                  [--tags]
                  [--unit]

Beispiele

Erstellen Sie einen Azure IoT Hub Gerätebereitstellungsdienst mit der Standardpreisstufe S1 in der Region der Ressourcengruppe.

az iot dps create --name MyDps --resource-group MyResourceGroup

Erstellen Sie einen Azure IoT Hub Gerätebereitstellungsdienst mit der Standardpreisstufe S1 in der Region "ostus".

az iot dps create --name MyDps --resource-group MyResourceGroup --location eastus

Erstellen Sie einen Azure IoT Hub Gerätebereitstellungsdienst mit erzwungener Datenverwaltung. Dadurch wird die notfallübergreifende Notfallwiederherstellung deaktiviert.

az iot dps create --name MyDps --resource-group MyResourceGroup --edr

Erforderliche Parameter

--name -n

IoT Hub Gerätebereitstellungsdienstname.

--resource-group -g

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

Optionale Parameter

--edr --enforce-data-residency

Erzwingen Sie die Datenverwaltung für diesen IoT Hub Gerätebereitstellungsdienst, indem Sie die Notfallwiederherstellung für das geo-Paar deaktivieren. Diese Eigenschaft ist unveränderlich, sobald sie auf der Ressource festgelegt ist. Nur in ausgewählten Regionen verfügbar. Weitere Informationen finden Sie unter https://aka.ms/dpsdr.

Zulässige Werte: false, true

--location -l

Speicherort des IoT Hub Gerätebereitstellungsdiensts. Standardmäßig ist dies der Speicherort Ihrer Zielressourcengruppe.

--sku

Preisstufe für den IoT Hub Gerätebereitstellungsdienst.

Zulässige Werte: S1

Standardwert: S1

--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--unit

Einheiten in Ihrem IoT Hub Gerätebereitstellungsdienst.

Standardwert: 1

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.

--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 delete

Löschen einer Azure IoT Hub Device Provisioning Service-Instanz

az iot dps delete [--ids]
                  [--name]
                  [--resource-group]

Beispiele

Löschen eines Azure IoT Hub Gerätebereitstellungsdiensts "MyDps"

az iot dps delete --name MyDps --resource-group MyResourceGroup

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

IoT Hub Gerätebereitstellungsdienstname.

--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.

--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 list

Auflisten einer Azure IoT Hub Device Provisioning Service-Instanz

az iot dps list [--resource-group]

Beispiele

Alle Azure IoT Hub Gerätebereitstellungsdienste in einem Abonnement auflisten.

az iot dps list

Alle Azure IoT Hub Gerätebereitstellungsdienste in der Ressourcengruppe "MyResourceGroup" auflisten

az iot dps list --resource-group MyResourceGroup

Optionale Parameter

--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.

--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 show

Abrufen der Details einer Azure IoT Hub Device Provisioning Service-Instanz

az iot dps show [--ids]
                [--name]
                [--resource-group]

Beispiele

Details eines Azure IoT Hub Gerätebereitstellungsdiensts "MyDps" anzeigen

az iot dps show --name MyDps --resource-group MyResourceGroup

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

IoT Hub Gerätebereitstellungsdienstname.

--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.

--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 update

Aktualisieren einer Azure IoT Hub Device Provisioning Service-Instanz

az iot dps update [--add]
                  [--force-string]
                  [--ids]
                  [--name]
                  [--remove]
                  [--resource-group]
                  [--set]
                  [--tags]

Beispiele

Aktualisieren der Zuordnungsrichtlinie auf "GeoLatency" eines Azure IoT Hub Gerätebereitstellungsdiensts "MyDps"

az iot dps update --name MyDps --resource-group MyResourceGroup --set properties.allocationPolicy="GeoLatency"

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

IoT Hub Gerätebereitstellungsdienstname.

--remove

Entfernen einer Eigenschaft oder eines Elements aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftspfad und einen festzulegenden Wert angeben. Beispiel: --set property1.property2=.

--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

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.

--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.