az iot dps

Hinweis

Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Weitere Informationen zu Erweiterungen

Verwalten von Device Provisioning Service in Azure IoT Hub

Befehle

Name Beschreibung Typ Status
az iot dps certificate

Verwalten von Zertifikaten für eine Azure IoT Hub Device Provisioning Service-Instanz.

Core Allgemein verfügbar
az iot dps certificate create

Erstellen/Hochladen eines Zertifikats in eine Azure IoT Hub Device Provisioning Service-Instanz.

Core Allgemein verfügbar
az iot dps certificate delete

Löschen eines Zertifikats in einer Azure IoT Hub Device Provisioning Service-Instanz.

Core Allgemein verfügbar
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.

Core Allgemein verfügbar
az iot dps certificate list

Listet alle Zertifikate auf, die in einer Azure IoT Hub Device Provisioning Service-Instanz enthalten sind.

Core Allgemein verfügbar
az iot dps certificate show

Zeigen Sie Informationen zu einem bestimmten Zertifikat in einer Azure IoT Hub Device Provisioning Service-Instanz an.

Core Allgemein verfügbar
az iot dps certificate update

Aktualisieren eines Zertifikats in einer Azure IoT Hub Device Provisioning Service-Instanz.

Core Allgemein verfügbar
az iot dps certificate verify

Überprüfen Sie ein Zertifikat in einer Azure IoT Hub Device Provisioning Service-Instanz.

Core Allgemein verfügbar
az iot dps compute-device-key

Generieren Eines abgeleiteten Geräte-SAS-Schlüssels.

Erweiterung Veraltet
az iot dps connection-string

Verwalten sie Verbindungszeichenfolge s für eine Azure IoT Hub Device Provisioning Service-Instanz.

Erweiterung Allgemein verfügbar
az iot dps connection-string show

Zeigen Sie die Verbindungszeichenfolge für die angegebenen Gerätebereitstellungsdienste mithilfe des angegebenen Richtliniennamens und Schlüssels an.

Erweiterung Allgemein verfügbar
az iot dps create

Erstellen einer Azure IoT Hub Device Provisioning Service-Instanz

Core Allgemein verfügbar
az iot dps delete

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

Core Allgemein verfügbar
az iot dps enrollment

Verwalten sie einzelne Geräteregistrierungen in einem Azure IoT Hub-Gerätebereitstellungsdienst.

Erweiterung Allgemein verfügbar
az iot dps enrollment-group

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Erweiterung Allgemein verfügbar
az iot dps enrollment create

Erstellen Sie eine einzelne Geräteregistrierung in einem Azure IoT Hub Device Provisioning Service.

Erweiterung Allgemein verfügbar
az iot dps enrollment delete

Löschen Einer einzelnen Geräteregistrierung in einem Azure IoT Hub Device Provisioning Service.

Erweiterung Allgemein verfügbar
az iot dps enrollment list

Auflisten einzelner Geräteregistrierungen in einem Azure IoT Hub Device Provisioning Service.

Erweiterung Allgemein verfügbar
az iot dps enrollment registration

Verwalten Sie dienstseitige Geräteregistrierungen für eine einzelne Registrierung in einem Azure IoT Hub Device Provisioning Service.

Erweiterung Allgemein verfügbar
az iot dps enrollment registration delete

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

Erweiterung Allgemein verfügbar
az iot dps enrollment registration show

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

Erweiterung Allgemein verfügbar
az iot dps enrollment show

Abrufen einzelner Geräteregistrierungsdetails in einem Azure IoT Hub Device Provisioning Service.

Erweiterung Allgemein verfügbar
az iot dps enrollment update

Aktualisieren einer einzelnen Geräteregistrierung in einem Azure IoT Hub-Gerätebereitstellungsdienst.

Erweiterung Allgemein verfügbar
az iot dps linked-hub

Verwalten sie verknüpfte IoT Hubs in einer Azure IoT Hub Device Provisioning Service-Instanz.

Core Allgemein verfügbar
az iot dps linked-hub create

Erstellen eines verknüpften IoT-Hubs in einer Azure IoT Hub Device Provisioning Service-Instanz

Core Allgemein verfügbar
az iot dps linked-hub delete

Aktualisieren eines verknüpften IoT-Hubs in einer Azure IoT Hub Device Provisioning Service-Instanz

Core Allgemein verfügbar
az iot dps linked-hub list

Auflisten aller verknüpften IoT-Hubs in einer Azure IoT Hub Device Provisioning Service-Instanz

Core Allgemein verfügbar
az iot dps linked-hub show

Anzeigen von Details zu einem verknüpften IoT-Hub in einer Azure IoT Hub Device Provisioning Service-Instanz

Core Allgemein verfügbar
az iot dps linked-hub update

Aktualisieren eines verknüpften IoT-Hubs in einer Azure IoT Hub Device Provisioning Service-Instanz

Core Allgemein verfügbar
az iot dps list

Auflisten einer Azure IoT Hub Device Provisioning Service-Instanz

Core Allgemein verfügbar
az iot dps policy

Verwalten sie freigegebene Zugriffsrichtlinien für eine Azure IoT Hub Device Provisioning Service-Instanz.

Core Allgemein verfügbar
az iot dps policy create

Erstellen einer neuen SAS-Richtlinie in einer Azure IoT Hub Device Provisioning Service-Instanz

Core Allgemein verfügbar
az iot dps policy delete

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

Core Allgemein verfügbar
az iot dps policy list

Auflisten aller SAS-Richtlinien in einer Azure IoT Hub Device Provisioning Service-Instanz

Core Allgemein verfügbar
az iot dps policy show

Zeigen Sie Details zu einer Freigegebenen Zugriffsrichtlinien in einer Azure IoT Hub Device Provisioning Service-Instanz an.

Core Allgemein verfügbar
az iot dps policy update

Aktualisieren einer SAS-Richtlinie in einer Azure IoT Hub Device Provisioning Service-Instanz

Core Allgemein verfügbar
az iot dps registration

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

Erweiterung Veraltet
az iot dps registration delete

Löschen einer Geräteregistrierung in einem Azure IoT Hub Device Provisioning Service.

Erweiterung Veraltet
az iot dps registration list

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

Erweiterung Veraltet
az iot dps registration show

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

Erweiterung Veraltet
az iot dps show

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

Core Allgemein verfügbar
az iot dps update

Aktualisieren einer Azure IoT Hub Device Provisioning Service-Instanz

Core Allgemein verfügbar

az iot dps compute-device-key

Als veraltet markiert

Dieser Befehl ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "iot dps enrollment-group compute-device-key".

Generieren Eines abgeleiteten Geräte-SAS-Schlüssels.

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

Erstellen einer Azure IoT Hub Device Provisioning Service-Instanz

Eine Einführung in den Azure IoT Hub Device Provisioning Service 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 "eastus".

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

Erstellen Sie einen Azure IoT Hub-Gerätebereitstellungsdienst mit erzwungener Datenaufbewahrung. Dadurch wird die regionsübergreifende Notfallwiederherstellung deaktiviert.

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

Erforderliche Parameter

--name -n

IoT Hub Device Provisioning Service Name.

--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 Datenaufbewahrung für diesen IoT Hub-Gerätebereitstellungsdienst, indem Sie die cross-geo-pair-Notfallwiederherstellung deaktivieren. Diese Eigenschaft ist unveränderlich, sobald sie für die Ressource festgelegt wurde. Nur in ausgewählten Regionen verfügbar. Weitere Informationen finden Sie unter https://aka.ms/dpsdr.

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

Standort Ihres 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

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

--unit

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

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 delete

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

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

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). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

IoT Hub Device Provisioning Service Name.

--resource-group -g

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

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

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 list

Auflisten einer Azure IoT Hub Device Provisioning Service-Instanz

az iot dps list [--resource-group]

Beispiele

Auflisten aller Azure IoT Hub-Gerätebereitstellungsdienste in einem Abonnement.

az iot dps list

Auflisten aller Azure IoT Hub-Gerätebereitstellungsdienste in der Ressourcengruppe "MyResourceGroup"

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.

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 show

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

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

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). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

IoT Hub Device Provisioning Service Name.

--resource-group -g

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

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

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 update

Aktualisieren einer Azure IoT Hub Device Provisioning Service-Instanz

az iot dps update [--add]
                  [--force-string]
                  [--ids]
                  [--name]
                  [--remove]
                  [--resource-group]
                  [--set]
                  [--subscription]
                  [--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>.

Standardwert: []
--force-string

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

Standardwert: False
--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

IoT Hub Device Provisioning Service Name.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--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 festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
--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.

--tags

Durch Leerzeichen getrennte 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.

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.