az iot hub device-identity children

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). Die Erweiterung wird automatisch installiert, wenn Sie ein az iot hub device-identity children Befehl ausführen. Learn more about extensions.

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

Befehle

Name	Beschreibung	Typ	Status
az iot hub device-identity children add	Fügen Sie Geräte als untergeordnete Geräte zu einem Ziel-Edgegerät hinzu.	Extension	GA
az iot hub device-identity children list	Gibt die Auflistung der zugewiesenen untergeordneten Geräte aus.	Extension	GA
az iot hub device-identity children remove	Entfernen sie untergeordnete Geräte von einem Ziel-Edgegerät.	Extension	GA

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 --cl
                                        --device-id
                                        [--auth-type {key, login}]
                                        [--force]
                                        [--hub-name]
                                        [--login]
                                        [--resource-group]

Beispiele

Fügen Sie dem Ziel-Edgegerät eine durch Leerzeichen getrennte Liste von Geräte-IDs als untergeordnete Elemente 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 Elemente 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 (durch Leerzeichen getrennt).

--device-id -d

ID des Edgegeräts.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Eigenschaft	Wert
Parameter group:	Access Control Arguments
Standardwert:	key
Zulässige Werte:	key, login

--force -f

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

Eigenschaft	Wert
Standardwert:	False

--hub-name -n

IoT Hub-Name oder Hostname. Erforderlich, wenn --login nicht angegeben wird.

Eigenschaft	Wert
Parameter group:	IoT Hub Identifier Arguments

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

Eigenschaft	Wert
Parameter group:	IoT Hub Identifier Arguments

--resource-group -g

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

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az iot hub device-identity children list

Gibt die Auflistung der zugewiesenen untergeordneten Geräte aus.

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

Beispiele

Alle zugewiesenen untergeordneten Geräte auflisten.

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Eigenschaft	Wert
Parameter group:	Access Control Arguments
Standardwert:	key
Zulässige Werte:	key, login

--hub-name -n

IoT Hub-Name oder Hostname. Erforderlich, wenn --login nicht angegeben wird.

Eigenschaft	Wert
Parameter group:	IoT Hub Identifier Arguments

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

Eigenschaft	Wert
Parameter group:	IoT Hub Identifier Arguments

--resource-group -g

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

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

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 --cl]
                                           [--hub-name]
                                           [--login]
                                           [--remove-all]
                                           [--resource-group]

Beispiele

Entfernen Sie eine durch Leerzeichen getrennte 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Eigenschaft	Wert
Parameter group:	Access Control Arguments
Standardwert:	key
Zulässige Werte:	key, login

--child-list --cl

Untergeordnete Geräteliste (durch Leerzeichen getrennt).

--hub-name -n

IoT Hub-Name oder Hostname. Erforderlich, wenn --login nicht angegeben wird.

Eigenschaft	Wert
Parameter group:	IoT Hub Identifier Arguments

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

Eigenschaft	Wert
Parameter group:	IoT Hub Identifier Arguments

--remove-all -a

So entfernen Sie alle untergeordneten Elemente.

Eigenschaft	Wert
Standardwert:	False

--resource-group -g

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

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False