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
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
ID der Geräteregistrierung.
Optionale Parameter
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>
.
Name oder Hostname des Azure IoT Hub Device Provisioning Service. Erforderlich, wenn --login nicht angegeben wird.
Registrierungsgruppen-ID.
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.
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.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
IoT Hub Device Provisioning Service Name.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
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.
Standort Ihres IoT Hub-Gerätebereitstellungsdiensts. Standardmäßig ist dies der Speicherort Ihrer Zielressourcengruppe.
Preisstufe für den IoT Hub-Gerätebereitstellungsdienst.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Einheiten im IoT Hub-Gerätebereitstellungsdienst.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
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.
IoT Hub Device Provisioning Service Name.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
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.
IoT Hub Device Provisioning Service Name.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
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>
.
Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.
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.
IoT Hub Device Provisioning Service Name.
Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove>
ODER --remove propertyToRemove
.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>
.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.