az iot central device edge children

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.30.0 or higher). The extension will automatically install the first time you run an az iot central device edge children command. Learn more about extensions.

Manage IoT Edge device children devices.

Commands

az iot central device edge children add

Add devices as children to a target edge device.

az iot central device edge children list

Get the list of children of an IoT Edge device.

az iot central device edge children remove

Remove child devices from a target edge device.

az iot central device edge children add

Add devices as children to a target edge device.

az iot central device edge children add --app-id
                                        --children-ids
                                        --device-id
                                        [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                                        [--central-api-uri]
                                        [--token]

Examples

Add space-separated list of device Ids as children to the target edge device.

az iot central device edge children add --app-id {appid} --device-id {deviceId} --children-ids {child_1} {child_2}

Required Parameters

--app-id -n

The App ID of the IoT Central app you want to manage. You can find the App ID in the "About" page for your application under the help menu.

--children-ids

Space-separated list of children device ids.

--device-id -d

The device ID of the target device.You can find the device ID by, clicking on the Connect button on the Device Details page.

Optional Parameters

--api-version --av

The API version for the requested operation.

accepted values: 1.0, 1.1-preview, 2022-05-31, preview
default value: 2022-05-31
--central-api-uri --central-dns-suffix

The IoT Central DNS suffix associated with your application.

default value: azureiotcentral.com
--token

If you'd prefer to submit your request without authenticating against the Azure CLI, you can specify a valid user token to authenticate your request. You must specify the type of key as part of the request. Learn more at https://aka.ms/iotcentraldocsapi.

az iot central device edge children list

Get the list of children of an IoT Edge device.

az iot central device edge children list --app-id
                                         --device-id
                                         [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                                         [--central-api-uri]
                                         [--token]

Examples

List all children of a device.

az iot central device edge children list --app-id {appid} --device-id {deviceId}

Required Parameters

--app-id -n

The App ID of the IoT Central app you want to manage. You can find the App ID in the "About" page for your application under the help menu.

--device-id -d

The device ID of the target device.You can find the device ID by, clicking on the Connect button on the Device Details page.

Optional Parameters

--api-version --av

The API version for the requested operation.

accepted values: 1.0, 1.1-preview, 2022-05-31, preview
default value: 2022-05-31
--central-api-uri --central-dns-suffix

The IoT Central DNS suffix associated with your application.

default value: azureiotcentral.com
--token

If you'd prefer to submit your request without authenticating against the Azure CLI, you can specify a valid user token to authenticate your request. You must specify the type of key as part of the request. Learn more at https://aka.ms/iotcentraldocsapi.

az iot central device edge children remove

Remove child devices from a target edge device.

az iot central device edge children remove --app-id
                                           --children-ids
                                           --device-id
                                           [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                                           [--central-api-uri]
                                           [--token]

Examples

Remove children.

az iot central device edge children remove --app-id {appid} --device-id {deviceId} --children-ids {child_1} {child_2}

Required Parameters

--app-id -n

The App ID of the IoT Central app you want to manage. You can find the App ID in the "About" page for your application under the help menu.

--children-ids

Space-separated list of children device ids.

--device-id -d

The device ID of the target device.You can find the device ID by, clicking on the Connect button on the Device Details page.

Optional Parameters

--api-version --av

The API version for the requested operation.

accepted values: 1.0, 1.1-preview, 2022-05-31, preview
default value: 2022-05-31
--central-api-uri --central-dns-suffix

The IoT Central DNS suffix associated with your application.

default value: azureiotcentral.com
--token

If you'd prefer to submit your request without authenticating against the Azure CLI, you can specify a valid user token to authenticate your request. You must specify the type of key as part of the request. Learn more at https://aka.ms/iotcentraldocsapi.