az iot hub

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. Erfahren Sie mehr über Erweiterungen.

Verwalten von Azure-IoT-Hubs

Befehle

Name	Beschreibung	Typ	Status
az iot hub certificate	Verwalten von IoT Hub-Zertifikaten.	Kern	GA
az iot hub certificate create	Erstellen/Hochladen eines Azure IoT Hub-Zertifikats.	Kern	GA
az iot hub certificate delete	Löscht ein Azure IoT Hub-Zertifikat.	Kern	GA
az iot hub certificate generate-verification-code	Generiert einen Überprüfungscode für ein Azure IoT Hub-Zertifikat.	Kern	GA
az iot hub certificate list	Listet alle Zertifikate auf, die in einem Azure IoT Hub enthalten sind.	Kern	GA
az iot hub certificate show	Zeigt Informationen zu einem bestimmten Azure IoT Hub-Zertifikat an.	Kern	GA
az iot hub certificate update	Aktualisieren Sie ein Azure IoT Hub-Zertifikat.	Kern	GA
az iot hub certificate verify	Überprüft ein Azure IoT Hub-Zertifikat.	Kern	GA
az iot hub configuration	Verwalten Sie die Konfiguration für die automatische Verwaltung von IoT-Geräten im großen Stil.	Erweiterung	GA
az iot hub configuration create	Erstellen Sie eine automatische IoT-Geräteverwaltungskonfiguration in einem IoT-Ziel-IoT-Hub.	Erweiterung	GA
az iot hub configuration delete	Löschen sie eine IoT-Gerätekonfiguration.	Erweiterung	GA
az iot hub configuration list	Auflisten der automatischen Geräteverwaltungskonfigurationen in einem IoT-Hub.	Erweiterung	GA
az iot hub configuration show	Rufen Sie die Details einer automatischen IoT-Geräteverwaltungskonfiguration ab.	Erweiterung	GA
az iot hub configuration show-metric	Bewerten einer Zielbenutzer- oder Systemmetrik, die in einer IoT-Gerätekonfiguration definiert ist.	Erweiterung	GA
az iot hub configuration update	Aktualisieren Sie die angegebenen Eigenschaften einer automatischen IoT-Geräteverwaltungskonfiguration.	Erweiterung	GA
az iot hub connection-string	Verwalten von IoT Hub-Verbindungszeichenfolge s.	Erweiterung	GA
az iot hub connection-string show	Zeigen Sie die Verbindungszeichenfolge für die angegebenen IoT Hubs mithilfe des angegebenen Richtliniennamens und Schlüssels an.	Erweiterung	GA
az iot hub consumer-group	Verwalten sie die Event Hub-Consumergruppen eines IoT-Hubs.	Kern	GA
az iot hub consumer-group create	Erstellen Sie eine Event Hub-Consumergruppe.	Kern	GA
az iot hub consumer-group delete	Löschen sie eine Event Hub-Consumergruppe.	Kern	GA
az iot hub consumer-group list	Auflisten von Event Hub-Consumergruppen.	Kern	GA
az iot hub consumer-group show	Rufen Sie die Details für eine Event Hub-Consumergruppe ab.	Kern	GA
az iot hub create	Erstellen Sie einen Azure IoT-Hub.	Kern	GA
az iot hub delete	Löschen Sie einen IoT-Hub.	Kern	GA
az iot hub device-identity	Verwalten von IoT-Geräten.	Erweiterung	GA
az iot hub device-identity children	Verwalten von untergeordneten Gerätebeziehungen für IoT-Edgegeräte.	Erweiterung	GA
az iot hub device-identity children add	Fügen Sie Geräte als untergeordnete Geräte zu einem Ziel-Edgegerät hinzu.	Erweiterung	GA
az iot hub device-identity children list	Gibt die Auflistung der zugewiesenen untergeordneten Geräte aus.	Erweiterung	GA
az iot hub device-identity children remove	Entfernen sie untergeordnete Geräte von einem Ziel-Edgegerät.	Erweiterung	GA
az iot hub device-identity connection-string	Verwalten sie die Verbindungszeichenfolge des IoT-Geräts.	Erweiterung	GA
az iot hub device-identity connection-string show	Anzeigen eines bestimmten IoT Hub-Geräts Verbindungszeichenfolge.	Erweiterung	GA
az iot hub device-identity create	Erstellen Sie ein Gerät in einem IoT Hub.	Erweiterung	GA
az iot hub device-identity delete	Löschen Sie ein IoT Hub-Gerät.	Erweiterung	GA
az iot hub device-identity export	Exportieren Sie alle Geräteidentitäten aus einem IoT Hub in einen Azure Storage-BLOB-Container.	Erweiterung	GA
az iot hub device-identity import	Importieren von Geräteidentitäten in einen IoT Hub aus einem Speichercontainer-BLOB.	Erweiterung	GA
az iot hub device-identity list	Auflisten von Geräten in einem IoT Hub.	Erweiterung	GA
az iot hub device-identity parent	Verwalten sie übergeordnete Gerätebeziehungen für IoT-Geräte.	Erweiterung	GA
az iot hub device-identity parent set	Legen Sie das übergeordnete Gerät eines Zielgeräts fest.	Erweiterung	GA
az iot hub device-identity parent show	Rufen Sie das übergeordnete Gerät eines Zielgeräts ab.	Erweiterung	GA
az iot hub device-identity renew-key	Verlängern Sie Zielschlüssel von IoT Hub-Geräten mit sas-Authentifizierung.	Erweiterung	GA
az iot hub device-identity show	Rufen Sie die Details eines IoT Hub-Geräts ab.	Erweiterung	GA
az iot hub device-identity update	Aktualisieren sie ein IoT Hub-Gerät.	Erweiterung	GA
az iot hub device-twin	Verwalten der Konfiguration von IoT-Gerätezwillingen.	Erweiterung	GA
az iot hub device-twin list	Auflisten von Geräte twins in einem IoT Hub.	Erweiterung	GA
az iot hub device-twin replace	Ersetzen Sie die Geräte-Twin-Definition durch die Ziel-JSON.	Erweiterung	GA
az iot hub device-twin show	Rufen Sie eine Twin-Definition des Geräts ab.	Erweiterung	GA
az iot hub device-twin update	Aktualisieren sie die gewünschten Geräteeigenschaften und -tags.	Erweiterung	GA
az iot hub devicestream	Verwalten von Gerätestreams einer IoT Hub-Instanz.	Kern	Vorschau
az iot hub devicestream show	Rufen Sie die Gerätestreams von IoT Hub-Endpunkten ab.	Kern	Vorschau
az iot hub digital-twin	Bearbeiten und interagieren Sie mit dem digitalen Zwilling eines IoT Hub-Geräts.	Erweiterung	GA
az iot hub digital-twin invoke-command	Rufen Sie einen Befehl auf Stamm- oder Komponentenebene eines digitalen Twin-Geräts auf.	Erweiterung	GA
az iot hub digital-twin show	Zeigen Sie den digitalen Zwilling eines IoT Hub-Geräts an.	Erweiterung	GA
az iot hub digital-twin update	Aktualisieren Sie die Lese-/Schreibeigenschaften eines digitalen Twin-Geräts über die JSON-Patchspezifikation.	Erweiterung	GA
az iot hub distributed-tracing	Verwalten verteilter Einstellungen pro Gerät.	Erweiterung	Vorschau
az iot hub distributed-tracing show	Rufen Sie die verteilten Ablaufverfolgungseinstellungen für ein Gerät ab.	Erweiterung	Vorschau
az iot hub distributed-tracing update	Aktualisieren Sie die verteilten Ablaufverfolgungsoptionen für ein Gerät.	Erweiterung	Vorschau
az iot hub generate-sas-token	Generieren Sie ein SAS-Token für einen IoT-Hub, ein Gerät oder ein Zielmodul.	Erweiterung	GA
az iot hub identity	Verwalten von Identitäten eines Azure IoT-Hubs.	Kern	GA
az iot hub identity assign	Weisen Sie verwaltete Identitäten einem IoT-Hub zu.	Kern	GA
az iot hub identity remove	Entfernt verwaltete Identitäten aus einem IoT Hub.	Kern	GA
az iot hub identity show	Zeigen Sie die Identitätseigenschaften eines IoT Hub an.	Kern	GA
az iot hub invoke-device-method	Rufen Sie eine Gerätemethode auf.	Erweiterung	GA
az iot hub invoke-module-method	Aufrufen einer Modulmethode.	Erweiterung	GA
az iot hub job	Verwalten von IoT Hub-Aufträgen (v2).	Erweiterung	GA
az iot hub job cancel	Abbrechen eines IoT Hub-Auftrags.	Erweiterung	GA
az iot hub job create	Erstellen und Planen eines IoT Hub-Auftrags für die Ausführung.	Erweiterung	GA
az iot hub job list	Listet die historischen Aufträge eines IoT Hub auf.	Erweiterung	GA
az iot hub job show	Zeigen Sie Details eines vorhandenen IoT Hub-Auftrags an.	Erweiterung	GA
az iot hub list	Auflisten von IoT-Hubs.	Kern	GA
az iot hub list-skus	Auflisten der verfügbaren Tarife.	Kern	GA
az iot hub manual-failover	Initiieren eines manuellen Failovers für die IoT Hub-Instanz in die geografisch gekoppelte Notfallwiederherstellungsregion.	Kern	GA
az iot hub message-endpoint	Verwalten benutzerdefinierter Endpunkte einer IoT Hub-Instanz.	Erweiterung	Vorschau
az iot hub message-endpoint create	Fügen Sie einen Endpunkt zu einem IoT Hub hinzu.	Erweiterung	Vorschau
az iot hub message-endpoint create cosmosdb-container	Fügen Sie einen Cosmos DB-Containerendpunkt für einen IoT Hub hinzu.	Erweiterung	Vorschau
az iot hub message-endpoint create eventhub	Fügen Sie einen Event Hub-Endpunkt für einen IoT Hub hinzu.	Erweiterung	Vorschau
az iot hub message-endpoint create servicebus-queue	Fügen Sie einen Service Bus Queue-Endpunkt für einen IoT Hub hinzu.	Erweiterung	Vorschau
az iot hub message-endpoint create servicebus-topic	Fügen Sie einen Service Bus Topic-Endpunkt für einen IoT-Hub hinzu.	Erweiterung	Vorschau
az iot hub message-endpoint create storage-container	Fügen Sie einen Speichercontainer-Endpunkt für einen IoT Hub hinzu.	Erweiterung	Vorschau
az iot hub message-endpoint delete	Löschen Sie alle oder einen bestimmten Endpunkt für einen IoT Hub.	Erweiterung	Vorschau
az iot hub message-endpoint list	Abrufen von Informationen zu allen Endpunkten für einen IoT Hub.	Erweiterung	Vorschau
az iot hub message-endpoint show	Rufen Sie Informationen zum erwähnten Endpunkt für einen IoT Hub ab.	Erweiterung	Vorschau
az iot hub message-endpoint update	Aktualisieren Sie die Eigenschaften eines vorhandenen Endpunkts für einen IoT Hub.	Erweiterung	Vorschau
az iot hub message-endpoint update cosmosdb-container	Aktualisieren Sie die Eigenschaften eines vorhandenen Cosmos DB-Containerendpunkts für einen IoT Hub.	Erweiterung	Vorschau
az iot hub message-endpoint update eventhub	Aktualisieren Sie die Eigenschaften eines vorhandenen Event Hub-Endpunkts für einen IoT Hub.	Erweiterung	Vorschau
az iot hub message-endpoint update servicebus-queue	Aktualisieren Sie die Eigenschaften eines vorhandenen Service Bus Queue-Endpunkts für einen IoT Hub.	Erweiterung	Vorschau
az iot hub message-endpoint update servicebus-topic	Aktualisieren sie die Eigenschaften eines vorhandenen ServiceBus-Themenendpunkts für einen IoT Hub.	Erweiterung	Vorschau
az iot hub message-endpoint update storage-container	Aktualisieren Sie die Eigenschaften eines vorhandenen Speichercontainer-Endpunkts für einen IoT Hub.	Erweiterung	Vorschau
az iot hub message-enrichment	Verwalten von Nachrichtenanreicherungen für Endpunkte einer IoT Hub-Instanz.	Kern	GA
az iot hub message-enrichment create	Erstellen Sie eine Nachrichtenerweiterung für ausgewählte Endpunkte in Ihrem IoT Hub.	Kern	GA
az iot hub message-enrichment delete	Löschen Sie eine Nachrichtenerweiterung in Ihrem IoT-Hub (nach Schlüssel).	Kern	GA
az iot hub message-enrichment list	Erhalten Sie Informationen zu allen Nachrichtenanreicherungen für Ihren IoT Hub.	Kern	GA
az iot hub message-enrichment update	Aktualisieren Sie eine Nachrichtenerweiterung in Ihrem IoT-Hub (nach Schlüssel).	Kern	GA
az iot hub message-route	Verwalten von Routen einer IoT Hub-Instanz.	Erweiterung	Vorschau
az iot hub message-route create	Fügen Sie eine Route für einen IoT-Hub hinzu.	Erweiterung	Vorschau
az iot hub message-route delete	Löschen Sie alle Routen oder eine erwähnte Route in einem IoT Hub.	Erweiterung	Vorschau
az iot hub message-route fallback	Verwalten Sie die Fallbackroute eines IoT-Hubs.	Erweiterung	Vorschau
az iot hub message-route fallback set	Aktivieren oder deaktivieren Sie die Fallbackroute in einem IoT Hub.	Erweiterung	Vorschau
az iot hub message-route fallback show	Zeigen Sie die Fallbackroute eines IoT Hub an.	Erweiterung	Vorschau
az iot hub message-route list	Rufen Sie alle Routen in einem IoT Hub ab.	Erweiterung	Vorschau
az iot hub message-route show	Rufen Sie Informationen zur Route in einem IoT Hub ab.	Erweiterung	Vorschau
az iot hub message-route test	Testen Sie alle Routen oder eine erwähnte Route in einem IoT Hub.	Erweiterung	Vorschau
az iot hub message-route update	Aktualisieren einer Route für einen IoT-Hub.	Erweiterung	Vorschau
az iot hub module-identity	Verwalten von IoT-Gerätemodulen.	Erweiterung	GA
az iot hub module-identity connection-string	Verwalten sie die Verbindungszeichenfolge des IoT-Gerätemoduls.	Erweiterung	GA
az iot hub module-identity connection-string show	Anzeigen eines Ziel-IoT-Gerätemoduls Verbindungszeichenfolge.	Erweiterung	GA
az iot hub module-identity create	Erstellen Sie ein Modul auf einem IoT-Zielgerät in einem IoT-Hub.	Erweiterung	GA
az iot hub module-identity delete	Löschen eines Geräts in einem IoT-Hub.	Erweiterung	GA
az iot hub module-identity list	Auflisten von Modulen auf einem IoT-Gerät in einem IoT-Hub.	Erweiterung	GA
az iot hub module-identity renew-key	Verlängern Sie Zielschlüssel von IoT Hub-Gerätemodulen mit sas-Authentifizierung.	Erweiterung	GA
az iot hub module-identity show	Rufen Sie die Details eines IoT-Gerätemoduls in einem IoT-Hub ab.	Erweiterung	GA
az iot hub module-identity update	Aktualisieren Sie ein IoT Hub-Gerätemodul.	Erweiterung	GA
az iot hub module-twin	Verwalten der Konfiguration von IoT-Modulgerätezwillingen.	Erweiterung	GA
az iot hub module-twin replace	Ersetzen Sie eine Twin-Definition eines Moduls durch die Ziel-JSON.	Erweiterung	GA
az iot hub module-twin show	Zeigen Sie eine Twin-Definition des Moduls an.	Erweiterung	GA
az iot hub module-twin update	Aktualisieren Sie die zwillingswilligen Eigenschaften und Tags des Moduls.	Erweiterung	GA
az iot hub monitor-events	Überwachen von Gerätetelemetrie und Nachrichten, die an einen IoT Hub gesendet werden.	Erweiterung	GA
az iot hub monitor-feedback	Überwachen des von Geräten gesendeten Feedbacks, um Cloud-zu-Gerät--Nachrichten (C2D) zu bestätigen.	Erweiterung	GA
az iot hub policy	Verwalten von Richtlinien für gemeinsamen Zugriff einer IoT Hub-Instanz.	Kern	GA
az iot hub policy create	Erstellen Sie eine neue Richtlinie für den freigegebenen Zugriff in einem IoT-Hub.	Kern	GA
az iot hub policy delete	Löschen Sie eine Richtlinie für den freigegebenen Zugriff von einem IoT-Hub.	Kern	GA
az iot hub policy list	Auflisten von Freigegebenen Zugriffsrichtlinien eines IoT-Hubs.	Kern	GA
az iot hub policy renew-key	Generieren Sie Schlüssel einer freigegebenen Zugriffsrichtlinie eines IoT-Hubs neu.	Kern	GA
az iot hub policy show	Rufen Sie die Details einer Freigegebenen Zugriffsrichtlinie eines IoT-Hubs ab.	Kern	GA
az iot hub query	Abfragen eines IoT Hub mithilfe einer leistungsfähigen SQL-ähnlichen Sprache.	Erweiterung	GA
az iot hub show	Rufen Sie die Details eines IoT-Hubs ab.	Kern	GA
az iot hub show-quota-metrics	Rufen Sie die Kontingentmetriken für einen IoT-Hub ab.	Kern	GA
az iot hub show-stats	Rufen Sie die Statistiken für einen IoT-Hub ab.	Kern	GA
az iot hub state	Verwalten Sie den Status eines IoT-Hubs.	Erweiterung	Experimentell
az iot hub state export	Exportieren Sie den Status eines IoT Hub in eine Datei.	Erweiterung	Experimentell
az iot hub state import	Importieren Sie einen Hubstatus aus einer Datei in einen IoT Hub.	Erweiterung	Experimentell
az iot hub state migrate	Migrieren Sie den Status eines Hubs zu einem anderen Hub, ohne in einer Datei zu speichern.	Erweiterung	Experimentell
az iot hub update	Aktualisieren von Metadaten für einen IoT-Hub.	Kern	GA
az iot hub wait	Warten Sie, bis ein Vorgang für eine IoT Hub-Instanz abgeschlossen ist.	Kern	GA

az iot hub create

Erstellen Sie einen Azure IoT-Hub.

Eine Einführung in Azure IoT Hub finden Sie unter https://learn.microsoft.com/azure/iot-hub/.

az iot hub create --name
                  --resource-group
                  [--c2d-max-delivery-count]
                  [--c2d-ttl]
                  [--dds {false, true}]
                  [--disable-local-auth {false, true}]
                  [--disable-module-sas {false, true}]
                  [--edr {false, true}]
                  [--fc]
                  [--fcs]
                  [--fd]
                  [--feedback-lock-duration]
                  [--feedback-ttl]
                  [--fileupload-notification-lock-duration]
                  [--fileupload-notification-max-delivery-count]
                  [--fileupload-notification-ttl]
                  [--fileupload-notifications {false, true}]
                  [--fileupload-sas-ttl]
                  [--fileupload-storage-auth-type {identityBased, keyBased}]
                  [--fileupload-storage-identity]
                  [--location]
                  [--mi-system-assigned {false, true}]
                  [--mi-user-assigned]
                  [--min-tls-version]
                  [--no-wait]
                  [--partition-count]
                  [--rd]
                  [--role]
                  [--scopes]
                  [--sku {B1, B2, B3, F1, S1, S2, S3}]
                  [--tags]
                  [--unit]

Beispiele

Erstellen Sie einen IoT Hub mit der kostenlosen Preisstufe F1 in der Region der Ressourcengruppe.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --sku F1 --partition-count 2

Erstellen Sie einen IoT Hub mit den Standard-Preisstufen S1 und 4 Partitionen in der Region "westus" mit Tags.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --tags a=b c=d

Erstellen Sie einen IoT Hub mit einer vom System zugewiesenen verwalteten Identität, und weisen Sie einem Speicherkonto für die erstellte Identität eine Rolle und einen Bereich zu.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --mi-system-assigned --role "Storage Blob Data Contributor" --scopes {resourceId}

Erstellen eines IoT-Hubs mit lokaler Authentifizierung, SAS-Schlüsseln des Geräts und Modul-SAS-Schlüsseln, die alle deaktiviert sind

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --disable-local-auth --disable-device-sas --disable-module-sas

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

az iot hub create --resource-group MyResourceGroup --name MyIoTHub --edr

Erforderliche Parameter

--name -n

IoT Hub-Name.

--resource-group -g

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

Optionale Parameter

--c2d-max-delivery-count --cdd

Die Häufigkeit, mit der der IoT-Hub versucht, eine Cloud-to-Device-Nachricht an ein Gerät zwischen 1 und 100 zu übermitteln.

Standardwert: 10

--c2d-ttl --ct

Der Zeitraum, in dem eine Nachricht für das Gerät verfügbar ist, bevor es vom IoT Hub abgelaufen ist, zwischen 1 und 48 Stunden.

Standardwert: 1

--dds --disable-device-sas

Ein boolescher Wert, der angibt, ob alle Geräte (einschließlich Edgegeräte, jedoch mit Ausnahme von Modulen) mit SAS-Schlüsseln für die Authentifizierung deaktiviert werden sollen.

Zulässige Werte: false, true

--disable-local-auth --dla

Ein boolescher Wert, der angibt, ob ioT-Hub-SAS-Schlüssel für die Authentifizierung deaktiviert werden sollen.

Zulässige Werte: false, true

--disable-module-sas --dms

Ein boolescher Wert, der angibt, ob SAS-Schlüssel mit Modulbereich für die Authentifizierung deaktiviert werden sollen.

Zulässige Werte: false, true

--edr --enforce-data-residency

Erzwingen Sie die Datenaufbewahrung für diesen IoT Hub, indem Sie die regionsübergreifende 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/iothubdisabledr.

Zulässige Werte: false, true

--fc --fileupload-storage-container-name

Der Name des Stammcontainers, in den Sie Dateien hochladen. Der Container muss nicht vorhanden sein, sollte jedoch mithilfe der angegebenen connectionString erstellt werden.

--fcs --fileupload-storage-connectionstring

Die Verbindungszeichenfolge für das Azure Storage-Konto, in das Dateien hochgeladen werden.

--fd --feedback-max-delivery-count

Die Häufigkeit, mit der der IoT-Hub versucht, eine Nachricht in der Feedbackwarteschlange zwischen 1 und 100 zu übermitteln.

Standardwert: 10

--feedback-lock-duration --fld

Die Sperrdauer für die Feedbackwarteschlange zwischen 5 und 300 Sekunden.

Standardwert: 5

--feedback-ttl --ft

Der Zeitraum, für den der IoT-Hub das Feedback für den Ablauf oder die Übermittlung von Cloud-zu-Gerät-Nachrichten zwischen 1 und 48 Stunden aufrecht erhält.

Standardwert: 1

--fileupload-notification-lock-duration --fnld

Die Sperrdauer für die Benachrichtigungswarteschlange für Dateiuploadbenachrichtigungen zwischen 5 und 300 Sekunden.

Standardwert: 5

--fileupload-notification-max-delivery-count --fnd

Die Häufigkeit, mit der der IoT-Hub versucht, eine Dateibenachrichtigung zwischen 1 und 100 zu übermitteln.

Standardwert: 10

--fileupload-notification-ttl --fnt

Der Zeitraum, in dem eine Dateiuploadbenachrichtigung für den Dienst verfügbar ist, bevor er vom IoT Hub abgelaufen ist, zwischen 1 und 48 Stunden.

Standardwert: 1

--fileupload-notifications --fn

Ein boolescher Wert, der angibt, ob Informationen zu hochgeladenen Dateien an den IoT Hub-Endpunkt nachrichten/servicebound/filenotifications protokolliert werden sollen.

Zulässige Werte: false, true

Standardwert: False

--fileupload-sas-ttl --fst

Der Zeitraum, in dem ein SAS-URI, der von IoT Hub generiert wird, gültig ist, bevor er abläuft, zwischen 1 und 24 Stunden.

Standardwert: 1

--fileupload-storage-auth-type --fsa

Der Authentifizierungstyp für das Azure Storage-Konto, in das Dateien hochgeladen werden.

Zulässige Werte: identityBased, keyBased

--fileupload-storage-identity --fsi

Die verwaltete Identität, die für die Dateiuploadauthentifizierung verwendet werden soll. Verwenden Sie "[System]", um auf die vom System zugewiesene verwaltete Identität oder eine Ressourcen-ID zu verweisen, um auf eine vom Benutzer zugewiesene verwaltete Identität zu verweisen.

--location -l

Standort Ihres IoT-Hubs. Der Standardwert ist der Speicherort der Zielressourcengruppe.

--mi-system-assigned

Aktivieren Sie die vom System zugewiesene verwaltete Identität für diesen Hub.

Zulässige Werte: false, true

--mi-user-assigned

Aktivieren Sie vom Benutzer zugewiesene verwaltete Identitäten für diesen Hub. Akzeptieren Sie eine durch Leerzeichen getrennte Liste der Identitätsressourcen-IDs.

--min-tls-version --mintls

Geben Sie die mindeste TLS-Version an, die für diesen Hub unterstützt werden soll. Kann auf "1.0" oder "1.2" festgelegt werden. Die mindeste TLS-Version, die auf "1.2" festgelegt ist, führt beispielsweise zu Clients, die eine TLS-Version unter 1.2 verwenden, um abgelehnt zu werden.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Standardwert: False

--partition-count

Die Anzahl der Partitionen des Sicherungsereignishubs für Geräte-zu-Cloud-Nachrichten.

Standardwert: 4

--rd --retention-day

Gibt an, wie lange dieser IoT-Hub Geräte-zu-Cloud-Ereignisse zwischen 1 und 7 Tagen verwaltet.

Standardwert: 1

--role

Rolle, die der vom System zugewiesenen verwalteten Identität des Hubs zugewiesen werden soll.

--scopes

Durch Leerzeichen getrennte Liste von Bereichen, um die Rolle (--role) für die vom System zugewiesene verwaltete Identität zuzuweisen.

--sku

Preisstufe für Azure IoT Hub. Beachten Sie, dass in jedem Abonnement nur eine kostenlose IoT-Hubinstanz (F1) zulässig ist. Ausnahme wird ausgelöst, wenn freie Instanzen eine instanz überschreiten.

Zulässige Werte: B1, B2, B3, F1, S1, S2, S3

Standardwert: S1

--tags

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

--unit

Einheiten in Ihrem IoT Hub.

Standardwert: 1

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub delete

Löschen Sie einen IoT-Hub.

az iot hub delete [--ids]
                  [--name]
                  [--no-wait]
                  [--resource-group]
                  [--subscription]

Beispiele

Löschen Sie einen IoT-Hub. (automatisch generiert)

az iot hub delete --name MyIoTHub --resource-group MyResourceGroup

Optionale Parameter

--ids

Mindestens eine 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-Name.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Standardwert: False

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub generate-sas-token

Generieren Sie ein SAS-Token für einen IoT-Hub, ein Gerät oder ein Zielmodul.

Bei Geräte-SAS-Token wird der Richtlinienparameter nur für den Zugriff auf die Geräteregistrierung verwendet. Daher sollte die Richtlinie Lesezugriff auf die Registrierung haben. Für IoT Hub-Token ist die Richtlinie Teil der SAS.

az iot hub generate-sas-token [--auth-type {key, login}]
                              [--connection-string]
                              [--device-id]
                              [--du]
                              [--hub-name]
                              [--key-type {primary, secondary}]
                              [--login]
                              [--module-id]
                              [--pn]
                              [--resource-group]

Beispiele

Generieren Sie ein IoT Hub SAS-Token mithilfe der iothubowner-Richtlinie und des Primärschlüssels.

az iot hub generate-sas-token -n {iothub_name}

Generieren Sie ein IoT Hub SAS-Token mithilfe der RegistryRead-Richtlinie und des sekundären Schlüssels.

az iot hub generate-sas-token -n {iothub_name} --policy registryRead --key-type secondary

Generieren Sie ein Geräte-SAS-Token mithilfe der iothubowner-Richtlinie, um auf die {iothub_name}-Geräteregistrierung zuzugreifen.

az iot hub generate-sas-token -d {device_id} -n {iothub_name}

Generieren eines GERÄTE-SAS-Tokens mithilfe einer IoT Hub-Verbindungszeichenfolge (mit Registrierungszugriff)

az iot hub generate-sas-token -d {device_id} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Generieren eines Iot Hub SAS-Tokens mithilfe einer IoT Hub-Verbindungszeichenfolge

az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Generieren eines Geräte-SAS-Tokens mithilfe einer Geräteverbindungszeichenfolge

az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;DeviceId=mydevice;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Generieren eines Modul-SAS-Tokens mithilfe einer Modulverbindungszeichenfolge

az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;DeviceId=mydevice;ModuleId=mymodule;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

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 iothub-data-auth-type={auth-type-value}.

Zulässige Werte: key, login

Standardwert: key

--connection-string --cs

Zielverbindungszeichenfolge. Dadurch wird die IoT Hub-Registrierung umgangen und das SAS-Token direkt aus dem bereitgestellten symmetrischen Schlüssel ohne weitere Überprüfung generiert. Alle anderen Befehlsparameter werden außer der Dauer ignoriert. Unterstützte Verbindungszeichenfolgentypen: Iot Hub, Gerät, Modul.

--device-id -d

Zielgeräte-ID.

--du --duration

Gültige Tokendauer in Sekunden.

Standardwert: 3600

--hub-name -n

IoT Hub-Name oder Hostname. Erforderlich, wenn --login nicht angegeben wird.

--key-type --kt

Schlüsseltyp für gemeinsame Zugriffsrichtlinien für die Authentifizierung.

Zulässige Werte: primary, secondary

Standardwert: primary

--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 --hub-name nicht angegeben wird.

--module-id -m

Zielmodul-ID.

--pn --policy-name

Richtlinie für den freigegebenen Zugriff mit Vorgangsberechtigungen für die IoT Hub-Zielentität.

Standardwert: iothubowner

--resource-group -g

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

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub invoke-device-method

Rufen Sie eine Gerätemethode auf.

az iot hub invoke-device-method --device-id
                                --method-name
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--method-payload]
                                [--resource-group]
                                [--timeout]

Beispiele

Rufen Sie eine direkte Methode auf einem Gerät auf.

az iot hub invoke-device-method --hub-name {iothub_name} --device-id {device_id} --method-name Reboot --method-payload '{"version":"1.0"}'

Erforderliche Parameter

--device-id -d

Zielgeräte-ID.

--method-name --mn

Zielmethode für Aufrufe.

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 iothub-data-auth-type={auth-type-value}.

Zulässige Werte: key, login

Standardwert: key

--hub-name -n

IoT Hub-Name oder Hostname. 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 --hub-name nicht angegeben wird.

--method-payload --mp

Json-Nutzlast, die an die Methode übergeben werden soll. Muss Dateipfad oder unformatierte JSON sein.

Standardwert: {}

--resource-group -g

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

--timeout --to

Maximale Anzahl von Sekunden, um auf das Ergebnis der Gerätemethode zu warten.

Standardwert: 30

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub invoke-module-method

Aufrufen einer Modulmethode.

Dieser Befehl unterstützt sowohl Edge- als auch Nicht-Edge-Gerätemodule.

az iot hub invoke-module-method --device-id
                                --method-name
                                --module-id
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--method-payload]
                                [--resource-group]
                                [--timeout]

Beispiele

Rufen Sie eine direkte Methode auf einem Edgegerätemodul auf.

az iot hub invoke-module-method -n {iothub_name} -d {device_id} -m '$edgeAgent' --method-name 'RestartModule' --method-payload '{"schemaVersion": "1.0"}'

Erforderliche Parameter

--device-id -d

Zielgeräte-ID.

--method-name --mn

Zielmethode für Aufrufe.

--module-id -m

Zielmodul-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 iothub-data-auth-type={auth-type-value}.

Zulässige Werte: key, login

Standardwert: key

--hub-name -n

IoT Hub-Name oder Hostname. 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 --hub-name nicht angegeben wird.

--method-payload --mp

Json-Nutzlast, die an die Methode übergeben werden soll. Muss Dateipfad oder unformatierte JSON sein.

Standardwert: {}

--resource-group -g

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

--timeout --to

Maximale Anzahl von Sekunden, um auf das Modulmethodenergebnis zu warten.

Standardwert: 30

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub list

Auflisten von IoT-Hubs.

az iot hub list [--resource-group]

Beispiele

Auflisten aller IoT-Hubs in einem Abonnement.

az iot hub list

Auflisten aller IoT-Hubs in der Ressourcengruppe "MyGroup"

az iot hub list --resource-group MyGroup

Optionale Parameter

--resource-group -g

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

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub list-skus

Auflisten der verfügbaren Tarife.

az iot hub list-skus [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

Beispiele

Auflisten der verfügbaren Tarife. (automatisch generiert)

az iot hub list-skus --name MyIoTHub

Optionale Parameter

--ids

Mindestens eine 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-Name.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub manual-failover

Initiieren eines manuellen Failovers für die IoT Hub-Instanz in die geografisch gekoppelte Notfallwiederherstellungsregion.

az iot hub manual-failover [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]

Beispiele

Initiieren sie das Failover "myhub" von der primären zu der sekundären Region.

az iot hub manual-failover -n myhub

Optionale Parameter

--ids

Mindestens eine 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-Name.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Standardwert: False

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub monitor-events

Überwachen von Gerätetelemetrie und Nachrichten, die an einen IoT Hub gesendet werden.

Dieser Befehl basiert auf und kann abhängiges Cython-Paket (uamqp) bei der ersten Ausführung installieren. https://github.com/Azure/azure-uamqp-python

Hinweis: Das Ereignis wird auch dann angezeigt, wenn der Nachrichtentext nicht unicode decodierbar ist. In diesem Fall wird der Ereignisnutzlastteil als {{nicht decodierbare Nutzlast}} mit den restlichen verfügbaren Ereigniseigenschaften angezeigt.

az iot hub monitor-events [--cg]
                          [--content-type]
                          [--device-id]
                          [--device-query]
                          [--enqueued-time]
                          [--hub-name]
                          [--interface]
                          [--login]
                          [--mc]
                          [--module-id]
                          [--properties {all, anno, app, sys}]
                          [--repair {false, true}]
                          [--resource-group]
                          [--timeout]
                          [--yes {false, true}]

Beispiele

Grundlegende Nutzung

az iot hub monitor-events -n {iothub_name}

Grundlegende Verwendung mit einer IoT Hub-Verbindungszeichenfolge

az iot hub monitor-events -n {iothub_name} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Grundlegende Verwendung beim Filtern auf dem Zielgerät

az iot hub monitor-events -n {iothub_name} -d {device_id}

Grundlegende Verwendung beim Filtern von Zielgeräten mit einem Wildcard in der ID

az iot hub monitor-events -n {iothub_name} -d Device*

Filtern von Geräten mithilfe der IoT Hub-Abfragesprache

az iot hub monitor-events -n {iothub_name} -q "select * from devices where tags.location.region = 'US'"

Filtern Sie das Gerät, und geben Sie eine Event Hub-Consumergruppe an, an die eine Bindung erfolgen soll.

az iot hub monitor-events -n {iothub_name} -d {device_id} --cg {consumer_group_name}

Empfangen von Nachrichtenanmerkungen (Nachrichtenkopfzeilen)

az iot hub monitor-events -n {iothub_name} -d {device_id} --properties anno

Empfangen von Nachrichtenanmerkungen + Systemeigenschaften. Timeout nie.

az iot hub monitor-events -n {iothub_name} -d {device_id} --properties anno sys --timeout 0

Empfangen aller Nachrichtenattribute von allen Gerätenachrichten

az iot hub monitor-events -n {iothub_name} --props all

Empfangen aller Nachrichten und Analysieren der Nachrichtennutzlast als JSON

az iot hub monitor-events -n {iothub_name} --content-type application/json

Empfangen Sie die angegebene Anzahl von Nachrichten vom Hub, und fahren Sie dann herunter.

az iot hub monitor-events -n {iothub_name} --message-count {message_count}

Optionale Parameter

--cg --consumer-group -c

Geben Sie die Consumergruppe an, die beim Herstellen einer Verbindung mit dem Event Hub-Endpunkt verwendet werden soll.

Standardwert: $Default

--content-type --ct

Geben Sie den Inhaltstyp der Nachrichtennutzlast an, um die Ausgabe automatisch in diesen Typ zu formatieren.

--device-id -d

Zielgeräte-ID.

--device-query -q

Geben Sie eine benutzerdefinierte Abfrage an, um Geräte zu filtern.

--enqueued-time --et -e

Gibt die Zeit an, die als Ausgangspunkt zum Lesen von Nachrichten aus den Partitionen verwendet werden soll. Einheiten sind Millisekunden seit unix-Epoche. Wenn keine Uhrzeit angegeben ist, wird "jetzt" verwendet.

--hub-name -n

IoT Hub-Name oder Hostname. Erforderlich, wenn --login nicht angegeben wird.

--interface -i

Zielschnittstellenbezeichner, nach dem gefiltert werden soll. Beispiel: dtmi:com:example:TemperatureController;1.

--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 --hub-name nicht angegeben wird.

--mc --message-count

Anzahl der Telemetriemeldungen, die erfasst werden sollen, bevor der Monitor beendet wird. Wenn nicht angegeben, wird der Monitor so lange ausgeführt, bis der Timeoutschwellenwert erreicht wird, der keine Nachrichten vom Hub empfängt.

--module-id -m

Zielmodul-ID.

--properties --props -p

Geben Sie wichtige Nachrichteneigenschaften an, die ausgegeben werden sollen. sys = Systemeigenschaften, App = Anwendungseigenschaften, anno = Anmerkungen.

Zulässige Werte: all, anno, app, sys

--repair -r

Installieren Sie uamqp-Abhängigkeit neu, die mit der Erweiterungsversion kompatibel ist. Standardwert: false.

Zulässige Werte: false, true

Standardwert: False

--resource-group -g

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

--timeout --to -t

Maximale Anzahl von Sekunden, um die Verbindung ohne Empfang einer Nachricht aufrechtzuerhalten. Verwenden Sie 0 für Unendlichkeit.

Standardwert: 300

--yes -y

Benutzeraufforderungen überspringen. Gibt die Annahme der Aktion an. Wird hauptsächlich für Automatisierungsszenarien verwendet. Standardwert: false.

Zulässige Werte: false, true

Standardwert: False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub monitor-feedback

Überwachen des von Geräten gesendeten Feedbacks, um Cloud-zu-Gerät--Nachrichten (C2D) zu bestätigen.

Dieser Befehl basiert auf und kann abhängiges Cython-Paket (uamqp) bei der ersten Ausführung installieren. https://github.com/Azure/azure-uamqp-python.

az iot hub monitor-feedback [--auth-type {key, login}]
                            [--device-id]
                            [--hub-name]
                            [--login]
                            [--repair {false, true}]
                            [--resource-group]
                            [--wait-on-msg]
                            [--yes {false, true}]

Beispiele

Grundlegende Nutzung

az iot hub monitor-feedback -n {iothub_name}

Grundlegende Verwendung mit einer IoT Hub-Verbindungszeichenfolge

az iot hub monitor-feedback -n {iothub_name} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Grundlegende Verwendung beim Filtern auf dem Zielgerät

az iot hub monitor-feedback -n {iothub_name} -d {device_id}

Exit feedback monitor upon receiving a message with specific id (uuid)

az iot hub monitor-feedback -n {iothub_name} -d {device_id} -w {message_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 iothub-data-auth-type={auth-type-value}.

Zulässige Werte: key, login

Standardwert: key

--device-id -d

Zielgeräte-ID.

--hub-name -n

IoT Hub-Name oder Hostname. 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 --hub-name nicht angegeben wird.

--repair -r

Installieren Sie uamqp-Abhängigkeit neu, die mit der Erweiterungsversion kompatibel ist. Standardwert: false.

Zulässige Werte: false, true

Standardwert: False

--resource-group -g

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

--wait-on-msg -w

Der Feedbackmonitor wird blockiert, bis eine Nachricht mit einer bestimmten ID (uuid) empfangen wird.

--yes -y

Benutzeraufforderungen überspringen. Gibt die Annahme der Aktion an. Wird hauptsächlich für Automatisierungsszenarien verwendet. Standardwert: false.

Zulässige Werte: false, true

Standardwert: False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub query

Abfragen eines IoT Hub mithilfe einer leistungsfähigen SQL-ähnlichen Sprache.

Abrufen von Informationen zu Geräte- und Modul-Twins, Aufträgen und Nachrichtenrouting. Weitere Informationen finden Sie unter https://learn.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language.

az iot hub query --query-command
                 [--auth-type {key, login}]
                 [--hub-name]
                 [--login]
                 [--resource-group]
                 [--top]

Beispiele

Abfragen aller Geräte-Twin-Daten in einem Azure IoT Hub.

az iot hub query -n {iothub_name} -q "select * from devices"

Fragen Sie alle Modul-Twin-Daten auf dem Zielgerät ab.

az iot hub query -n {iothub_name} -q "select * from devices.modules where devices.deviceId = '{device_id}'"

Erforderliche Parameter

--query-command -q

Auszuführende Benutzerabfrage.

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 iothub-data-auth-type={auth-type-value}.

Zulässige Werte: key, login

Standardwert: key

--hub-name -n

IoT Hub-Name oder Hostname. 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 --hub-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. Standardmäßig hat die Abfrage keine Großbuchstaben.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub show

Rufen Sie die Details eines IoT-Hubs ab.

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

Beispiele

Rufen Sie die Details eines IoT-Hubs ab. (automatisch generiert)

az iot hub show --name MyIoTHub

Optionale Parameter

--ids

Mindestens eine 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-Name.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub show-quota-metrics

Rufen Sie die Kontingentmetriken für einen IoT-Hub ab.

az iot hub show-quota-metrics [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

Beispiele

Rufen Sie die Kontingentmetriken für einen IoT-Hub ab. (automatisch generiert)

az iot hub show-quota-metrics --ids {ids}

Rufen Sie die Kontingentmetriken für einen IoT-Hub ab. (automatisch generiert)

az iot hub show-quota-metrics --name MyIoTHub

Optionale Parameter

--ids

Mindestens eine 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-Name.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub show-stats

Rufen Sie die Statistiken für einen IoT-Hub ab.

az iot hub show-stats [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

Beispiele

Rufen Sie die Statistiken für einen IoT-Hub ab. (automatisch generiert)

az iot hub show-stats --name MyIoTHub

Optionale Parameter

--ids

Mindestens eine 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-Name.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub update

Aktualisieren von Metadaten für einen IoT-Hub.

az iot hub update [--add]
                  [--c2d-max-delivery-count]
                  [--c2d-ttl]
                  [--dds {false, true}]
                  [--disable-local-auth {false, true}]
                  [--disable-module-sas {false, true}]
                  [--fc]
                  [--fcs]
                  [--fd]
                  [--feedback-lock-duration]
                  [--feedback-ttl]
                  [--fileupload-notification-lock-duration]
                  [--fileupload-notification-max-delivery-count]
                  [--fileupload-notification-ttl]
                  [--fileupload-notifications {false, true}]
                  [--fileupload-sas-ttl]
                  [--fileupload-storage-auth-type {identityBased, keyBased}]
                  [--fileupload-storage-identity]
                  [--force-string]
                  [--ids]
                  [--min-tls-version]
                  [--name]
                  [--rd]
                  [--remove]
                  [--resource-group]
                  [--set]
                  [--sku {B1, B2, B3, F1, S1, S2, S3}]
                  [--subscription]
                  [--tags]
                  [--unit]

Beispiele

Hinzufügen von Speichercontainereinstellungen zum Dateiupload

az iot hub update --name MyIotHub --fileupload-storage-connectionstring "connection-string" \ --fileupload-storage-container-name "container_name"

Fügen Sie eine Firewallfilterregel hinzu, um Datenverkehr aus der IP-Maske 127.0.0.0/31 zu akzeptieren.

az iot hub update --name MyIotHub --add properties.ipFilterRules filter_name=test-rule action=Accept ip_mask=127.0.0.0/31

Aktualisieren von Metadaten für einen IoT-Hub. (automatisch generiert)

az iot hub update --name MyIotHub --set properties.allocationPolicy="GeoLatency"

Aktualisieren von Einheiten eines IoT Hub auf 2 und Hinzufügen von Tags

az iot hub update -n MyIotHub --unit 2 --tags a=b c=d

Aktualisieren des Preisniveaus für einen IoT Hub als S2

az iot hub update -n MyIotHub --sku S2

Aktualisieren der Aufbewahrungstage von IoT Hub-Geräte-zu-Cloud-Ereignissen als 3 Tage

az iot hub update -n MyIotHub --retention-day 3

Aktualisieren der IoT Hub-Einstellungen für Cloud-zu-Gerät-Messaging

az iot hub update --name MyIotHub --c2d-max-delivery-count 30 --c2d-ttl 5

Aktualisieren der IoT Hub-Feedbackwarteschlangeneinstellungen

az iot hub update --name MyIoTHub --feedback-max-delivery-count 20 --feedback-lock-duration 100 --feedback-ttl 4

Aktualisieren der IoT Hub-Dateiuploadeinstellungen und Zuweisen einer verwalteten Identität für den Benutzer zum Hochladen von Dateien

az iot hub update -n MyIoTHub --fileupload-sas-ttl 5 --fileupload-storage-auth-type identityBased --fileupload-storage-identity [system]

Aktualisieren der IoT Hub-Dateiuploadbenachrichtigungseinstellungen und Sperrdauer der Warteschlangensperre

az iot hub update -n MyIoTHub --fileupload-notification-max-delivery-count 50 --fileupload-notification-ttl 48 --fileupload-notifications --fileupload-notification-lock-duration 10

Aktualisieren der lokalen IoT Hub-Authentifizierung, gerätebasierten SAS- und Modul-SAS-Einstellungen

az iot hub update -n MyIoTHub --disable-local-auth --disable-device-sas false --disable-module-sas true

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

--c2d-max-delivery-count --cdd

Die Häufigkeit, mit der der IoT-Hub versucht, eine Cloud-to-Device-Nachricht an ein Gerät zwischen 1 und 100 zu übermitteln.

--c2d-ttl --ct

Der Zeitraum, in dem eine Nachricht für das Gerät verfügbar ist, bevor es vom IoT Hub abgelaufen ist, zwischen 1 und 48 Stunden.

--dds --disable-device-sas

Ein boolescher Wert, der angibt, ob alle Geräte (einschließlich Edgegeräte, jedoch mit Ausnahme von Modulen) mit SAS-Schlüsseln für die Authentifizierung deaktiviert werden sollen.

Zulässige Werte: false, true

--disable-local-auth --dla

Ein boolescher Wert, der angibt, ob ioT-Hub-SAS-Schlüssel für die Authentifizierung deaktiviert werden sollen.

Zulässige Werte: false, true

--disable-module-sas --dms

Ein boolescher Wert, der angibt, ob SAS-Schlüssel mit Modulbereich für die Authentifizierung deaktiviert werden sollen.

Zulässige Werte: false, true

--fc --fileupload-storage-container-name

Der Name des Stammcontainers, in den Sie Dateien hochladen. Der Container muss nicht vorhanden sein, sollte jedoch mithilfe der angegebenen connectionString erstellt werden.

--fcs --fileupload-storage-connectionstring

Die Verbindungszeichenfolge für das Azure Storage-Konto, in das Dateien hochgeladen werden.

--fd --feedback-max-delivery-count

Die Häufigkeit, mit der der IoT-Hub versucht, eine Nachricht in der Feedbackwarteschlange zwischen 1 und 100 zu übermitteln.

--feedback-lock-duration --fld

Die Sperrdauer für die Feedbackwarteschlange zwischen 5 und 300 Sekunden.

--feedback-ttl --ft

Der Zeitraum, für den der IoT-Hub das Feedback für den Ablauf oder die Übermittlung von Cloud-zu-Gerät-Nachrichten zwischen 1 und 48 Stunden aufrecht erhält.

--fileupload-notification-lock-duration --fnld

Die Sperrdauer für die Benachrichtigungswarteschlange für Dateiuploadbenachrichtigungen zwischen 5 und 300 Sekunden.

--fileupload-notification-max-delivery-count --fnd

Die Häufigkeit, mit der der IoT-Hub versucht, eine Dateibenachrichtigung zwischen 1 und 100 zu übermitteln.

--fileupload-notification-ttl --fnt

Der Zeitraum, in dem eine Dateiuploadbenachrichtigung für den Dienst verfügbar ist, bevor er vom IoT Hub abgelaufen ist, zwischen 1 und 48 Stunden.

--fileupload-notifications --fn

Ein boolescher Wert, der angibt, ob Informationen zu hochgeladenen Dateien an den IoT Hub-Endpunkt nachrichten/servicebound/filenotifications protokolliert werden sollen.

Zulässige Werte: false, true

--fileupload-sas-ttl --fst

Der Zeitraum, in dem ein SAS-URI, der von IoT Hub generiert wird, gültig ist, bevor er abläuft, zwischen 1 und 24 Stunden.

--fileupload-storage-auth-type --fsa

Der Authentifizierungstyp für das Azure Storage-Konto, in das Dateien hochgeladen werden.

Zulässige Werte: identityBased, keyBased

--fileupload-storage-identity --fsi

Die verwaltete Identität, die für die Dateiuploadauthentifizierung verwendet werden soll. Verwenden Sie "[System]", um auf die vom System zugewiesene verwaltete Identität oder eine Ressourcen-ID zu verweisen, um auf eine vom Benutzer zugewiesene verwaltete Identität zu verweisen.

--force-string

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

Standardwert: False

--ids

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

--min-tls-version --mintls

Geben Sie die mindeste TLS-Version an, die für diesen Hub unterstützt werden soll. Kann auf "1.0" oder "1.2" festgelegt werden. Die mindeste TLS-Version, die auf "1.2" festgelegt ist, führt beispielsweise zu Clients, die eine TLS-Version unter 1.2 verwenden, um abgelehnt zu werden.

--name -n

IoT Hub-Name.

--rd --retention-day

Gibt an, wie lange dieser IoT-Hub Geräte-zu-Cloud-Ereignisse zwischen 1 und 7 Tagen verwaltet.

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

--sku

Preisstufe für Azure IoT Hub. Beachten Sie, dass in jedem Abonnement nur eine kostenlose IoT-Hubinstanz (F1) zulässig ist. Ausnahme wird ausgelöst, wenn freie Instanzen eine instanz überschreiten.

Zulässige Werte: B1, B2, B3, F1, S1, S2, S3

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--tags

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

--unit

Einheiten in Ihrem IoT Hub.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az iot hub wait

Warten Sie, bis ein Vorgang für eine IoT Hub-Instanz abgeschlossen ist.

az iot hub wait [--created]
                [--custom]
                [--deleted]
                [--exists]
                [--ids]
                [--interval]
                [--name]
                [--resource-group]
                [--subscription]
                [--timeout]
                [--updated]

Beispiele

Warten, bis eine vorhandene IoT Hub-Instanz erstellt wird

az iot hub wait -n MyIoTHub --created

Warten, bis eine IoT Hub-Instanz gelöscht wird

az iot hub wait -n MyIoTHub --deleted

Warten, bis eine vorhandene IoT Hub-Instanz einen aktiven Zustand aufweist

az iot hub wait -n MyIoTHub --custom "properties.state=='Active'"

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False

--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False

--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False

--ids

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

--interval

Abrufintervall in Sekunden.

Standardwert: 30

--name -n

IoT Hub-Name.

--resource-group -g

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600

--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.