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
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
Nombre de la instancia de Azure IoT Operations.
Nombre del dispositivo que se va a crear.
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.
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.
Deshabilite el dispositivo.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
| Valores aceptados: | false, true |
Fabricante del dispositivo.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
Modelo de dispositivo.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
Sistema operativo del dispositivo.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
Versión del sistema operativo del dispositivo.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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
Nombre de la instancia de Azure IoT Operations.
Nombre del dispositivo que se va a crear.
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.
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
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.
Estado del recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
| Valores aceptados: | false, true |
Nombre de la instancia de Azure IoT Operations.
Fabricante del dispositivo.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
Modelo de dispositivo.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
Nombre del dispositivo que se va a crear.
Sistema operativo del dispositivo.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
Versión del sistema operativo del dispositivo.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
El grupo de recursos de la instancia de Azure IoT Operations.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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
Nombre de la instancia de Azure IoT Operations.
Nombre del dispositivo que se va a crear.
El grupo de recursos de la instancia de Azure IoT Operations.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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
Nombre de la instancia de Azure IoT Operations.
Nombre del dispositivo que se va a crear.
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.
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.
Deshabilite el dispositivo.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
| Valores aceptados: | false, true |
Versión del sistema operativo del dispositivo.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Additional Info Arguments |
Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |