Feedback

az iot hub

  • Referenz

Verwalten von Azure-IoT-Hubs

Befehle

az iot hub certificate

Verwalten von IoT Hub-Zertifikaten.
az iot hub certificate create

Erstellen/Hochladen eines Azure IoT Hub Zertifikats.
az iot hub certificate delete

Löscht ein Azure IoT Hub Zertifikat.
az iot hub certificate generate-verification-code

Generiert einen Überprüfungscode für ein Azure IoT Hub Zertifikat.
az iot hub certificate list

Listet alle Zertifikate auf, die in einem Azure IoT Hub enthalten sind.
az iot hub certificate show

Zeigt Informationen zu einem bestimmten Azure IoT Hub Zertifikat an.
az iot hub certificate update

Aktualisieren eines Azure IoT Hub Zertifikats.
az iot hub certificate verify

Überprüft ein Azure IoT Hub Zertifikat.
az iot hub configuration

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

Erstellen Sie eine Automatische Geräteverwaltungskonfiguration in einem Ziel IoT Hub.
az iot hub configuration delete

Löschen einer IoT-Gerätekonfiguration.
az iot hub configuration list

Auflisten von automatischen Geräteverwaltungskonfigurationen in einem IoT Hub.
az iot hub configuration show

Rufen Sie die Details einer automatischen Geräteverwaltungskonfiguration für IoT ab.
az iot hub configuration show-metric

Bewerten Sie eine Zielbenutzer- oder Systemmetrik, die in einer IoT-Gerätekonfiguration definiert ist.
az iot hub configuration update

Aktualisieren sie die angegebenen Eigenschaften einer automatischen Geräteverwaltungskonfiguration für IoT.

Verwenden Sie --set gefolgt von Eigenschaftenzuweisungen zum Aktualisieren einer Konfiguration.

Hinweis: Der Konfigurationsinhalt ist unveränderlich. Konfigurationseigenschaften, die aktualisiert werden können, sind "Bezeichnungen", "Metriken", "Priorität" und "targetCondition".
az iot hub connection-string

Verwalten sie IoT Hub Verbindungszeichenfolgen.
az iot hub connection-string show

Zeigen Sie die Verbindungszeichenfolgen für die angegebenen IoT Hubs mithilfe des angegebenen Richtliniennamens und des Schlüssels an.
az iot hub consumer-group

Verwalten Sie die Ereignishub-Verbrauchergruppen eines IoT-Hubs.
az iot hub consumer-group create

Erstellen Sie eine Ereignishub-Verbrauchergruppe.
az iot hub consumer-group delete

Löschen einer Ereignishub-Verbrauchergruppe.
az iot hub consumer-group list

Listen-Ereignishub-Verbrauchergruppen.
az iot hub consumer-group show

Rufen Sie die Details für eine Ereignishub-Verbrauchergruppe ab.
az iot hub create

Erstellen Sie einen Azure IoT-Hub.
az iot hub delete

Löschen Sie einen IoT-Hub.
az iot hub device-identity

Verwalten von IoT-Geräten.
az iot hub device-identity children

Verwalten von untergeordneten Gerätebeziehungen für IoT-Edgegeräte.
az iot hub device-identity children add

Fügen Sie Geräte als untergeordnete Geräte zu einem Zielrandgerät hinzu.
az iot hub device-identity children list

Gibt die Auflistung von zugewiesenen untergeordneten Geräten aus.
az iot hub device-identity children remove

Entfernen Sie untergeordnete Geräte aus einem Zielrandgerät.
az iot hub device-identity connection-string

Verwalten sie die Verbindungszeichenfolge des IoT-Geräts.
az iot hub device-identity connection-string show

Zeigen Sie eine bestimmte IoT Hub Geräteverbindungszeichenfolge an.
az iot hub device-identity create

Erstellen Sie ein Gerät in einem IoT Hub.
az iot hub device-identity delete

Löschen Sie ein IoT Hub Gerät.
az iot hub device-identity export

Exportieren Sie alle Geräteidentitäten aus einem IoT Hub in einen Azure Storage-Blobcontainer. Für inline-Blobcontainer-SAS-Eingaben überprüfen Sie bitte die Eingaberegeln Ihrer Umgebung.
az iot hub device-identity import

Importieren sie Geräteidentitäten in eine IoT Hub aus einem Blob. Für inline-Blobcontainer-SAS-Eingaben überprüfen Sie bitte die Eingaberegeln Ihrer Umgebung.
az iot hub device-identity list

Auflisten von Geräten in einem IoT Hub.
az iot hub device-identity parent

Verwalten von übergeordneten Gerätebeziehungen für IoT-Geräte.
az iot hub device-identity parent set

Legen Sie das übergeordnete Gerät eines Zielgeräts fest.
az iot hub device-identity parent show

Rufen Sie das übergeordnete Gerät eines Zielgeräts ab.
az iot hub device-identity renew-key

Verlängern Sie Zielschlüssel eines IoT Hub Geräts mit sas-Authentifizierung.
az iot hub device-identity show

Rufen Sie die Details eines IoT Hub Geräts ab.
az iot hub device-identity update

Aktualisieren eines IoT Hub Geräts.
az iot hub devicestream

Verwalten von Gerätestreams einer IoT Hub-Instanz.
az iot hub devicestream show

Abrufen IoT Hub Gerätestreamsendpunkte.
az iot hub device-twin

Verwalten der Konfiguration von IoT-Gerätezwillingen.
az iot hub device-twin replace

Ersetzen Sie die Geräte-Twindefinition durch Ziel-JSON.
az iot hub device-twin show

Rufen Sie eine Geräte-Twin-Definition ab.
az iot hub device-twin update

Aktualisieren sie die gewünschten Eigenschaften und Tags des Geräts.
az iot hub digital-twin

Bearbeiten und interagieren Sie mit dem digitalen Zwilling eines IoT Hub Geräts.
az iot hub digital-twin invoke-command

Rufen Sie einen Befehl auf Stamm- oder Komponentenebene eines digitalen Zwillingsgeräts auf.
az iot hub digital-twin show

Zeigen Sie den digitalen Zwilling eines IoT Hub Geräts an.
az iot hub digital-twin update

Aktualisieren Sie die Lese-/Schreibeigenschaften eines digitalen Twin-Geräts über die JSON-Patchspezifikation.
az iot hub distributed-tracing

Verwalten verteilter Einstellungen pro Gerät.
az iot hub distributed-tracing show

Rufen Sie die verteilten Ablaufverfolgungseinstellungen für ein Gerät ab.
az iot hub distributed-tracing update

Aktualisieren sie die verteilten Ablaufverfolgungsoptionen für ein Gerät.
az iot hub generate-sas-token

Generieren Sie ein SAS-Token für ein Ziel IoT Hub, Gerät oder Modul.
az iot hub identity

Verwalten von Identitäten eines Azure IoT-Hubs.
az iot hub identity assign

Weisen Sie verwaltete Identitäten einem IoT Hub zu.
az iot hub identity remove

Entfernen von verwalteten Identitäten aus einem IoT Hub.
az iot hub identity show

Zeigen Sie die Identitätseigenschaften eines IoT Hub an.
az iot hub invoke-device-method

Aufrufen einer Gerätemethode.
az iot hub invoke-module-method

Rufen Sie eine Edgemodulmethode auf.
az iot hub job

Verwalten von IoT Hub Aufträgen (v2).
az iot hub job cancel

Abbrechen eines IoT Hub Auftrags.
az iot hub job create

Erstellen und Planen eines IoT Hub Auftrags für die Ausführung.
az iot hub job list

Listet die historischen Aufträge eines IoT Hub auf.
az iot hub job show

Details eines vorhandenen IoT Hub Auftrags anzeigen.
az iot hub list

IoT-Hubs auflisten.
az iot hub list-skus

Auflisten der verfügbaren Tarife.
az iot hub manual-failover

Initiieren eines manuellen Failovers für die IoT Hub-Instanz in die geografisch gekoppelte Notfallwiederherstellungsregion.
az iot hub message-enrichment

Verwalten von Nachrichtenanreicherungen für Endpunkte einer IoT Hub-Instanz.
az iot hub message-enrichment create

Erstellen Sie eine Nachrichtenerweiterung für ausgewählte Endpunkte in Ihrem IoT Hub.
az iot hub message-enrichment delete

Löschen Sie eine Nachrichtenerweiterung in Ihrem IoT-Hub (nach Schlüssel).
az iot hub message-enrichment list

Erhalten Sie Informationen zu allen Nachrichtenerweiterungen für Ihre IoT Hub.
az iot hub message-enrichment update

Aktualisieren einer Nachrichtenerweiterung in Ihrem IoT-Hub (nach Schlüssel).
az iot hub module-identity

Verwalten von IoT-Gerätemodulen.
az iot hub module-identity connection-string

Verwalten der Verbindungszeichenfolge des IoT-Gerätemoduls.
az iot hub module-identity connection-string show

Anzeigen einer Ziel-IoT-Gerätemodulverbindungszeichenfolge.
az iot hub module-identity create

Erstellen Sie ein Modul auf einem Ziel-IoT-Gerät in einem IoT Hub.
az iot hub module-identity delete

Löschen eines Geräts in einem IoT Hub.
az iot hub module-identity list

Auflisten von Modulen auf einem IoT-Gerät in einem IoT Hub.
az iot hub module-identity renew-key

Verlängern Sie Zielschlüssel eines IoT Hub Gerätemoduls mit sas-Authentifizierung.
az iot hub module-identity show

Rufen Sie die Details eines IoT-Gerätemoduls in einem IoT Hub ab.
az iot hub module-identity update

Aktualisieren eines IoT Hub Gerätemoduls.
az iot hub module-twin

Verwalten der Konfiguration von IoT-Modulgerätezwillingen.
az iot hub module-twin replace

Ersetzen Sie eine Modul-Zwillingsdefinition durch Ziel-JSON.
az iot hub module-twin show

Zeigen Sie eine Doppeldefinition des Moduls an.
az iot hub module-twin update

Aktualisieren sie die gewünschten Eigenschaften und Tags des Moduls.
az iot hub monitor-events

Überwachen von Gerätetelemetrie und Nachrichten, die an eine IoT Hub-Instanz gesendet werden.
az iot hub monitor-feedback

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

Verwalten von Richtlinien für gemeinsamen Zugriff einer IoT Hub-Instanz.
az iot hub policy create

Erstellen Sie eine neue Richtlinie für den freigegebenen Zugriff in einem IoT-Hub.
az iot hub policy delete

Löschen sie eine Richtlinie für den freigegebenen Zugriff aus einem IoT-Hub.
az iot hub policy list

Listet freigegebene Zugriffsrichtlinien eines IoT-Hubs auf.
az iot hub policy renew-key

Generieren Sie Schlüssel einer freigegebenen Zugriffsrichtlinie eines IoT-Hubs neu.
az iot hub policy show

Rufen Sie die Details einer freigegebenen Zugriffsrichtlinie eines IoT-Hubs ab.
az iot hub query

Abfragen einer IoT Hub-Instanz mithilfe einer leistungsfähigen SQL-ähnlichen Sprache.
az iot hub route

Verwalten von Routen einer IoT Hub-Instanz.
az iot hub route create

Erstellen Sie eine Route in IoT Hub.
az iot hub route delete

Löschen Sie alle oder erwähnte Route für Ihre IoT Hub.
az iot hub route list

Rufen Sie alle Routen in IoT Hub ab.
az iot hub route show

Rufen Sie Informationen zur Route in IoT Hub ab.
az iot hub route test

Testen Sie alle Routen oder erwähnten Routen in IoT Hub.
az iot hub route update

Aktualisieren einer Route in IoT Hub.
az iot hub routing-endpoint

Verwalten benutzerdefinierter Endpunkte einer IoT Hub-Instanz.
az iot hub routing-endpoint create

Fügen Sie Ihrem IoT Hub einen Endpunkt hinzu.
az iot hub routing-endpoint delete

Löschen Sie alle oder erwähnten Endpunkte für Ihre IoT Hub.
az iot hub routing-endpoint list

Erhalten Sie Informationen zu allen Endpunkten für Ihre IoT Hub.
az iot hub routing-endpoint show

Rufen Sie Informationen zu erwähnten Endpunkten für Ihre IoT Hub ab.
az iot hub show

Rufen Sie die Details eines IoT-Hubs ab.
az iot hub show-connection-string

Zeigen Sie die Verbindungszeichenfolgen für einen IoT-Hub an.
az iot hub show-quota-metrics

Rufen Sie die Kontingentmetriken für einen IoT-Hub ab.
az iot hub show-stats

Rufen Sie die Statistiken für einen IoT-Hub ab.
az iot hub update

Aktualisieren von Metadaten für einen IoT-Hub.

az iot hub create

Bearbeiten

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]
                  [--fcu]
                  [--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]
                  [--partition-count]
                  [--rd]
                  [--role]
                  [--scopes]
                  [--sku {B1, B2, B3, F1, S1, S2, S3}]
                  [--tags]
                  [--unit]

Beispiele

Erstellen Sie eine 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 eine IoT Hub mit den Standardpreisstufen 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 eine 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 einer IoT Hub mit lokalen Authentifizierungs-, Geräte-SAS-Schlüsseln 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 eine IoT Hub mit erzwungener Datenbewahrung. Dadurch wird die notfallübergreifende Wiederherstellung 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 Anzahl der Male, in denen der IoT-Hub versucht, eine Cloud-zu-Gerät-Nachricht an ein Gerät zu übermitteln, zwischen 1 und 100.

Standardwert: 10
--c2d-ttl --ct

Der Zeitraum, zu dem eine Nachricht für das Gerät verfügbar ist, das verwendet werden kann, bevor es von IoT Hub zwischen 1 und 48 Stunden abgelaufen ist.

Standardwert: 1
--dds --disable-device-sas

Ein boolescher Wert, der angibt, ob alle Geräte deaktiviert werden sollen (einschließlich Edgegeräte, jedoch ohne Module), SAS-Schlüssel für die Authentifizierung.

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 im Modulbereich für die Authentifizierung deaktiviert werden sollen.

Zulässige Werte: false, true
--edr --enforce-data-residency

Erzwingen Sie die Datenaufbewahrung für diese IoT Hub, indem Sie die notfallübergreifende Notfallwiederherstellung deaktivieren. Diese Eigenschaft ist nach dem Festlegen der Ressource unveränderlich. 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 dem Sie Dateien hochladen. Der Container muss nicht vorhanden sein, sollte aber mithilfe der angegebenen connectionString-Eigenschaft bestellbar sein.

--fcs --fileupload-storage-connectionstring

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

--fcu --fileupload-storage-container-uri

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

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

Die Anzahl der Male, in denen 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 zum Ablauf oder Zur Übermittlung von Nachrichten über Cloud-zu-Gerät zwischen 1 und 48 Stunden verwaltet.

Standardwert: 1
--fileupload-notification-lock-duration --fnld

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

Standardwert: 5
--fileupload-notification-max-delivery-count --fnd

Die Anzahl der Male, in denen der IoT-Hub versucht, eine Dateibenachrichtigung zwischen 1 und 100 zu übermitteln.

Standardwert: 10
--fileupload-notification-ttl --fnt

Die Zeit, in der eine Dateiuploadbenachrichtigung verfügbar ist, damit der Dienst verwendet werden kann, bevor es von IoT Hub zwischen 1 und 48 Stunden abgelaufen ist.

Standardwert: 1
--fileupload-notifications --fn

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

Zulässige Werte: false, true
--fileupload-sas-ttl --fst

Der Zeitraum, zu 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

Speicherort Ihrer IoT Hub. 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 Von benutzern zugewiesenen verwalteten Identitäten für diesen Hub. Akzeptieren sie leertrennte 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.

--partition-count

Die Anzahl der Partitionen des Backing Event Hub 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 zum Zuweisen der vom System zugewiesenen verwalteten Identität des Hubs.

--scopes

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

--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 kostenlose Instanzen einen Wert überschreiten.

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

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

--unit

Einheiten in Ihrem IoT Hub.

Standardwert: 1

az iot hub delete

Bearbeiten

Löschen eines IoT-Hubs.

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

Beispiele

Löschen eines IoT-Hubs. (automatisch generiert)

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

Optionale Parameter

--ids

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

--name -n

IoT Hub Name.

--resource-group -g

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

az iot hub generate-sas-token

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

Für Geräte-SAS-Token wird der Richtlinienparameter verwendet, um nur auf die Geräteregistrierung zuzugreifen. Daher sollte die Richtlinie lesezugriff auf die Registrierung haben. Für IoT Hub Token ist die Richtlinie Teil des 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 Registrierungsread-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. 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 außer der Dauer werden ignoriert. Unterstützte Verbindungszeichenfolgentypen: Iot Hub, Gerät, Modul.

--device-id -d

Zielgerät.

--du --duration

Gültige Tokendauer in Sekunden.

Standardwert: 3600
--hub-name -n

IoT Hub Name. Erforderlich, wenn die Anmeldung 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ätsverbindungszeichenfolge mit Rechten zum Ausführen einer Aktion. Verwenden Sie die Verwendung, um die Sitzungsanmeldung über "az login" zu vermeiden. Wenn sowohl eine Entitätsverbindungszeichenfolge als auch ein Name angegeben werden, hat die Verbindungszeichenfolge Vorrang. Erforderlich, wenn --hub-name nicht bereitgestellt wird.

--module-id -m

Zielmodul.

--pn --policy-name

Freigegebene Zugriffsrichtlinie mit Vorgangsberechtigungen für Ziel-IoT Hub Entität.

Standardwert: iothubowner
--resource-group -g

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

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 dem Gerät aus der Cloud 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ät.

--method-name --mn

Zielmethode für Aufrufe.

Optionale Parameter

--auth-type

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

Zulässige Werte: key, login
Standardwert: key
--hub-name -n

IoT Hub Name. Erforderlich, wenn die Anmeldung nicht bereitgestellt wird.

--login -l

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

Standardwert: 30

az iot hub invoke-module-method

Rufen Sie eine Edgemodulmethode auf.

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 Edgegerät mit einem Modul aus der Cloud 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ät.

--method-name --mn

Zielmethode für Aufrufe.

--module-id -m

Zielmodul.

Optionale Parameter

--auth-type

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

Zulässige Werte: key, login
Standardwert: key
--hub-name -n

IoT Hub Name. Erforderlich, wenn die Anmeldung nicht bereitgestellt wird.

--login -l

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

Standardwert: 30

az iot hub list

Bearbeiten

Listet IoT-Hubs auf.

az iot hub list [--resource-group]

Beispiele

Alle IoT-Hubs in einem Abonnement auflisten.

az iot hub list

Alle IoT-Hubs in der Ressourcengruppe "MyGroup" auflisten

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.

az iot hub list-skus

Bearbeiten

Auflisten der verfügbaren Tarife.

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

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). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource 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.

az iot hub manual-failover

Bearbeiten

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]

Beispiele

Initiieren Sie failover "myhub" von primär zu sekundärer Region.

az iot hub manual-failover -n myhub

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource Id" angeben.

--name -n

IoT Hub Name.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--resource-group -g

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

az iot hub monitor-events

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

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

az iot hub monitor-events [--cg]
                          [--content-type]
                          [--device-id]
                          [--device-query]
                          [--enqueued-time]
                          [--hub-name]
                          [--interface]
                          [--login]
                          [--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 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 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 mit 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 Ereignishub-Verbrauchergruppe an, an die die Bindung gebunden werden 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. Nie Zeitüberschreitung.

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

Empfangen aller Nachrichtenattribute aus 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

Optionale Parameter

--cg --consumer-group -c

Geben Sie die Verbrauchergruppe an, die beim Herstellen einer Verbindung mit ereignishubendpunkt 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ät.

--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 Zeit "jetzt" angegeben wird.

--hub-name -n

IoT Hub Name. Erforderlich, wenn die Anmeldung nicht bereitgestellt wird.

--interface -i

Zielschnittstellenbezeichner zum Filtern. Beispiel: dtmi:com:example:TemperatureController;1.

--login -l

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

--module-id -m

Zielmodul.

--properties --props -p

Geben Sie wichtige Nachrichteneigenschaften für die Ausgabe an. sys = Systemeigenschaften, App = Anwendungseigenschaften, anno = Anmerkungen.

Zulässige Werte: all, anno, app, sys
--repair -r

Installieren Sie Uamqp-Abhängigkeiten neu, die mit der Erweiterungsversion kompatibel sind. Standardwert: false.

Zulässige Werte: false, true
--resource-group -g

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

--timeout --to -t

Maximale Sekunden zum Verwalten der Verbindung ohne Empfangen der Nachricht. Verwenden Sie 0 für unendlich.

Standardwert: 300
--yes -y

Benutzeraufforderungen überspringen. Gibt die Akzeptanz der Abhängigkeitsinstallation an (sofern erforderlich). Wird hauptsächlich für Automatisierungsszenarien verwendet. Standardwert: false.

Zulässige Werte: false, true

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 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 Zielgerät

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

Beenden des Feedbackmonitors beim Empfangen einer Nachricht mit einer bestimmten 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. 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ät.

--hub-name -n

IoT Hub Name. Erforderlich, wenn die Anmeldung nicht angegeben wird.

--login -l

Dieser Befehl unterstützt eine Entitätsverbindungszeichenfolge mit Rechten zum Ausführen einer Aktion. Verwenden Sie die Verwendung, um die Sitzungsanmeldung über "az login" zu vermeiden. Wenn sowohl eine Entitätsverbindungszeichenfolge 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
--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 Akzeptanz der Abhängigkeitsinstallation an (sofern erforderlich). Wird hauptsächlich für Automatisierungsszenarien verwendet. Standardwert: false.

Zulässige Werte: false, true

az iot hub query

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

Abfragen einer IoT Hub mithilfe einer leistungsstarken SQL-ähnlichen Sprache, um Informationen zu Geräte- und Modul-Twins, Aufträgen und Nachrichtenweiterleitung abzurufen. 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"

Abfragen aller Modul-Twin-Daten auf dem Zielgerät.

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

Erforderliche Parameter

--query-command -q

Benutzerabfrage, die ausgeführt werden soll.

Optionale Parameter

--auth-type

Gibt an, ob der Vorgang einen Richtlinienschlüssel automatisch ableiten oder die aktuelle Azure AD-Sitzung verwenden soll. 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. Erforderlich, wenn die Anmeldung nicht angegeben wird.

--login -l

Dieser Befehl unterstützt eine Entitätsverbindungszeichenfolge mit Rechten zum Ausführen einer Aktion. Verwenden Sie die Verwendung, um die Sitzungsanmeldung über "az login" zu vermeiden. Wenn sowohl eine Entitätsverbindungszeichenfolge 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 Obergrenze.

az iot hub show

Bearbeiten

Rufen Sie die Details eines IoT-Hubs ab.

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

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). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

IoT Hub Name.

--resource-group -g

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

az iot hub show-connection-string

Bearbeiten

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

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

Beispiele

Zeigen Sie die Verbindungszeichenfolge eines IoT-Hubs mithilfe der Standardrichtlinie und des Primärschlüssels an.

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

Zeigen Sie die Verbindungszeichenfolge einer IoT Hub mithilfe der Richtlinie "Dienst" und des sekundären Schlüssels an.

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

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

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

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

az iot hub show-connection-string

Zeigen Sie die Verbindungszeichenfolgen 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.

--hub-name --name -n

IoT Hub Name.

--ids

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

--key

Der zu verwendende Schlüssel.

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

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

az iot hub show-quota-metrics

Bearbeiten

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

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

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). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

IoT Hub Name.

--resource-group -g

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

az iot hub show-stats

Bearbeiten

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

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

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). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

IoT Hub Name.

--resource-group -g

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

az iot hub update

Bearbeiten

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]
                  [--fcu]
                  [--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}]
                  [--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 einer IoT Hub auf 2 und Hinzufügen von Tags

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

Preisniveau für eine IoT Hub als S2 aktualisieren

az iot hub update -n MyIotHub --sku S2

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

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

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

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

Aktualisieren der Einstellungen für IoT Hub Feedbackwarteschleife

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 Sperresdauer der Warteschlange

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 IoT Hub lokalen Authentifizierungs-, Geräte-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>.

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

Die Anzahl der Male, in denen der IoT-Hub versucht, eine Cloud-zu-Gerät-Nachricht an ein Gerät zu übermitteln, zwischen 1 und 100.

--c2d-ttl --ct

Der Zeitraum, zu dem eine Nachricht für das Gerät verfügbar ist, das verwendet werden kann, bevor es von IoT Hub zwischen 1 und 48 Stunden abgelaufen ist.

--dds --disable-device-sas

Ein boolescher Wert, der angibt, ob alle Geräte deaktiviert werden sollen (einschließlich Edgegeräte, jedoch ohne Module), SAS-Schlüssel für die Authentifizierung.

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 im Modulbereich für die Authentifizierung deaktiviert werden sollen.

Zulässige Werte: false, true
--fc --fileupload-storage-container-name

Der Name des Stammcontainers, in dem Sie Dateien hochladen. Der Container muss nicht vorhanden sein, sollte aber mithilfe der angegebenen connectionString-Eigenschaft bestellbar sein.

--fcs --fileupload-storage-connectionstring

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

--fcu --fileupload-storage-container-uri

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

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

Die Anzahl der Male, in denen 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 zum Ablauf oder Zur Übermittlung von Nachrichten über Cloud-zu-Gerät zwischen 1 und 48 Stunden verwaltet.

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

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

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

Die Anzahl der Male, in denen der IoT-Hub versucht, eine Dateibenachrichtigung zwischen 1 und 100 zu übermitteln.

--fileupload-notification-ttl --fnt

Die Zeit, in der eine Dateiuploadbenachrichtigung verfügbar ist, damit der Dienst verwendet werden kann, bevor es von IoT Hub zwischen 1 und 48 Stunden abgelaufen ist.

--fileupload-notifications --fn

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

Zulässige Werte: false, true
--fileupload-sas-ttl --fst

Der Zeitraum, zu 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.

--ids

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

--name -n

IoT Hub Name.

--rd --retention-day

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

--remove

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

--resource-group -g

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

--set

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

--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 kostenlose Instanzen einen Wert überschreiten.

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

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

--unit

Einheiten in Ihrem IoT Hub.