Compartir a través de


az iot central device

Note

Esta referencia forma parte de la extensión azure-iot para la CLI de Azure (versión 2.67.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az iot central device. Obtenga más información sobre las extensiones.

Administrar y configurar dispositivos IoT Central.

Comandos

Nombre Description Tipo Estado
az iot central device attestation

Administre y configure la atestación de dispositivos de IoT Central.

Extension GA
az iot central device attestation create

Cree una atestación de dispositivo individual.

Extension GA
az iot central device attestation delete

Quite una atestación de dispositivo individual.

Extension GA
az iot central device attestation show

Obtiene la atestación del dispositivo.

Extension GA
az iot central device attestation update

Actualice una atestación de dispositivo individual a través de la revisión.

Extension GA
az iot central device c2d-message

Ejecute comandos de mensajería de nube a dispositivo de dispositivo.

Extension GA
az iot central device c2d-message purge

Purga la cola de mensajes de la nube al dispositivo de destino.

Extension GA
az iot central device command

Ejecute comandos de dispositivo.

Extension GA
az iot central device command history

Obtenga los detalles de la solicitud de comando y la respuesta más recientes enviadas al dispositivo.

Extension GA
az iot central device command run

Ejecute un comando en un dispositivo y vea la respuesta asociada. No supervisa las actualizaciones de propiedades que el comando puede realizar.

Extension GA
az iot central device compute-device-key

Genere una clave SAS de dispositivo derivada.

Extension GA
az iot central device create

Cree un dispositivo en IoT Central.

Extension GA
az iot central device delete

Elimine un dispositivo de IoT Central.

Extension GA
az iot central device edge

Administrar y configurar dispositivos perimetrales de IoT Central.

Extension GA
az iot central device edge children

Administrar dispositivos secundarios del dispositivo IoT Edge.

Extension GA
az iot central device edge children add

Agregue dispositivos como elementos secundarios a un dispositivo perimetral de destino.

Extension Preview
az iot central device edge children list

Obtenga la lista de elementos secundarios de un dispositivo IoT Edge.

Extension GA
az iot central device edge children remove

Quite los dispositivos secundarios de un dispositivo perimetral de destino.

Extension Preview
az iot central device edge manifest

Administrar manifiestos de dispositivo IoT Edge.

Extension Preview
az iot central device edge manifest show

Obtenga el manifiesto de implementación asociado al dispositivo IoT Edge especificado.

Extension Preview
az iot central device edge module

Administrar módulos de dispositivo IoT Edge.

Extension Preview
az iot central device edge module list

Obtenga la lista de módulos de un dispositivo IoT Edge.

Extension Preview
az iot central device edge module restart

Reinicie un módulo en un dispositivo IoT Edge.

Extension Preview
az iot central device edge module show

Obtenga un módulo en un dispositivo IoT Edge.

Extension Preview
az iot central device list

Obtenga la lista de dispositivos de una aplicación de IoT Central.

Extension GA
az iot central device list-components

Enumere los componentes presentes en un dispositivo.

Extension GA
az iot central device list-modules

Enumere los módulos presentes en un dispositivo.

Extension GA
az iot central device manual-failback

Revierte el comando de conmutación por error ejecutado anteriormente moviendo el dispositivo de nuevo a ioT Hub original.

Extension GA
az iot central device manual-failover

Ejecute una conmutación por error manual del dispositivo en varios centros de IoT Hub para validar la capacidad del firmware del dispositivo para volver a conectarse mediante DPS a otra instancia de IoT Hub.

Extension GA
az iot central device registration-info

Obtenga información de registro en los dispositivos de IoT Central.

Extension GA
az iot central device show

Obtenga un dispositivo de IoT Central.

Extension GA
az iot central device show-credentials

Obtenga las credenciales del dispositivo de IoT Central.

Extension GA
az iot central device telemetry

Consulte el último valor de telemetría del dispositivo IoT Central.

Extension GA
az iot central device telemetry show

Obtenga el último valor de telemetría de un dispositivo.

Extension GA
az iot central device twin

Administrar dispositivos gemelos de IoT Central.

Extension GA
az iot central device twin replace

Reemplace los valores de propiedad grabables de un dispositivo, un componente de dispositivo o un módulo de dispositivo o un componente de módulo de dispositivo.

Extension GA
az iot central device twin show

Obtenga todos los valores de propiedad de un dispositivo, un componente de dispositivo, un módulo de dispositivo o un componente de módulo de dispositivo.

Extension GA
az iot central device twin update

Actualice los valores de propiedad grabables de un dispositivo, un componente de dispositivo, un módulo de dispositivo o un componente de módulo de dispositivo.

Extension GA
az iot central device update

Actualice un dispositivo en IoT Central.

Extension GA

az iot central device compute-device-key

Genere una clave SAS de dispositivo derivada.

Genere una clave de dispositivo derivada a partir de una clave SAS de nivel de grupo.

az iot central device compute-device-key --device-id
                                         --pk --primary-key

Ejemplos

Uso básico

az iot central device compute-device-key --pk {primaryKey} --device-id {deviceid}

Parámetros requeridos

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

--pk --primary-key

Clave de acceso compartido simétrica principal almacenada en formato base64.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot central device create

Cree un dispositivo en IoT Central.

az iot central device create --app-id
                             --device-id
                             [--api-version --av {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri --central-dns-suffix]
                             [--device-name]
                             [--organizations --orgs]
                             [--simulated {false, true}]
                             [--template]
                             [--token]

Ejemplos

Creación de un dispositivo

az iot central device create --app-id {appid} --device-id {deviceid}

Creación de un dispositivo simulado

az iot central device create --app-id {appid} --device-id {deviceid} --template {devicetemplateid} --simulated

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

--device-id -d

Identificador único del dispositivo. Cadena que distingue mayúsculas de minúsculas (hasta 128 caracteres) de caracteres alfanuméricos ASCII de 7 bits más determinados caracteres especiales: - . + % _ # * ? ! ( ) , : = @ $ '.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version --av
Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad Valor
Valor predeterminado: 2022-07-31
Valores aceptados: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad Valor
Valor predeterminado: azureiotcentral.com
--device-name

Nombre de dispositivo legible para personas. Ejemplo: Nevera.

--organizations --orgs

Asigne el dispositivo a las organizaciones especificadas. Lista separada por comas de identificadores de organización. Versión mínima admitida: 1.1-preview.

--simulated

Agregue esta marca si desea que IoT Central lo configure como un dispositivo simulado. --template es necesario si esto es true.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--template

Id. de plantilla central. Ejemplo: dtmi:ojpkindbz:modelDefinition:iild3tm_uo.

--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot central device delete

Elimine un dispositivo de IoT Central.

az iot central device delete --app-id
                             --device-id
                             [--api-version --av {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri --central-dns-suffix]
                             [--token]

Ejemplos

Eliminar un dispositivo

az iot central device delete --app-id {appid} --device-id {deviceid}

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version --av
Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad Valor
Valor predeterminado: 2022-07-31
Valores aceptados: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad Valor
Valor predeterminado: azureiotcentral.com
--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot central device list

Obtenga la lista de dispositivos de una aplicación de IoT Central.

az iot central device list --app-id
                           [--api-version --av {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri --central-dns-suffix]
                           [--edge-only]
                           [--token]

Ejemplos

Enumerar todos los dispositivos de una aplicación, ordenados por identificador de dispositivo (valor predeterminado)

az iot central device list --app-id {appid}

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version --av
Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad Valor
Valor predeterminado: 2022-07-31
Valores aceptados: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad Valor
Valor predeterminado: azureiotcentral.com
--edge-only -e

Solo se muestran los dispositivos IoT Edge.

Propiedad Valor
Valor predeterminado: False
--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot central device list-components

Enumere los componentes presentes en un dispositivo.

az iot central device list-components --app-id
                                      --device-id
                                      [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri --central-dns-suffix]
                                      [--mn --module-name]
                                      [--token]

Ejemplos

Enumeración de los componentes presentes en un dispositivo

az iot central device list-components --app-id {appid} --device-id {deviceid}

Enumeración de los componentes presentes en un módulo de dispositivo

az iot central device list-components --app-id {appid} --module-name {modulename} --device-id {deviceid}

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version --av
Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad Valor
Valor predeterminado: 2022-07-31
Valores aceptados: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad Valor
Valor predeterminado: azureiotcentral.com
--mn --module-name

Nombre del módulo de dispositivo.

--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot central device list-modules

Enumere los módulos presentes en un dispositivo.

az iot central device list-modules --app-id
                                   --device-id
                                   [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri --central-dns-suffix]
                                   [--token]

Ejemplos

Enumerar los módulos presentes en un dispositivo

az iot central device list-modules --app-id {appid} --device-id {deviceid}

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version --av
Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad Valor
Valor predeterminado: 2022-07-31
Valores aceptados: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad Valor
Valor predeterminado: azureiotcentral.com
--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot central device manual-failback

Revierte el comando de conmutación por error ejecutado anteriormente moviendo el dispositivo de nuevo a ioT Hub original.

Para obtener más información sobre la alta disponibilidad, visite https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

az iot central device manual-failback --app-id
                                      --device-id
                                      [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri --central-dns-suffix]
                                      [--token]

Ejemplos

Revierte el comando de conmutación por error ejecutado anteriormente moviendo el dispositivo de nuevo a su instancia original de IoT Hub.

az iot central device manual-failback --app-id {appid} --device-id {deviceid}

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version --av
Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad Valor
Valor predeterminado: 2022-07-31
Valores aceptados: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad Valor
Valor predeterminado: azureiotcentral.com
--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot central device manual-failover

Ejecute una conmutación por error manual del dispositivo en varios centros de IoT Hub para validar la capacidad del firmware del dispositivo para volver a conectarse mediante DPS a otra instancia de IoT Hub.

Para obtener más información sobre la alta disponibilidad y el valor predeterminado de ttl-minutes, visite https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

az iot central device manual-failover --app-id
                                      --device-id
                                      [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri --central-dns-suffix]
                                      [--token]
                                      [--ttl --ttl-minutes]

Ejemplos

Ejecute una conmutación por error manual del dispositivo en varios centros de IoT Hub para validar la capacidad del firmware del dispositivo para volver a conectarse mediante DPS a otra instancia de IoT Hub.

az iot central device manual-failover --app-id {appid} --device-id {deviceid} --ttl-minutes {ttl_minutes}

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version --av
Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad Valor
Valor predeterminado: 2022-07-31
Valores aceptados: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad Valor
Valor predeterminado: azureiotcentral.com
--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

--ttl --ttl-minutes

Un entero positivo. TTL en minutos para volver al dispositivo al centro original. Tiene el valor predeterminado en back-end. Consulte la documentación sobre el valor predeterminado del back-end más reciente; para ello, visite https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot central device registration-info

Obtenga información de registro en los dispositivos de IoT Central.

Nota: Este comando puede tardar mucho tiempo en devolverse si no se especifica ningún identificador de dispositivo y la aplicación contiene una gran cantidad de dispositivos.

az iot central device registration-info --app-id
                                        --device-id
                                        [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                        [--central-api-uri --central-dns-suffix]
                                        [--token]

Ejemplos

Obtener información de registro en el dispositivo especificado

az iot central device registration-info --app-id {appid} --device-id {deviceid}

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version --av
Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad Valor
Valor predeterminado: 2022-07-31
Valores aceptados: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad Valor
Valor predeterminado: azureiotcentral.com
--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot central device show

Obtenga un dispositivo de IoT Central.

az iot central device show --app-id
                           --device-id
                           [--api-version --av {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri --central-dns-suffix]
                           [--token]

Ejemplos

Obtención de un dispositivo

az iot central device show --app-id {appid} --device-id {deviceid}

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version --av
Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad Valor
Valor predeterminado: 2022-07-31
Valores aceptados: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad Valor
Valor predeterminado: azureiotcentral.com
--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot central device show-credentials

Obtenga las credenciales del dispositivo de IoT Central.

az iot central device show-credentials --app-id
                                       --device-id
                                       [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri --central-dns-suffix]
                                       [--token]

Ejemplos

Obtención de credenciales de dispositivo para un dispositivo

az iot central device show-credentials --app-id {appid} --device-id {deviceid}

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version --av
Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad Valor
Valor predeterminado: 2022-07-31
Valores aceptados: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad Valor
Valor predeterminado: azureiotcentral.com
--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az iot central device update

Actualice un dispositivo en IoT Central.

Permite cambiar las siguientes propiedades de un dispositivo: "displayName", "template", "simulated", "enabled" y "organizations". No se puede cambiar el identificador del dispositivo.

az iot central device update --app-id
                             --device-id
                             [--api-version --av {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri --central-dns-suffix]
                             [--device-name]
                             [--enable {false, true}]
                             [--organizations --orgs]
                             [--simulated {false, true}]
                             [--template]
                             [--token]

Ejemplos

Actualizar un nombre para mostrar del dispositivo

az iot central device update --app-id {appid} --device-id {deviceid} --device-name {deviceName}

Convertir un dispositivo simulado en uno real

az iot central device update --app-id {appid} --device-id {deviceid} --simulated false

Actualizar organizaciones para el dispositivo

az iot central device update --app-id {appid} --device-id {deviceid} --organizations {organizations}

Deshabilitar un dispositivo

az iot central device update --app-id {appid} --device-id {deviceid} --enable false

Parámetros requeridos

--app-id -n

El identificador de aplicación de la aplicación de IoT Central que quiere administrar. Puede encontrar el identificador de aplicación en la página "Acerca de" de la aplicación en el menú de ayuda.

--device-id -d

Identificador de dispositivo del dispositivo de destino. Para encontrar el identificador de dispositivo, haga clic en el botón Conectar de la página Detalles del dispositivo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--api-version --av
Obsoleto

El argumento "api_version" está en desuso y se quitará en una versión futura.

Este parámetro de comando está en desuso y se omitirá. En la versión futura, solo se admitirán las API de IoT Central desde la versión más reciente de disponibilidad general. Si alguna API aún no está disponible, llamaremos a la versión preliminar más reciente.

Propiedad Valor
Valor predeterminado: 2022-07-31
Valores aceptados: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

Sufijo DNS de IoT Central asociado a la aplicación.

Propiedad Valor
Valor predeterminado: azureiotcentral.com
--device-name

Nombre de dispositivo legible para personas. Ejemplo: Nevera.

--enable

Agregue esta marca si desea que IoT Central habilite o deshabilite el dispositivo.

Propiedad Valor
Valores aceptados: false, true
--organizations --orgs

Asigne el dispositivo a las organizaciones especificadas. Lista separada por comas de identificadores de organización. Versión mínima admitida: 1.1-preview.

--simulated

Agregue esta marca si desea que IoT Central lo configure como un dispositivo simulado. --template es necesario si esto es true.

Propiedad Valor
Valores aceptados: false, true
--template

Id. de plantilla central. Ejemplo: dtmi:ojpkindbz:modelDefinition:iild3tm_uo.

--token

Si prefiere enviar la solicitud sin autenticarse en la CLI de Azure, puede especificar un token de usuario válido para autenticar la solicitud. Debe especificar el tipo de clave como parte de la solicitud. Obtenga más información en https://aka.ms/iotcentraldocsapi.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False