Freigeben über


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. Weitere Informationen zu Erweiterungen

Verwalten von Azure-IoT-Hubs

Befehle

Name Beschreibung Typ Status
az iot hub certificate

Verwalten von IoT Hub-Zertifikaten.

Kern und Erweiterung Allgemein verfügbar
az iot hub certificate create

Erstellen/Hochladen eines Azure IoT Hub-Zertifikats.

Core Allgemein verfügbar
az iot hub certificate delete

Löscht ein Azure IoT Hub-Zertifikat.

Core Allgemein verfügbar
az iot hub certificate generate-verification-code

Generiert einen Überprüfungscode für ein Azure IoT Hub-Zertifikat.

Core Allgemein verfügbar
az iot hub certificate list

Listet alle Zertifikate auf, die in einem Azure IoT Hub enthalten sind.

Core Allgemein verfügbar
az iot hub certificate root-authority

Verwalten Sie die Zertifikatstammzertifizierungsstelle für eine IoT Hub-Instanz.

Erweiterung Veraltet
az iot hub certificate root-authority set

Legen Sie die Zertifikatstammzertifizierungsstelle für eine IoT Hub-Instanz auf eine bestimmte Version fest.

Erweiterung Veraltet
az iot hub certificate root-authority show

Zeigen Sie die aktuelle Zertifikatstammzertifizierungsstelle für eine IoT Hub-Instanz an.

Erweiterung Veraltet
az iot hub certificate show

Zeigt Informationen zu einem bestimmten Azure IoT Hub-Zertifikat an.

Core Allgemein verfügbar
az iot hub certificate update

Aktualisieren Sie ein Azure IoT Hub-Zertifikat.

Core Allgemein verfügbar
az iot hub certificate verify

Überprüft ein Azure IoT Hub-Zertifikat.

Core Allgemein verfügbar
az iot hub configuration

Verwalten Sie die Konfiguration für die automatische Verwaltung von IoT-Geräten im großen Stil.

Erweiterung Allgemein verfügbar
az iot hub configuration create

Erstellen Sie eine automatische IoT-Geräteverwaltungskonfiguration in einem IoT-Ziel-IoT-Hub.

Erweiterung Allgemein verfügbar
az iot hub configuration delete

Löschen sie eine IoT-Gerätekonfiguration.

Erweiterung Allgemein verfügbar
az iot hub configuration list

Auflisten der automatischen Geräteverwaltungskonfigurationen in einem IoT-Hub.

Erweiterung Allgemein verfügbar
az iot hub configuration show

Rufen Sie die Details einer automatischen IoT-Geräteverwaltungskonfiguration ab.

Erweiterung Allgemein verfügbar
az iot hub configuration show-metric

Bewerten einer Zielbenutzer- oder Systemmetrik, die in einer IoT-Gerätekonfiguration definiert ist.

Erweiterung Allgemein verfügbar
az iot hub configuration update

Aktualisieren Sie die angegebenen Eigenschaften einer automatischen IoT-Geräteverwaltungskonfiguration.

Erweiterung Allgemein verfügbar
az iot hub connection-string

Verwalten von IoT Hub-Verbindungszeichenfolge s.

Erweiterung Allgemein verfügbar
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 Allgemein verfügbar
az iot hub consumer-group

Verwalten sie die Event Hub-Consumergruppen eines IoT-Hubs.

Core Allgemein verfügbar
az iot hub consumer-group create

Erstellen Sie eine Event Hub-Consumergruppe.

Core Allgemein verfügbar
az iot hub consumer-group delete

Löschen sie eine Event Hub-Consumergruppe.

Core Allgemein verfügbar
az iot hub consumer-group list

Auflisten von Event Hub-Consumergruppen.

Core Allgemein verfügbar
az iot hub consumer-group show

Rufen Sie die Details für eine Event Hub-Consumergruppe ab.

Core Allgemein verfügbar
az iot hub create

Erstellen Sie einen Azure IoT-Hub.

Core Allgemein verfügbar
az iot hub delete

Löschen Sie einen IoT-Hub.

Core Allgemein verfügbar
az iot hub device-identity

Verwalten von IoT-Geräten.

Erweiterung Allgemein verfügbar
az iot hub device-identity children

Verwalten von untergeordneten Gerätebeziehungen für IoT-Edgegeräte.

Erweiterung Allgemein verfügbar
az iot hub device-identity children add

Fügen Sie Geräte als untergeordnete Geräte zu einem Ziel-Edgegerät hinzu.

Erweiterung Allgemein verfügbar
az iot hub device-identity children list

Gibt die Auflistung der zugewiesenen untergeordneten Geräte aus.

Erweiterung Allgemein verfügbar
az iot hub device-identity children remove

Entfernen sie untergeordnete Geräte von einem Ziel-Edgegerät.

Erweiterung Allgemein verfügbar
az iot hub device-identity connection-string

Verwalten sie die Verbindungszeichenfolge des IoT-Geräts.

Erweiterung Allgemein verfügbar
az iot hub device-identity connection-string show

Anzeigen eines bestimmten IoT Hub-Geräts Verbindungszeichenfolge.

Erweiterung Allgemein verfügbar
az iot hub device-identity create

Erstellen Sie ein Gerät in einem IoT Hub.

Erweiterung Allgemein verfügbar
az iot hub device-identity delete

Löschen Sie ein IoT Hub-Gerät.

Erweiterung Allgemein verfügbar
az iot hub device-identity export

Exportieren Sie alle Geräteidentitäten aus einem IoT Hub in einen Azure Storage-BLOB-Container.

Erweiterung Allgemein verfügbar
az iot hub device-identity import

Importieren von Geräteidentitäten in einen IoT Hub aus einem Speichercontainer-BLOB.

Erweiterung Allgemein verfügbar
az iot hub device-identity list

Auflisten von Geräten in einem IoT Hub.

Erweiterung Allgemein verfügbar
az iot hub device-identity parent

Verwalten sie übergeordnete Gerätebeziehungen für IoT-Geräte.

Erweiterung Allgemein verfügbar
az iot hub device-identity parent set

Legen Sie das übergeordnete Gerät eines Zielgeräts fest.

Erweiterung Allgemein verfügbar
az iot hub device-identity parent show

Rufen Sie das übergeordnete Gerät eines Zielgeräts ab.

Erweiterung Allgemein verfügbar
az iot hub device-identity renew-key

Verlängern Sie Zielschlüssel eines IoT Hub-Geräts mit sas-Authentifizierung.

Erweiterung Allgemein verfügbar
az iot hub device-identity show

Rufen Sie die Details eines IoT Hub-Geräts ab.

Erweiterung Allgemein verfügbar
az iot hub device-identity update

Aktualisieren sie ein IoT Hub-Gerät.

Erweiterung Allgemein verfügbar
az iot hub device-twin

Verwalten der Konfiguration von IoT-Gerätezwillingen.

Erweiterung Allgemein verfügbar
az iot hub device-twin list

Auflisten von Geräte twins in einem IoT Hub.

Erweiterung Allgemein verfügbar
az iot hub device-twin replace

Ersetzen Sie die Geräte-Twin-Definition durch die Ziel-JSON.

Erweiterung Allgemein verfügbar
az iot hub device-twin show

Rufen Sie eine Twin-Definition des Geräts ab.

Erweiterung Allgemein verfügbar
az iot hub device-twin update

Aktualisieren sie die gewünschten Geräteeigenschaften und -tags.

Erweiterung Allgemein verfügbar
az iot hub devicestream

Verwalten von Gerätestreams einer IoT Hub-Instanz.

Core Vorschau
az iot hub devicestream show

Rufen Sie die Gerätestreams von IoT Hub-Endpunkten ab.

Core Vorschau
az iot hub digital-twin

Bearbeiten und interagieren Sie mit dem digitalen Zwilling eines IoT Hub-Geräts.

Erweiterung Allgemein verfügbar
az iot hub digital-twin invoke-command

Rufen Sie einen Befehl auf Stamm- oder Komponentenebene eines digitalen Twin-Geräts auf.

Erweiterung Allgemein verfügbar
az iot hub digital-twin show

Zeigen Sie den digitalen Zwilling eines IoT Hub-Geräts an.

Erweiterung Allgemein verfügbar
az iot hub digital-twin update

Aktualisieren Sie die Lese-/Schreibeigenschaften eines digitalen Twin-Geräts über die JSON-Patchspezifikation.

Erweiterung Allgemein verfügbar
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 Allgemein verfügbar
az iot hub identity

Verwalten von Identitäten eines Azure IoT-Hubs.

Core Allgemein verfügbar
az iot hub identity assign

Weisen Sie verwaltete Identitäten einem IoT-Hub zu.

Core Allgemein verfügbar
az iot hub identity remove

Entfernt verwaltete Identitäten aus einem IoT Hub.

Core Allgemein verfügbar
az iot hub identity show

Zeigen Sie die Identitätseigenschaften eines IoT Hub an.

Core Allgemein verfügbar
az iot hub invoke-device-method

Aufrufen einer Gerätemethode.

Erweiterung Allgemein verfügbar
az iot hub invoke-module-method

Aufrufen einer Modulmethode.

Erweiterung Allgemein verfügbar
az iot hub job

Verwalten von IoT Hub-Aufträgen (v2).

Erweiterung Allgemein verfügbar
az iot hub job cancel

Abbrechen eines IoT Hub-Auftrags.

Erweiterung Allgemein verfügbar
az iot hub job create

Erstellen und Planen eines IoT Hub-Auftrags für die Ausführung.

Erweiterung Allgemein verfügbar
az iot hub job list

Listet die historischen Aufträge eines IoT Hub auf.

Erweiterung Allgemein verfügbar
az iot hub job show

Zeigen Sie Details eines vorhandenen IoT Hub-Auftrags an.

Erweiterung Allgemein verfügbar
az iot hub list

Auflisten von IoT-Hubs.

Core Allgemein verfügbar
az iot hub list-skus

Auflisten der verfügbaren Tarife.

Core Allgemein verfügbar
az iot hub manual-failover

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

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

Core Allgemein verfügbar
az iot hub message-enrichment create

Erstellen Sie eine Nachrichtenerweiterung für ausgewählte Endpunkte in Ihrem IoT Hub.

Core Allgemein verfügbar
az iot hub message-enrichment delete

Löschen Sie eine Nachrichtenerweiterung in Ihrem IoT-Hub (nach Schlüssel).

Core Allgemein verfügbar
az iot hub message-enrichment list

Erhalten Sie Informationen zu allen Nachrichtenanreicherungen für Ihren IoT Hub.

Core Allgemein verfügbar
az iot hub message-enrichment update

Aktualisieren Sie eine Nachrichtenerweiterung in Ihrem IoT-Hub (nach Schlüssel).

Core Allgemein verfügbar
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ähnung 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ähnung 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 Allgemein verfügbar
az iot hub module-identity connection-string

Verwalten sie die Verbindungszeichenfolge des IoT-Gerätemoduls.

Erweiterung Allgemein verfügbar
az iot hub module-identity connection-string show

Anzeigen eines Ziel-IoT-Gerätemoduls Verbindungszeichenfolge.

Erweiterung Allgemein verfügbar
az iot hub module-identity create

Erstellen Sie ein Modul auf einem IoT-Zielgerät in einem IoT-Hub.

Erweiterung Allgemein verfügbar
az iot hub module-identity delete

Löschen eines Geräts in einem IoT-Hub.

Erweiterung Allgemein verfügbar
az iot hub module-identity list

Auflisten von Modulen auf einem IoT-Gerät in einem IoT-Hub.

Erweiterung Allgemein verfügbar
az iot hub module-identity renew-key

Verlängern Sie Zielschlüssel eines IoT Hub-Gerätemoduls mit sas-Authentifizierung.

Erweiterung Allgemein verfügbar
az iot hub module-identity show

Rufen Sie die Details eines IoT-Gerätemoduls in einem IoT-Hub ab.

Erweiterung Allgemein verfügbar
az iot hub module-identity update

Aktualisieren Sie ein IoT Hub-Gerätemodul.

Erweiterung Allgemein verfügbar
az iot hub module-twin

Verwalten der Konfiguration von IoT-Modulgerätezwillingen.

Erweiterung Allgemein verfügbar
az iot hub module-twin replace

Ersetzen Sie eine Twin-Definition eines Moduls durch die Ziel-JSON.

Erweiterung Allgemein verfügbar
az iot hub module-twin show

Zeigen Sie eine Twin-Definition des Moduls an.

Erweiterung Allgemein verfügbar
az iot hub module-twin update

Aktualisieren Sie die zwillingswilligen Eigenschaften und Tags des Moduls.

Erweiterung Allgemein verfügbar
az iot hub monitor-events

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

Erweiterung Allgemein verfügbar
az iot hub monitor-feedback

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

Erweiterung Allgemein verfügbar
az iot hub policy

Verwalten von Richtlinien für gemeinsamen Zugriff einer IoT Hub-Instanz.

Core Allgemein verfügbar
az iot hub policy create

Erstellen Sie eine neue Richtlinie für den freigegebenen Zugriff in einem IoT-Hub.

Core Allgemein verfügbar
az iot hub policy delete

Löschen Sie eine Richtlinie für den freigegebenen Zugriff von einem IoT-Hub.

Core Allgemein verfügbar
az iot hub policy list

Auflisten von Freigegebenen Zugriffsrichtlinien eines IoT-Hubs.

Core Allgemein verfügbar
az iot hub policy renew-key

Generieren Sie Schlüssel einer freigegebenen Zugriffsrichtlinie eines IoT-Hubs neu.

Core Allgemein verfügbar
az iot hub policy show

Rufen Sie die Details einer Freigegebenen Zugriffsrichtlinie eines IoT-Hubs ab.

Core Allgemein verfügbar
az iot hub query

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

Erweiterung Allgemein verfügbar
az iot hub route

Verwalten von Routen einer IoT Hub-Instanz.

Core Veraltet
az iot hub route create

Erstellen Sie eine Route im IoT Hub.

Core Veraltet
az iot hub route delete

Löschen Sie alle oder Erwähnung ed Route für Ihren IoT Hub.

Core Veraltet
az iot hub route list

Rufen Sie alle Routen im IoT Hub ab.

Core Veraltet
az iot hub route show

Rufen Sie Informationen zur Route im IoT Hub ab.

Core Veraltet
az iot hub route test

Testen Sie alle Routen oder Erwähnung Route im IoT Hub.

Core Veraltet
az iot hub route update

Aktualisieren einer Route im IoT Hub.

Core Veraltet
az iot hub routing-endpoint

Verwalten benutzerdefinierter Endpunkte einer IoT Hub-Instanz.

Core Veraltet
az iot hub routing-endpoint create

Fügen Sie Ihrem IoT Hub einen Endpunkt hinzu.

Core Veraltet
az iot hub routing-endpoint delete

Löschen Sie den gesamten oder Erwähnung endpunkt für Ihren IoT Hub.

Core Veraltet
az iot hub routing-endpoint list

Erhalten Sie Informationen zu allen Endpunkten für Ihren IoT Hub.

Core Veraltet
az iot hub routing-endpoint show

Rufen Sie Informationen zum Erwähnung ed-Endpunkt für Ihren IoT Hub ab.

Core Veraltet
az iot hub show

Rufen Sie die Details eines IoT-Hubs ab.

Core Allgemein verfügbar
az iot hub show-connection-string

Zeigen Sie die Verbindungszeichenfolge für einen IoT-Hub an.

Core Veraltet
az iot hub show-quota-metrics

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

Core Allgemein verfügbar
az iot hub show-stats

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

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

Core Allgemein verfügbar
az iot hub wait

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

Core Allgemein verfügbar

az iot hub create

Erstellen Sie einen Azure IoT-Hub.

Eine Einführung in Azure IoT Hub finden Sie unter https://docs.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-to-Device-Nachrichten zwischen 1 und 48 Stunden Standard.

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. Standardmäßig ist dies der Speicherort Ihrer 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.2" festgelegt werden, damit Clients, die eine TLS-Version unter 1.2 verwenden, abgelehnt werden.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

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

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

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

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

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--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 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 eines 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 eines 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 eines Geräte-Verbindungszeichenfolge

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 eines Modul-Verbindungszeichenfolge

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

Ziel-Verbindungszeichenfolge. 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 Verbindungszeichenfolge Typen: 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

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 hub invoke-device-method

Aufrufen einer Gerätemethode.

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

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

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

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

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

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

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--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 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 Verwendung

az iot hub monitor-events -n {iothub_name}

Grundlegende Verwendung mit einem 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 Wild Karte 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. Kein Timeout.

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 Sekunden bis Standard verbindung ohne Empfang einer Nachricht. 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

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

az iot hub monitor-feedback -n {iothub_name}

Grundlegende Verwendung mit einem 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

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 hub query

Abfragen einer IoT Hub-Instanz 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://docs.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

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

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-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 hub show-connection-string

Als veraltet markiert

Dieser Befehl ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen den Befehl "IoT Extension (azure-iot) connection-string (az iot hub connection-string show)".

Zeigen Sie die Verbindungszeichenfolge für einen IoT-Hub an.

az iot hub show-connection-string [--all]
                                  [--hub-name]
                                  [--ids]
                                  [--key {primary, secondary}]
                                  [--policy-name]
                                  [--resource-group]
                                  [--subscription]

Beispiele

Zeigen Sie die Verbindungszeichenfolge eines IoT-Hubs mithilfe von Standardrichtlinien und Primärschlüsseln an.

az iot hub show-connection-string --name MyIotHub

Zeigen Sie die Verbindungszeichenfolge eines IoT-Hubs mithilfe von Richtlinien "Dienst" und sekundären Schlüssel an.

az iot hub show-connection-string --name MyIotHub --policy-name service --key secondary

Zeigen Sie die Verbindungszeichenfolge für alle IoT-Hubs in einer Ressourcengruppe an.

az iot hub show-connection-string --resource-group MyResourceGroup

Zeigen Sie die Verbindungszeichenfolge für alle IoT-Hubs in einem Abonnement an.

az iot hub show-connection-string

Zeigen Sie die Verbindungszeichenfolge für einen IoT-Hub an. (automatisch generiert)

az iot hub show-connection-string --key primary --policy-name MyPolicy

Optionale Parameter

--all

Zulassen, dass alle Richtlinien für den freigegebenen Zugriff angezeigt werden.

Standardwert: False
--hub-name --name -n

IoT Hub-Name.

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

--key

Der zu verwendende Schlüssel.

Zulässige Werte: primary, secondary
Standardwert: primary
--policy-name

Zu verwendende Richtlinie für den freigegebenen Zugriff.

Standardwert: iothubowner
--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 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

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

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-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 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]
                  [--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-to-Device-Nachrichten zwischen 1 und 48 Stunden Standard.

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

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

--rd --retention-day

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

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

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.

--unit

Einheiten in Ihrem IoT Hub.

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

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.

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

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

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

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

Standardwert: False
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.