Feedback

az iot hub device-identity children

  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie zum ersten Mal einen az iot Hub-Geräteidentitäts-Untergeordneten Befehl ausführen. Weitere Informationen zu Erweiterungen

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

Befehle

az iot hub device-identity children add

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

Gibt die Auflistung zugewiesener untergeordneter Geräte aus.
az iot hub device-identity children remove

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

az iot hub device-identity children add

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

az iot hub device-identity children add --child-list
                                        --device-id
                                        [--auth-type {key, login}]
                                        [--force]
                                        [--hub-name]
                                        [--login]
                                        [--resource-group]

Beispiele

Fügen Sie eine leer getrennte Liste von Geräte-IDs als untergeordnete Elemente zum Ziel-Edgegerät hinzu.

az iot hub device-identity children add -d {edge_device_id} --child-list {child_device_id_1} {child_device_id_2} -n {iothub_name}

Fügen Sie Geräte als untergeordnete Geräte zum Edgegerät hinzu, und überschreiben Sie das vorhandene übergeordnete Element der untergeordneten Geräte.

az iot hub device-identity children add -d {edge_device_id} --child-list {child_device_id_1} {child_device_id_2} -n {iothub_name} -f

Erforderliche Parameter

--child-list --cl

Untergeordnete Geräteliste (leer getrennt).

--device-id -d

ID des Edgegeräts.

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

Überschreibt das übergeordnete Gerät des untergeordneten Geräts.

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

az iot hub device-identity children list

Gibt die Auflistung zugewiesener untergeordneter Geräte aus.

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

Beispiele

Listet alle zugewiesenen untergeordneten Geräte auf.

az iot hub device-identity children list -d {edge_device_id} -n {iothub_name}

Alle zugewiesenen untergeordneten Geräte auflisten, deren Geräte-ID eine Teilzeichenfolge von "test" enthält.

az iot hub device-identity children list -d {edge_device_id} -n {iothub_name} --query "[?contains(@,'test')]"

Erforderliche Parameter

--device-id -d

ID des Edgegeräts.

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.

az iot hub device-identity children remove

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

az iot hub device-identity children remove --device-id
                                           [--auth-type {key, login}]
                                           [--child-list]
                                           [--hub-name]
                                           [--login]
                                           [--remove-all]
                                           [--resource-group]

Beispiele

Entfernen Sie eine leerzeichentrennte Liste untergeordneter Geräte von einem übergeordneten Zielgerät.

az iot hub device-identity children remove -d {edge_device_id} --child-list {space_separated_device_id} -n {iothub_name}

Entfernen Sie alle untergeordneten Geräte von einem übergeordneten Zielgerät.

az iot hub device-identity children remove -d {edge_device_id} --remove-all

Erforderliche Parameter

--device-id -d

ID des Edgegeräts.

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
--child-list --cl

Untergeordnete Geräteliste (leer getrennt).

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

--remove-all -a

So entfernen Sie alle untergeordneten Elemente.

--resource-group -g

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