Compartir a través de


az iot ops ns device

Note

Esta referencia forma parte de la extensión azure-iot-ops 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 ops ns device . Obtenga más información sobre las extensiones.

El grupo de comandos "iot ops ns" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administrar dispositivos en espacios de nombres del Registro de dispositivos.

Comandos

Nombre Description Tipo Estado
az iot ops ns device create

Cree un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device delete

Elimine un dispositivo de un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint

Administrar puntos de conexión para dispositivos en espacios de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint inbound

Administrar puntos de conexión de entrada para dispositivos en espacios de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint inbound add

Agregue puntos de conexión de entrada a dispositivos en espacios de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint inbound add custom

Agregue un punto de conexión de entrada personalizado a un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint inbound add media

Agregue un punto de conexión de entrada multimedia a un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint inbound add mqtt

Agregue un punto de conexión de entrada MQTT a un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint inbound add onvif

Agregue un punto de conexión de entrada ONVIF a un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint inbound add opcua

Agregue un punto de conexión de entrada de OPC UA a un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint inbound add rest

Agregue un punto de conexión de entrada de rest a un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint inbound add sse

Agregue un punto de conexión de entrada SSE a un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint inbound list

Enumere los puntos de conexión entrantes de un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint inbound remove

Quite los puntos de conexión entrantes de un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device endpoint list

Enumere todos los puntos de conexión de un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device query

Consulta de dispositivos en espacios de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device show

Muestra los detalles de un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview
az iot ops ns device update

Actualice un dispositivo en un espacio de nombres del Registro de dispositivos.

Extension Preview

az iot ops ns device create

Vista previa

El grupo de comandos "iot ops ns" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree un dispositivo en un espacio de nombres del Registro de dispositivos.

El dispositivo se vinculará a una instancia de Azure IoT Operations.

az iot ops ns device create --instance
                            --name
                            --resource-group
                            [--attr --custom-attribute]
                            [--disabled {false, true}]
                            [--manufacturer]
                            [--model]
                            [--os]
                            [--os-version --osv]
                            [--tags]

Ejemplos

Creación de un dispositivo con una configuración mínima

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup

Creación de un dispositivo con atributos personalizados

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --attr location=building1 floor=3

Creación de un dispositivo con información del fabricante y detalles del sistema operativo

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --manufacturer "Contoso" --model "Gateway X1" --os "Linux" --os-version "4.15"

Creación de un dispositivo deshabilitado con etiquetas

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --disabled --tags environment=test criticality=low

Parámetros requeridos

--instance -i

Nombre de la instancia de Azure IoT Operations.

--name -n

Nombre del dispositivo que se va a crear.

--resource-group -g

El grupo de recursos de la instancia de Azure IoT Operations.

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.

--attr --custom-attribute

Pares clave=valor separados por espacios correspondientes a atributos personalizados adicionales para el dispositivo. Este parámetro se puede usar más de una vez.

--disabled

Deshabilite el dispositivo.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
Valores aceptados: false, true
--manufacturer

Fabricante del dispositivo.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
--model

Modelo de dispositivo.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
--os

Sistema operativo del dispositivo.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
--os-version --osv

Versión del sistema operativo del dispositivo.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

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 ops ns device delete

Vista previa

El grupo de comandos "iot ops ns" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine un dispositivo de un espacio de nombres del Registro de dispositivos.

az iot ops ns device delete --instance
                            --name
                            --resource-group
                            [--yes {false, true}]

Ejemplos

Eliminar un dispositivo

az iot ops ns device delete --name mydevice --instance myInstance -g myInstanceResourceGroup

Parámetros requeridos

--instance -i

Nombre de la instancia de Azure IoT Operations.

--name -n

Nombre del dispositivo que se va a crear.

--resource-group -g

El grupo de recursos de la instancia de Azure IoT Operations.

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.

--yes -y

Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
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 ops ns device query

Vista previa

El grupo de comandos "iot ops ns" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Consulta de dispositivos en espacios de nombres del Registro de dispositivos.

Consulte los dispositivos entre espacios de nombres en función de varios criterios de búsqueda, como el nombre del dispositivo, el fabricante, el modelo, etc.

az iot ops ns device query [--cq --custom-query]
                           [--disabled {false, true}]
                           [--instance]
                           [--manufacturer]
                           [--model]
                           [--name]
                           [--os]
                           [--os-version --osv]
                           [--resource-group]

Ejemplos

Consulta de dispositivos en una instancia de operaciones de IoT

az iot ops ns device query --instance myInstance -g myInstanceResourceGroup

Consulta de un dispositivo específico por nombre

az iot ops ns device query --name mydevice

Consulta de dispositivos de un fabricante específico

az iot ops ns device query --manufacturer "Contoso"

Uso de una consulta personalizada para buscar dispositivos

az iot ops ns device query --custom-query "where tags.environment=='production'"

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.

--cq --custom-query

Consulta personalizada que se va a usar. Todos los demás argumentos de consulta, aparte del nombre de instancia y el grupo de recursos, se omitirán.

--disabled

Estado del recurso.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
Valores aceptados: false, true
--instance -i

Nombre de la instancia de Azure IoT Operations.

--manufacturer

Fabricante del dispositivo.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
--model

Modelo de dispositivo.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
--name -n

Nombre del dispositivo que se va a crear.

--os

Sistema operativo del dispositivo.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
--os-version --osv

Versión del sistema operativo del dispositivo.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
--resource-group -g

El grupo de recursos de la instancia de Azure IoT Operations.

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 ops ns device show

Vista previa

El grupo de comandos "iot ops ns" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Muestra los detalles de un dispositivo en un espacio de nombres del Registro de dispositivos.

az iot ops ns device show --instance
                          --name
                          --resource-group

Ejemplos

Mostrar detalles de un dispositivo

az iot ops ns device show --name mydevice --instance myInstance -g myInstanceResourceGroup

Parámetros requeridos

--instance -i

Nombre de la instancia de Azure IoT Operations.

--name -n

Nombre del dispositivo que se va a crear.

--resource-group -g

El grupo de recursos de la instancia de Azure IoT Operations.

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 ops ns device update

Vista previa

El grupo de comandos "iot ops ns" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Actualice un dispositivo en un espacio de nombres del Registro de dispositivos.

az iot ops ns device update --instance
                            --name
                            --resource-group
                            [--attr --custom-attribute]
                            [--disabled {false, true}]
                            [--os-version --osv]
                            [--tags]

Ejemplos

Actualización de atributos personalizados de dispositivo

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --attr location=building2 floor=5

Actualizar la versión del sistema operativo

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --os-version "4.18"

Deshabilitación de un dispositivo

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --disabled

Actualización de etiquetas de dispositivo

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --tags environment=production criticality=high

Parámetros requeridos

--instance -i

Nombre de la instancia de Azure IoT Operations.

--name -n

Nombre del dispositivo que se va a crear.

--resource-group -g

El grupo de recursos de la instancia de Azure IoT Operations.

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.

--attr --custom-attribute

Pares clave=valor separados por espacios correspondientes a atributos personalizados adicionales para el dispositivo. Este parámetro se puede usar más de una vez.

--disabled

Deshabilite el dispositivo.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
Valores aceptados: false, true
--os-version --osv

Versión del sistema operativo del dispositivo.

Propiedad Valor
Grupo de parámetros: Additional Info Arguments
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

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