az iot hub device-identity

Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung installiert automatisch beim ersten Ausführen eines Az iot Hub-Geräteidentitätsbefehls . Weitere Informationen zu Erweiterungen

Verwalten von IoT-Geräten.

Befehle

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 device-identity create

Erstellen Sie ein Gerät in einem IoT Hub.

Wenn Sie die Auth-Methode von shared_private_key (auch als symmetrische Schlüssel bezeichnet) verwenden, wird der Dienst für das Gerät keine benutzerdefinierten Schlüssel generiert.

Wenn ein Gerätebereich für ein Edgegerät bereitgestellt wird, wird der Wert automatisch in einen übergeordneten Bereich konvertiert.

az iot hub device-identity create --device-id
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--device-scope]
                                  [--edge-enabled {false, true}]
                                  [--hub-name]
                                  [--login]
                                  [--od]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--sta {disabled, enabled}]
                                  [--star]
                                  [--valid-days]

Beispiele

Erstellen Sie ein Edge-aktiviertes IoT-Gerät mit Standardautorisierung (freigegebener privater Schlüssel).

az iot hub device-identity create -n {iothub_name} -d {device_id} --ee

Erstellen Sie ein IoT-Gerät mit selbst signierter Zertifikatberechtigung, generieren Sie ein Zertifikat, das für 10 Tage gültig ist, und verwenden Sie dann den Fingerabdruck.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --valid-days 10

Erstellen Sie ein IoT-Gerät mit selbst signierter Zertifikatberechtigung, generieren Sie ein Zertifikat des Standardablaufs (365 Tage) und die Ausgabe im Zielverzeichnis.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --output-dir /path/to/output

Erstellen Sie ein IoT-Gerät mit selbst signierter Zertifikatberechtigung und bieten explizit primäre und sekundäre Fingerabdruckdrucke.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --ptp {thumbprint_1} --stp {thumbprint_2}

Erstellen Sie ein IoT-Gerät mit Stamm-CA-Autorisierung mit deaktiviertem Status und Grund.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_ca --status disabled --status-reason 'for reasons'

Erstellen Sie ein IoT-Gerät mit einem Gerätebereich.

az iot hub device-identity create -n {iothub_name} -d {device_id} --device-scope 'ms-azure-iot-edge://edge0-123456789123456789'

Erforderliche Parameter

--device-id -d

Zielgerät.

Optionale Parameter

--am --auth-method

Die Autorisierungsmethode, mit der eine Entität erstellt werden soll.

Zulässige Werte: shared_private_key, x509_ca, x509_thumbprint

Standardwert: shared_private_key

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

--device-scope

Der Bereich des Geräts. Bei Edgegeräten wird dies automatisch generiert und unveränderlich. Legen Sie dies für Blattgeräte fest, um untergeordnete/übergeordnete Beziehung zu erstellen.

--edge-enabled --ee

Flag, das die Edgeaktivierung angibt.

Zulässige Werte: false, true

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

--od --output-dir

Generieren Sie selbstsigniertes Zertifikat und verwenden Sie den Fingerabdruck. Ausgabe in angegebenes Zielverzeichnis.

--pk --primary-key

Der primäre symmetrische Zugriffsschlüssel, der im Base64-Format gespeichert ist.

--primary-thumbprint --ptp

Selbstsignierter Zertifikat-Fingerabdruck, der für den primären Fingerabdruck verwendet werden soll.

--resource-group -g

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

--secondary-key --sk

Der sekundäre symmetrische Zugriffsschlüssel, der im Base64-Format gespeichert ist.

--secondary-thumbprint --stp

Selbstsignierter Zertifikat-Fingerabdruck, der für den sekundären Fingerabdruck verwendet werden soll.

--sta --status

Legen Sie den Gerätestatus beim Erstellen fest.

Zulässige Werte: disabled, enabled

Standardwert: enabled

--star --status-reason

Beschreibung für den Gerätestatus.

--valid-days --vd

Generieren Sie selbstsigniertes Zertifikat und verwenden Sie den Fingerabdruck. Gültig für die angegebene Anzahl von Tagen. Standard: 365.

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.

--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 device-identity delete

Löschen Sie ein IoT Hub Gerät.

az iot hub device-identity delete --device-id
                                  [--auth-type {key, login}]
                                  [--etag]
                                  [--hub-name]
                                  [--login]
                                  [--resource-group]

Erforderliche Parameter

--device-id -d

Zielgerät.

Optionale Parameter

--auth-type

Zulässige Werte: key, login

Standardwert: key

--etag -e

Etag oder Entitätstag, das dem letzten Zustand der Ressource entspricht. Wenn kein Etag bereitgestellt wird, wird der Wert '*' verwendet.

--hub-name -n

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

--login -l

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

--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 device-identity export

Exportieren Sie alle Geräteidentitäten aus einem IoT Hub in einen Azure Storage-Blobcontainer. Überprüfen Sie für inline-BLOB-Container-SAS-URI-Eingaben die Eingaberegeln Ihrer Umgebung.

Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities.

az iot hub device-identity export --bcu
                                  --hub-name
                                  [--auth-type {identity, key}]
                                  [--identity]
                                  [--ik {false, true}]
                                  [--resource-group]

Beispiele

Exportieren Sie alle Geräteidentitäten in einen konfigurierten Blobcontainer und enthalten Geräteschlüssel. Verwendet ein Inline-SAS-uri-Beispiel.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices?sv=2019-02-02&st=2020-08-23T22%3A35%3A00Z&se=2020-08-24T22%3A35%3A00Z&sr=c&sp=rwd&sig=VrmJ5sQtW3kLzYg10VqmALGCp4vtYKSLNjZDDJBSh9s%3D'

Exportieren Sie alle Geräteidentitäten in einen konfigurierten Blobcontainer mithilfe eines Dateipfads, der den SAS-URI enthält.

az iot hub device-identity export -n {iothub_name} --bcu {sas_uri_filepath}

Exportieren Sie alle Geräteidentitäten in einen konfigurierten Blobcontainer und enthalten Geräteschlüssel. Verwendet die vom System zugewiesene Identität, die über Rollen des Storage Blob Data-Mitwirkenden für das Speicherkonto verfügt. Der Blobcontainer-URI benötigt nicht das BLOB-SAS-Token.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --auth-type identity --identity [system]

Exportieren Sie alle Geräteidentitäten in einen konfigurierten Blobcontainer und schließen Sie Geräteschlüssel ein. Verwendet die vom Benutzer zugewiesene verwaltete Identität, die über Speicher-Blob-Daten-Mitwirkenderollen für das Speicherkonto und den Mitwirkenden für den IoT-Hub verfügt. Der Blobcontainer-URI benötigt nicht das BLOB-SAS-Token.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --auth-type identity --identity {managed_identity_resource_id}

Erforderliche Parameter

--bcu --blob-container-uri

Blob Shared Access Signature URI mit Schreib-, Lese- und Löschzugriff auf einen Blobcontainer. Dies wird verwendet, um den Status des Auftrags und die Ergebnisse auszuzugeben. Hinweis: Bei verwendung der identitätsbasierten Authentifizierung ist weiterhin ein https:// URI erforderlich – aber kein SAS-Token ist erforderlich. Eingaben für dieses Argument können inline oder über einen Dateipfad erfolgen.

--hub-name -n

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

Optionale Parameter

--auth-type --storage-authentication-type

Authentifizierungstyp für die Kommunikation mit dem Speichercontainer.

Zulässige Werte: identity, key

--identity

Verwalteter Identitätstyp, um zu ermitteln, ob die vom System zugewiesene verwaltete Identität oder die vom Benutzer zugewiesene verwaltete Identität verwendet wird. Verwenden Sie [system] für die zugewiesene verwaltete Identität des Systems[ system]. Stellen Sie für die vom Benutzer zugewiesene verwaltete Identität die verwaltete Identitätsressource-ID bereit. Diese Identität erfordert eine Rollen des Speicher-Blob-Daten-Mitwirkenden für das Speicherkonto.

--ik --include-keys

Wenn festgelegt, werden Schlüssel normal exportiert. Andernfalls werden Schlüssel in der Exportausgabe auf NULL festgelegt.

Zulässige Werte: false, true

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

--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 device-identity import

Importieren von Geräteidentitäten in eine IoT Hub aus einem Blob. Überprüfen Sie für inline-BLOB-Container-SAS-URI-Eingaben die Eingaberegeln Ihrer Umgebung.

Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-identity-registry#import-and-export-device-identities.

az iot hub device-identity import --hub-name
                                  --ibcu
                                  --obcu
                                  [--auth-type {identity, key}]
                                  [--identity]
                                  [--resource-group]

Beispiele

Importieren Sie alle Geräteidentitäten aus einem Blob mithilfe eines Inline-SAS-URI.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri}

Importieren Sie alle Geräteidentitäten aus einem Blob mithilfe eines Dateipfads, der SAS-URI enthält.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri_filepath} --obcu {output_sas_uri_filepath}

Importieren Sie alle Geräteidentitäten aus einem Blob mithilfe der vom System zugewiesenen Identität mit Rollen für Speicher-Blob-Daten-Mitwirkende für beide Speicherkonten. Der Blobcontainer-URI benötigt nicht das BLOB-SAS-Token.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --auth-type identity --identity [system]

Importieren Sie alle Geräteidentitäten aus einem Blob mithilfe der vom Benutzer zugewiesenen verwalteten Identität mit Rollen für Speicher-Blob-Daten-Mitwirkende für Speicherkonten und Mitwirkender für den IoT-Hub. Der Blobcontainer-URI benötigt nicht das BLOB-SAS-Token.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --auth-type identity --identity {managed_identity_resource_id}

Erforderliche Parameter

--hub-name -n

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

--ibcu --input-blob-container-uri

Blob Shared Access Signature URI mit Lesezugriff auf einen BLOB-Container. Dieses Blob enthält die Vorgänge, die für die Identitätsregistrierung ausgeführt werden sollen. Hinweis: Bei verwendung der identitätsbasierten Authentifizierung ist weiterhin ein https:// URI erforderlich – aber kein SAS-Token ist erforderlich. Eingaben für dieses Argument können inline oder über einen Dateipfad erfolgen.

--obcu --output-blob-container-uri

Blob Shared Access Signature URI mit Schreibzugriff auf einen BLOB-Container. Dies wird verwendet, um den Status des Auftrags und die Ergebnisse auszuzugeben. Hinweis: Bei Verwendung der identitätsbasierten Authentifizierung ist weiterhin ein https:// URI ohne das SAS-Token erforderlich. Eingaben für dieses Argument können inline oder über einen Dateipfad erfolgen.

Optionale Parameter

--auth-type --storage-authentication-type

Authentifizierungstyp für die Kommunikation mit dem Speichercontainer.

Zulässige Werte: identity, key

--identity

Verwalteter Identitätstyp, um zu ermitteln, ob die vom System zugewiesene verwaltete Identität oder die vom Benutzer zugewiesene verwaltete Identität verwendet wird. Verwenden Sie [system] für die zugewiesene verwaltete Identität des Systems[ system]. Stellen Sie für die vom Benutzer zugewiesene verwaltete Identität die verwaltete Identitätsressource-ID bereit. Diese Identität erfordert eine Rolle "Storage Blob Data Contributor" für die Rolle "Zielspeicherkonto" und "Mitwirkender" für die IoT Hub.

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

--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 device-identity list

Auflisten von Geräten in einem IoT Hub.

az iot hub device-identity list [--auth-type {key, login}]
                                [--edge-enabled {false, true}]
                                [--hub-name]
                                [--login]
                                [--resource-group]
                                [--top]

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

--edge-enabled --ee

Kennzeichen, das die Randaktivierung angibt.

Zulässige Werte: false, true

--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. Verwenden Sie -1 für unbegrenzt.

Standardwert: 1000

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.

--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 device-identity renew-key

Verlängern Von Zielschlüsseln eines IoT Hub Geräts mit sas-Authentifizierung.

az iot hub device-identity renew-key --device-id
                                     --hub-name
                                     --key-type {primary, secondary, swap}
                                     [--auth-type {key, login}]
                                     [--etag]
                                     [--login]
                                     [--resource-group]

Beispiele

Verlängern Sie den Primärschlüssel.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt primary

Tauschen Sie die primären und sekundären Schlüssel aus.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt swap

Erforderliche Parameter

--device-id -d

Zielgerät.

--hub-name -n

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

--key-type --kt

Zielschlüsseltyp, der neu generiert werden soll.

Zulässige Werte: primary, secondary, swap

Optionale Parameter

--auth-type

Zulässige Werte: key, login

Standardwert: key

--etag -e

Etag- oder Entitätstag, das dem letzten Status der Ressource entspricht. Wenn kein etag angegeben wird, wird der Wert '*' verwendet.

--login -l

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

--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 device-identity show

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

az iot hub device-identity show --device-id
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--resource-group]

Erforderliche Parameter

--device-id -d

Zielgerät.

Optionale Parameter

--auth-type

Zulässige Werte: key, login

Standardwert: key

--hub-name -n

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

--login -l

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

--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 device-identity update

Aktualisieren eines IoT Hub Geräts.

Verwenden Sie --set gefolgt von Eigenschaftenzuweisungen zum Aktualisieren eines Geräts. Nutzen Sie parameter, die von "iot hub device-identity show" zurückgegeben werden.

az iot hub device-identity update --device-id
                                  [--add]
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--edge-enabled {false, true}]
                                  [--etag]
                                  [--force-string]
                                  [--hub-name]
                                  [--login]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--remove]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--set]
                                  [--sta {disabled, enabled}]
                                  [--star]

Beispiele

Aktivieren von Edgefunktionen für Geräte

az iot hub device-identity update -d {device_id} -n {iothub_name} --set capabilities.iotEdge=true

Aktivieren Sie Edgefunktionen für Geräte mithilfe des Komfortarguments.

az iot hub device-identity update -d {device_id} -n {iothub_name} --ee

Gerätestatus deaktivieren

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled

Deaktivieren Sie den Gerätestatus mithilfe des Komfortarguments.

az iot hub device-identity update -d {device_id} -n {iothub_name} --status disabled

In einem Befehl

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled capabilities.iotEdge=true

Erforderliche Parameter

--device-id -d

Zielgerät.

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

--am --auth-method

Die Autorisierungsmethode, mit der eine Entität erstellt werden soll.

Zulässige Werte: shared_private_key, x509_ca, x509_thumbprint

--auth-type

Zulässige Werte: key, login

Standardwert: key

--edge-enabled --ee

Kennzeichen, das die Randaktivierung angibt.

Zulässige Werte: false, true

--etag -e

Etag- oder Entitätstag, das dem letzten Status der Ressource entspricht. Wenn kein etag angegeben wird, wird der Wert '*' verwendet.

--force-string

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

--hub-name -n

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

--login -l

--pk --primary-key

Der primäre symmetrische freigegebene Zugriffsschlüssel, der im Base64-Format gespeichert ist.

--primary-thumbprint --ptp

Selbstsignierter Zertifikat-Fingerabdruck, der für den primären Fingerabdruck verwendet werden soll.

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

--secondary-key --sk

Der sekundäre symmetrische freigegebene Zugriffsschlüssel, der im Base64-Format gespeichert ist.

--secondary-thumbprint --stp

Selbstsignierter Zertifikat-Fingerabdruck, der für den sekundären Fingerabdruck verwendet werden soll.

--set

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

--sta --status

Legen Sie den Gerätestatus bei der Erstellung fest.

Zulässige Werte: disabled, enabled

--star --status-reason

Beschreibung für den Gerätestatus.

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.

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

Befehle

az iot hub device-identity create

Beispiele

Erforderliche Parameter

Optionale Parameter

az iot hub device-identity delete

Erforderliche Parameter

Optionale Parameter

az iot hub device-identity export

Beispiele

Erforderliche Parameter

Optionale Parameter

az iot hub device-identity import

Beispiele

Erforderliche Parameter

Optionale Parameter

az iot hub device-identity list

Optionale Parameter

az iot hub device-identity renew-key

Beispiele

Erforderliche Parameter

Optionale Parameter

az iot hub device-identity show

Erforderliche Parameter

Optionale Parameter

az iot hub device-identity update

Beispiele

Erforderliche Parameter

Optionale Parameter

Feedback