az iot hub state

  • Experimentell
  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.37.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az iot Hub-Zustandsbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Diese Befehlsgruppe ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten Sie den Status eines IoT-Hubs.

Weitere Informationen finden Sie unter aka.ms/aziotcli-iot-hub-state.

Befehle

Name Beschreibung Typ Status
az iot hub state export

Exportieren Sie den Status eines IoT Hub in eine Datei.

 Durchwahl Experimentell
az iot hub state import

Importieren Sie einen Hubstatus aus einer Datei in einen IoT Hub.

 Durchwahl Experimentell
az iot hub state migrate

Migrieren Sie den Status eines Hubs zu einem anderen Hub, ohne in einer Datei zu speichern.

 Durchwahl Experimentell

az iot hub state export

Experimentell

Die Befehlsgruppe "iot hub state" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Exportieren Sie den Status eines IoT Hub in eine Datei.

Standardmäßig enthält der exportierte Zustand: Arm-Vorlage für Hub-, Hubkonfigurationen (einschließlich ADM-Konfigurationen und Edgebereitstellungen), Geräteinformationen (einschließlich Geräteidentiten, Geräte twins, Modulidentitäten und Modul-Twins).

Weitere Informationen finden Sie unter aka.ms/aziotcli-iot-hub-state.

az iot hub state export --state-file
                        [--aspects {arm, configurations, devices}]
                        [--auth-type {key, login}]
                        [--hub-name]
                        [--login]
                        [--replace]
                        [--resource-group]

Beispiele

Exportieren Sie den unterstützten Status des angegebenen Hubs in die angegebene Datei.

az iot hub state export -n {iothub_name} -f {state_filename}

Exportieren Sie den unterstützten Status des angegebenen Hubs in die angegebene Datei, und überschreiben Sie den Dateiinhalt.

az iot hub state export -n {iothub_name} -f {state_filename} -r

Exportieren Sie nur die Geräte und Konfigurationen des angegebenen Hubs in die angegebene Datei.

az iot hub state export -n {iothub_name} -f {state_filename} --aspects devices configurations

Erforderliche Parameter

--state-file -f

Der Pfad zur Datei, in der die Statusinformationen gespeichert werden.

Optionale Parameter

--aspects

Hubaspekte (durch Leerzeichen getrennt).

Zulässige Werte: arm, configurations, devices
--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.

--replace -r

Wenn dieses Flag festgelegt ist, überschreibt der Befehl den Inhalt der Ausgabedatei.

Standardwert: False
--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 state import

Experimentell

Die Befehlsgruppe "iot hub state" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Importieren Sie einen Hubstatus aus einer Datei in einen IoT Hub.

Wenn der Arm-Aspekt angegeben ist, wird der Hub erstellt, wenn er nicht vorhanden ist.

Standardmäßig enthält der importierte Zustand: Arm-Vorlage für Hub-, Hubkonfigurationen (einschließlich ADM-Konfigurationen und Edgebereitstellungen), Geräteinformationen (einschließlich Geräteidentiten, Geräte twins, Modulidentitäten und Modul-Twins).

Für importierte Endpunkte mit der vom System zugewiesenen Identitätsauthentifizierung muss der angegebene Hub über die richtigen Berechtigungen verfügen. Andernfalls schlägt der Befehl fehl.

Private Endpunkte werden im Importvorgang ignoriert.

Weitere Informationen finden Sie unter aka.ms/aziotcli-iot-hub-state.

az iot hub state import --state-file
                        [--aspects {arm, configurations, devices}]
                        [--auth-type {key, login}]
                        [--hub-name]
                        [--login]
                        [--replace]
                        [--resource-group]

Beispiele

Importieren Sie den unterstützten Zustand aus der angegebenen Datei in den angegebenen Hub.

az iot hub state import -n {iothub_name} -f {state_filename}

Importieren Sie den unterstützten Zustand aus der angegebenen Datei in den angegebenen Hub, und überschreiben Sie den vorherigen Zustand des Hubs. Alle Zertifikate, Konfigurationen und Geräte werden gelöscht, bevor der neue Zustand hochgeladen wird.

az iot hub state import -n {iothub_name} -f {state_filename} -r

Importieren Sie nur die Armvorlage aus der angegebenen Datei in den angegebenen Hub. Beachten Sie, dass dadurch ein neuer Hub erstellt wird, wenn er nicht vorhanden ist. Die Datei kann die Geräte und Konfigurationen enthalten, diese werden jedoch ignoriert.

az iot hub state import -n {iothub_name} -g {resource_group} -f {state_filename} --aspects arm

Importieren Sie nur die Geräte und Konfigurationen aus der angegebenen Datei in den angegebenen Hub. Beachten Sie, dass dadurch KEIN neuer Hub erstellt wird, wenn er nicht vorhanden ist und der Befehl fehlschlägt. Die Datei kann die Armvorlage enthalten, die jedoch ignoriert wird.

az iot hub state import -n {iothub_name} -f {state_filename} --aspects devices configurations

Erforderliche Parameter

--state-file -f

Der Pfad zur Datei, in der die Statusinformationen gespeichert werden.

Optionale Parameter

--aspects

Hubaspekte (durch Leerzeichen getrennt).

Zulässige Werte: arm, configurations, devices
--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.

--replace -r

Wenn dieses Kennzeichen festgelegt ist, löscht der Befehl die aktuellen Geräte, Konfigurationen und Zertifikate des Zielhubs.

Standardwert: False
--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 state migrate

Experimentell

Die Befehlsgruppe "iot hub state" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Migrieren Sie den Status eines Hubs zu einem anderen Hub, ohne in einer Datei zu speichern.

Wenn der Arm-Aspekt angegeben ist, wird der Hub erstellt, wenn er nicht vorhanden ist.

Standardmäßig enthält der migrierte Zustand: Arm-Vorlage für Hub-, Hubkonfigurationen (einschließlich ADM-Konfigurationen und Edgebereitstellungen), Geräteinformationen (einschließlich Geräteidentiten, Geräte twins, Modulidentitäten und Modul-Twins).

Für migrierte Endpunkte mit der vom System zugewiesenen Identitätsauthentifizierung muss der angegebene Hub über die richtigen Berechtigungen verfügen. Andernfalls schlägt der Befehl fehl.

Private Endpunkte werden im Migrationsprozess ignoriert.

Wenn Sie Probleme beim Migrieren haben, verwenden Sie die Export- und Importbefehle, um eine Datei als Sicherung zu verwenden.

Weitere Informationen finden Sie unter aka.ms/aziotcli-iot-hub-state.

az iot hub state migrate [--aspects {arm, configurations, devices}]
                         [--auth-type {key, login}]
                         [--destination-hub]
                         [--destination-hub-login]
                         [--destination-resource-group]
                         [--og]
                         [--oh]
                         [--ol]
                         [--replace]

Beispiele

Migrieren Sie den unterstützten Status des Ursprungshubs zum Zielhub.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name}

Migrieren Sie den unterstützten Status des Ursprungshubs zum Zielhub, und überschreiben Sie den vorherigen Zustand des Hubs. Alle Zertifikate, Konfigurationen und Geräte im Zielhub werden gelöscht, bevor der neue Zustand hochgeladen wird.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name} -r

Migrieren Sie nur die Armvorlage vom Ursprungshub zum Zielhub. Beachten Sie, dass dadurch ein neuer Hub erstellt wird, wenn der Zielhub nicht vorhanden ist. Der Origin Hub kann die Geräte und Konfigurationen enthalten, diese werden jedoch ignoriert.

az iot hub state migrate --destination-hub {dest_hub_name} --destination-resource-group {dest_hub_resource_group} --origin-hub {orig_hub_name} --aspects arm

Migrieren Sie nur die Geräte und Konfigurationen vom Ursprungshub zum Zielhub. Beachten Sie, dass dadurch KEIN neuer Hub erstellt wird, wenn der Zielhub nicht vorhanden ist und der Befehl fehlschlägt. Die Armvorlage für den Origin Hub wird ignoriert.

az iot hub state migrate --destination-hub {dest_hub_name} --origin-hub {orig_hub_name} --aspects devices configurations

Optionale Parameter

--aspects

Hubaspekte (durch Leerzeichen getrennt).

Zulässige Werte: arm, configurations, devices
--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
--destination-hub --dh

Der Name des IoT-Hubs, in den der Ursprungshubstatus kopiert wird.

--destination-hub-login --dl

Dieser Befehl unterstützt eine Entität Verbindungszeichenfolge mit Rechten zum Ausführen von Aktionen auf dem Zielhub. Wird verwendet, um die Sitzungsanmeldung für az login diese IoT Hub-Instanz zu vermeiden. Wenn sowohl eine Entität Verbindungszeichenfolge als auch ein Name angegeben werden, hat die Verbindungszeichenfolge Vorrang. Erforderlich, wenn --destination-hub nicht angegeben wird.

--destination-resource-group --dg

Name der Ressourcengruppe des IoT Hub, in den der Ursprungshubstatus kopiert wird. Wenn nicht angegeben, verwendet die IoT Hub-Ressourcengruppe des Ursprungs.

--og --origin-resource-group

Name der Ressourcengruppe des IoT Hub, der kopiert wird.

--oh --origin-hub

Der Name des IoT Hub, der kopiert wird.

--ol --origin-hub-login

Dieser Befehl unterstützt eine Entität Verbindungszeichenfolge mit Rechten zum Ausführen von Aktionen auf dem Origin Hub. Wird verwendet, um die Sitzungsanmeldung für az login diese IoT Hub-Instanz zu vermeiden. Wenn sowohl eine Entität Verbindungszeichenfolge als auch ein Name angegeben werden, hat die Verbindungszeichenfolge Vorrang. Erforderlich, wenn --origin-hub nicht angegeben wird.

--replace -r

Wenn dieses Kennzeichen festgelegt ist, löscht der Befehl die aktuellen Geräte, Konfigurationen und Zertifikate des Zielhubs.

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.