az iot central device

Nota:

Esta referencia forma parte de la extensión azure-iot para la CLI de Azure (versión 2.37.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.

Extensión GA
az iot central device attestation create

Cree una atestación de dispositivo individual.

Extensión GA
az iot central device attestation delete

Quite una atestación de dispositivo individual.

Extensión GA
az iot central device attestation show

Obtiene la atestación del dispositivo.

Extensión GA
az iot central device attestation update

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

Extensión GA
az iot central device c2d-message

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

Extensión GA
az iot central device c2d-message purge

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

Extensión GA
az iot central device command

Ejecute comandos de dispositivo.

Extensión GA
az iot central device command history

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

Extensión 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.

Extensión GA
az iot central device compute-device-key

Genere una clave SAS de dispositivo derivada.

Extensión GA
az iot central device create

Cree un dispositivo en IoT Central.

Extensión GA
az iot central device delete

Elimine un dispositivo de IoT Central.

Extensión GA
az iot central device edge

Administrar y configurar dispositivos perimetrales de IoT Central.

Extensión GA
az iot central device edge children

Administrar dispositivos secundarios del dispositivo IoT Edge.

Extensión GA
az iot central device edge children add

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

Extensión Vista previa
az iot central device edge children list

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

Extensión GA
az iot central device edge children remove

Quite los dispositivos secundarios de un dispositivo perimetral de destino.

Extensión Vista previa
az iot central device edge manifest

Administrar manifiestos de dispositivo IoT Edge.

Extensión Vista previa
az iot central device edge manifest show

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

Extensión Vista previa
az iot central device edge module

Administrar módulos de dispositivo IoT Edge.

Extensión Vista previa
az iot central device edge module list

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

Extensión Vista previa
az iot central device edge module restart

Reinicie un módulo en un dispositivo IoT Edge.

Extensión Vista previa
az iot central device edge module show

Obtenga un módulo en un dispositivo IoT Edge.

Extensión Vista previa
az iot central device list

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

Extensión GA
az iot central device list-components

Enumere los componentes presentes en un dispositivo.

Extensión GA
az iot central device list-modules

Enumere los módulos presentes en un dispositivo.

Extensión 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.

Extensión 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.

Extensión GA
az iot central device registration-info

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

Extensión GA
az iot central device show

Obtenga un dispositivo de IoT Central.

Extensión GA
az iot central device show-credentials

Obtenga las credenciales del dispositivo de IoT Central.

Extensión GA
az iot central device telemetry

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

Extensión GA
az iot central device telemetry show

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

Extensión GA
az iot central device twin

Administrar dispositivos gemelos de IoT Central.

Extensión 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.

Extensión 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.

Extensión 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.

Extensión GA
az iot central device update

Actualice un dispositivo en IoT Central.

Extensión 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

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az iot central device create

Cree un dispositivo en IoT Central.

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

Ejemplos

Crear un dispositivo

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

Cree 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

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

valores aceptados: 2022-06-30-preview, 2022-07-31
valor predeterminado: 2022-07-31
--central-api-uri --central-dns-suffix

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

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.

valores aceptados: false, true
valor predeterminado: False
--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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az iot central device delete

Elimine un dispositivo de IoT Central.

az iot central device delete --app-id
                             --device-id
                             [--api-version {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri]
                             [--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

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

valores aceptados: 2022-06-30-preview, 2022-07-31
valor predeterminado: 2022-07-31
--central-api-uri --central-dns-suffix

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

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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 {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--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

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

valores aceptados: 2022-06-30-preview, 2022-07-31
valor predeterminado: 2022-07-31
--central-api-uri --central-dns-suffix

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

valor predeterminado: azureiotcentral.com
--edge-only -e

Solo se muestran los dispositivos IoT Edge.

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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 {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--mn]
                                      [--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

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

valores aceptados: 2022-06-30-preview, 2022-07-31
valor predeterminado: 2022-07-31
--central-api-uri --central-dns-suffix

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

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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 {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri]
                                   [--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

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

valores aceptados: 2022-06-30-preview, 2022-07-31
valor predeterminado: 2022-07-31
--central-api-uri --central-dns-suffix

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

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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 {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--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

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

valores aceptados: 2022-06-30-preview, 2022-07-31
valor predeterminado: 2022-07-31
--central-api-uri --central-dns-suffix

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

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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 {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--token]
                                      [--ttl]

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

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

valores aceptados: 2022-06-30-preview, 2022-07-31
valor predeterminado: 2022-07-31
--central-api-uri --central-dns-suffix

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

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 tiempo predeterminado de back-end más reciente para el valor activo visitando https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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 {2022-06-30-preview, 2022-07-31}]
                                        [--central-api-uri]
                                        [--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

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

valores aceptados: 2022-06-30-preview, 2022-07-31
valor predeterminado: 2022-07-31
--central-api-uri --central-dns-suffix

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

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az iot central device show

Obtenga un dispositivo de IoT Central.

az iot central device show --app-id
                           --device-id
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--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

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

valores aceptados: 2022-06-30-preview, 2022-07-31
valor predeterminado: 2022-07-31
--central-api-uri --central-dns-suffix

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

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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 {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri]
                                       [--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

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

valores aceptados: 2022-06-30-preview, 2022-07-31
valor predeterminado: 2022-07-31
--central-api-uri --central-dns-suffix

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

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

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 {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri]
                             [--device-name]
                             [--enable {false, true}]
                             [--organizations]
                             [--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}

Deshabilitación de 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

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

valores aceptados: 2022-06-30-preview, 2022-07-31
valor predeterminado: 2022-07-31
--central-api-uri --central-dns-suffix

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

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.

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.

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.