az iot central device-template

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-template. Obtenga más información sobre las extensiones.

Administrar y configurar plantillas de dispositivo de IoT Central.

Comandos

Nombre	Description	Tipo	Estado
az iot central device-template create	Cree una plantilla de dispositivo en IoT Central.	Extension	GA
az iot central device-template delete	Elimine una plantilla de dispositivo de IoT Central.	Extension	GA
az iot central device-template list	Obtenga la lista de plantillas de dispositivo para una aplicación de IoT Central.	Extension	GA
az iot central device-template show	Obtenga una plantilla de dispositivo de IoT Central.	Extension	GA
az iot central device-template update	Actualice una plantilla de dispositivo en IoT Central.	Extension	GA

az iot central device-template create

Cree una plantilla de dispositivo en IoT Central.

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

Ejemplos

Creación de una plantilla de dispositivo con carga leída desde un archivo

az iot central device-template create --app-id {appid} --content {pathtofile} --device-template-id {devicetemplateid}

Creación de una plantilla de dispositivo con carga leída desde json sin formato

az iot central device-template create --app-id {appid} --content {json} --device-template-id {devicetemplateid}

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.

--content -k

Definición de la plantilla de dispositivo. Proporcione la ruta de acceso al archivo JSON o json con cadena sin formato. [Ejemplo de ruta de acceso de archivo: ./path/to/file.json] [Ejemplo de JSON con cadena: {Device Template JSON}]. El cuerpo de la solicitud debe contener CapabilityModel.

--device-template-id --dtid

Identificador de modelo de gemelo digital de la plantilla de dispositivo. Obtenga más información en https://aka.ms/iotcentraldtmi.

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-template delete

Elimine una plantilla de dispositivo de IoT Central.

Nota: Se espera que se produzca un error si algún dispositivo todavía está asociado a esta plantilla.

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

Ejemplos

Eliminación de una plantilla de dispositivo de IoT Central

az iot central device-template delete --app-id {appid} --device-template-id {devicetemplateid}

Parámetros requeridos

--app-id -n

--device-template-id --dtid

Identificador de la plantilla de dispositivo de destino. Ejemplo: somedevicetemplate.

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.

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

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-template list

Obtenga la lista de plantillas de dispositivo para una aplicación de IoT Central.

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

Ejemplos

Enumerar todas las plantillas de dispositivo de una aplicación, ordenadas por identificador de plantilla (valor predeterminado)

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

Parámetros requeridos

--app-id -n

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.

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

--compact -c

Mostrar plantillas en modo compacto. Para cada plantilla solo se mostrarán los tipos id, name y model.

Propiedad	Valor
Valor predeterminado:	False

--token

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-template show

Obtenga una plantilla de dispositivo de IoT Central.

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

Ejemplos

Obtención de una plantilla de dispositivo

az iot central device-template show --app-id {appid} --device-template-id {devicetemplateid}

Parámetros requeridos

--app-id -n

--device-template-id --dtid

Identificador de la plantilla de dispositivo de destino. Ejemplo: somedevicetemplate.

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.

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

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-template update

Actualice una plantilla de dispositivo en IoT Central.

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

Ejemplos

Actualización de una plantilla de dispositivo con carga leída desde un archivo

az iot central device-template update --app-id {appid} --content {pathtofile} --device-template-id {devicetemplateid}

Actualización de una plantilla de dispositivo con carga leída desde json sin formato

az iot central device-template update --app-id {appid} --content {json} --device-template-id {devicetemplateid}

Parámetros requeridos

--app-id -n

--content -k

--device-template-id --dtid

Identificador de la plantilla de dispositivo de destino. Ejemplo: somedevicetemplate.

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.

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

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

Comentarios

¿Le ha resultado útil esta página?

Compartir a través de

az iot central device-template

Comandos

az iot central device-template create

Ejemplos

Parámetros requeridos

Parámetros opcionales

az iot central device-template delete

Ejemplos

Parámetros requeridos

Parámetros opcionales

az iot central device-template list

Ejemplos

Parámetros requeridos

Parámetros opcionales

az iot central device-template show

Ejemplos

Parámetros requeridos

Parámetros opcionales

az iot central device-template update

Ejemplos

Parámetros requeridos

Parámetros opcionales

Comentarios