az iot ops

Nota:

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

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

Administración de operaciones de Azure IoT.

Azure IoT Operations es un conjunto de servicios de Kubernetes altamente alineados, pero acoplados de forma flexible que permiten agregar datos de recursos locales a un agente MQTT de nivel industrial, agregar proceso perimetral y configurar el flujo de datos bidireccional con una variedad de servicios en la nube.

De forma predeterminada, los comandos de la CLI de IoT Operations comprobarán periódicamente si hay disponible una nueva versión de extensión. Este comportamiento se puede deshabilitar con az config set iotops.check_latest=false.

Comandos

Nombre Description Tipo Estado
az iot ops asset

Administrar recursos.

Extensión Vista previa
az iot ops asset create

Cree un recurso.

Extensión Vista previa
az iot ops asset data-point

Administrar puntos de datos en un recurso.

Extensión Vista previa
az iot ops asset data-point add

Agregue un punto de datos a un recurso.

Extensión Vista previa
az iot ops asset data-point export

Exportar puntos de datos en un recurso.

Extensión Vista previa
az iot ops asset data-point import

Importe puntos de datos en un recurso.

Extensión Vista previa
az iot ops asset data-point list

Enumere los puntos de datos de un recurso.

Extensión Vista previa
az iot ops asset data-point remove

Quite un punto de datos de un recurso.

Extensión Vista previa
az iot ops asset delete

Eliminar un recurso.

Extensión Vista previa
az iot ops asset endpoint

Administrar perfiles de punto de conexión de recursos.

Extensión Vista previa
az iot ops asset endpoint certificate

Administrar certificados propiedad en un punto de conexión de recurso.

Extensión Vista previa
az iot ops asset endpoint certificate add

Agregue un certificado propiedad a un punto de conexión de recurso.

Extensión Vista previa
az iot ops asset endpoint certificate list

Enumera los certificados propiedad de un punto de conexión de recurso.

Extensión Vista previa
az iot ops asset endpoint certificate remove

Quite un certificado de propiedad en un punto de conexión de recurso.

Extensión Vista previa
az iot ops asset endpoint create

Cree un punto de conexión de recurso.

Extensión Vista previa
az iot ops asset endpoint delete

Elimine un punto de conexión de recurso.

Extensión Vista previa
az iot ops asset endpoint query

Consulte Resource Graph para los puntos de conexión de recursos.

Extensión Vista previa
az iot ops asset endpoint show

Mostrar un punto de conexión de recurso.

Extensión Vista previa
az iot ops asset endpoint update

Actualice un punto de conexión de recurso.

Extensión Vista previa
az iot ops asset event

Administrar eventos en un recurso.

Extensión Vista previa
az iot ops asset event add

Agregue un evento a un recurso.

Extensión Vista previa
az iot ops asset event export

Exportar eventos en un recurso.

Extensión Vista previa
az iot ops asset event import

Importar eventos en un recurso.

Extensión Vista previa
az iot ops asset event list

Enumerar eventos en un recurso.

Extensión Vista previa
az iot ops asset event remove

Quite un evento en un recurso.

Extensión Vista previa
az iot ops asset query

Consulte resource Graph para los recursos.

Extensión Vista previa
az iot ops asset show

Mostrar un recurso.

Extensión Vista previa
az iot ops asset update

Actualice un recurso.

Extensión Vista previa
az iot ops broker

Administración y operaciones del agente mqtt.

Extensión Vista previa
az iot ops broker authn

Administración de la autenticación del agente.

Extensión Vista previa
az iot ops broker authn list

Enumere los recursos de autenticación del agente mqtt asociados a una instancia.

Extensión Vista previa
az iot ops broker authn show

Mostrar detalles de un recurso de autenticación de agente mqtt.

Extensión Vista previa
az iot ops broker authz

Administración de la autorización del agente.

Extensión Vista previa
az iot ops broker authz list

Enumere los recursos de autorización del agente mqtt asociados a una instancia.

Extensión Vista previa
az iot ops broker authz show

Muestra los detalles de un recurso de autorización de agente mqtt.

Extensión Vista previa
az iot ops broker list

Enumerar agentes mqtt asociados a una instancia de .

Extensión Vista previa
az iot ops broker listener

Administración del agente de escucha.

Extensión Vista previa
az iot ops broker listener list

Enumera los agentes de escucha de agente mqtt asociados a un agente.

Extensión Vista previa
az iot ops broker listener show

Muestra los detalles de un agente de escucha de mqtt.

Extensión Vista previa
az iot ops broker show

Mostrar detalles de un agente mqtt.

Extensión Vista previa
az iot ops broker stats

Mostrar estadísticas en ejecución de dmqtt.

Extensión Vista previa
az iot ops check

Evalúe el estado en tiempo de ejecución del lado clúster de los servicios de operaciones de IoT implementados.

Extensión Vista previa
az iot ops dataflow

Administración del flujo de datos.

Extensión Vista previa
az iot ops dataflow endpoint

Administración de puntos de conexión de flujo de datos.

Extensión Vista previa
az iot ops dataflow endpoint list

Enumera los recursos del punto de conexión de flujo de datos asociados a una instancia.

Extensión Vista previa
az iot ops dataflow endpoint show

Mostrar detalles de un recurso de punto de conexión de flujo de datos.

Extensión Vista previa
az iot ops dataflow list

Enumera los flujos de datos asociados a un perfil de flujo de datos.

Extensión Vista previa
az iot ops dataflow profile

Administración de perfiles de flujo de datos.

Extensión Vista previa
az iot ops dataflow profile list

Enumera los perfiles de flujo de datos asociados a una instancia de .

Extensión Vista previa
az iot ops dataflow profile show

Mostrar detalles de un perfil de flujo de datos.

Extensión Vista previa
az iot ops dataflow show

Mostrar detalles de un flujo de datos asociado a un perfil de flujo de datos.

Extensión Vista previa
az iot ops delete

Elimine las operaciones de IoT del clúster.

Extensión Vista previa
az iot ops init

Arranque, configure e implemente operaciones de IoT en el clúster habilitado para Arc de destino.

Extensión Vista previa
az iot ops list

Enumeración de instancias de operaciones de IoT.

Extensión Vista previa
az iot ops show

Mostrar una instancia de operaciones de IoT.

Extensión Vista previa
az iot ops support

Las operaciones de IoT admiten el espacio de comandos.

Extensión Vista previa
az iot ops support create-bundle

Crea un archivo zip de agrupación de compatibilidad estándar para su uso en la solución de problemas y diagnósticos.

Extensión Vista previa
az iot ops update

Actualice una instancia de operaciones de IoT.

Extensión Vista previa
az iot ops verify-host

Ejecuta un conjunto de comprobaciones de host de clúster para la compatibilidad de implementación de operaciones de IoT.

Extensión Vista previa

az iot ops check

Vista previa

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

Evalúe el estado en tiempo de ejecución del lado clúster de los servicios de operaciones de IoT implementados.

El comando muestra de forma predeterminada una vista de resumen fácil de usar del servicio seleccionado. Se puede solicitar más detalles a través de --detail-level.

{API de servicio compatibles}

  • akri.sh/[v0]
  • deviceregistry.microsoft.com/[v1beta1]
  • mqttbroker.iotoperations.azure.com/[v1beta1]
  • opcuabroker.iotoperations.azure.com/[v1beta1]

Para más información sobre los requisitos del clúster, consulte https://aka.ms/iot-ops-cluster-requirements.

az iot ops check [--as-object {false, true}]
                 [--context]
                 [--detail-level {0, 1, 2}]
                 [--ops-service {akri, broker, deviceregistry, opcua}]
                 [--post {false, true}]
                 [--pre {false, true}]
                 [--resource-name]
                 [--resources {asset, assetendpointprofile, assettype, broker, brokerlistener, configuration, instance}]

Ejemplos

Uso básico. Comprueba el estado de "broker" con la salida de resumen.

az iot ops check

Evalúa "broker" como ejemplo anterior, pero la salida está optimizada para CI.

az iot ops check --as-object

Comprueba el estado y la configuración de "opcua" con la salida detallada.

az iot ops check --svc opcua --detail-level 1

Comprueba el estado "deviceregistry", pero restringe los resultados a los recursos "asset".

az iot ops check --svc deviceregistry --detail-level 1 --resources asset

Use el nombre del recurso para restringir los resultados a los recursos "asset" con el prefijo de nombre "my-asset-".

az iot ops check --svc deviceregistry --resources asset --resource-name 'my-asset-*'

Parámetros opcionales

--as-object

Comprobación de contenido y validaciones de salida en una estructura de datos descriptivo de CI.

Valores aceptados: false, true
--context

Nombre de contexto de Kubeconfig que se va a usar para la comunicación de clúster k8s. Si no se proporciona ningún contexto current_context se usa.

--detail-level

Controla el nivel de detalle mostrado en la salida de comprobación. Elija 0 para una vista de resumen (salida mínima), 1 para obtener una vista detallada (información más completa) o 2 para una vista detallada (toda la información disponible).

Valores aceptados: 0, 1, 2
Valor predeterminado: 0
--ops-service --svc

Implementación del servicio IoT Operations que se evaluará.

Valores aceptados: akri, broker, deviceregistry, opcua
Valor predeterminado: broker
--post

Ejecute comprobaciones posteriores a la implementación.

Valores aceptados: false, true
--pre

Ejecute comprobaciones de requisitos previos para determinar si se cumplen los requisitos mínimos de una implementación de servicio.

Valores aceptados: false, true
--resource-name --rn

Solo se ejecutan comprobaciones para el nombre de recurso específico. El nombre distingue mayúsculas de minúsculas. Se admiten los patrones de Glob '' y '?'. Nota: Solo se permiten caracteres alfanuméricos, guiones, "?" y "".

--resources

Ejecute solo comprobaciones en tipos de recursos específicos. Use valores separados por espacios.

Valores aceptados: asset, assetendpointprofile, assettype, broker, brokerlistener, configuration, instance
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 ops delete

Vista previa

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

Elimine las operaciones de IoT del clúster.

La operación usa Azure Resource Graph para determinar los recursos correlacionados. Resource Graph es coherente finalmente no garantiza un estado sincronizado en el momento de la ejecución.

az iot ops delete --cluster
                  --resource-group
                  [--force {false, true}]
                  [--no-progress {false, true}]
                  [--yes {false, true}]

Ejemplos

Entrada mínima para la eliminación completa.

az iot ops delete --cluster mycluster -g myresourcegroup

Omita el mensaje de confirmación y continúe con el proceso de eliminación. Útil para escenarios de CI.

az iot ops delete --cluster mycluster -g myresourcegroup -y

Forzar eliminación independientemente de las advertencias. Puede provocar errores.

az iot ops delete --cluster mycluster -g myresourcegroup --force

Parámetros requeridos

--cluster

Nombre del clúster de destino para la eliminación de operaciones de IoT.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--force

Forzar la ejecución de la operación.

Valores aceptados: false, true
--no-progress

Deshabilite la representación visual del trabajo.

Valores aceptados: false, true
--yes -y

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

Valores aceptados: false, true
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 ops init

Vista previa

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

Arranque, configure e implemente operaciones de IoT en el clúster habilitado para Arc de destino.

Para más recursos, incluido cómo habilitar un clúster en Arc, consulte https://video2.skills-academy.com/en-us/azure/iot-operations/deploy-iot-ops/howto-prepare-cluster

Las operaciones de IoT dependen de una entidad de servicio (SP) para la sincronización de secretos del controlador CSI de Key Vault.

De forma predeterminada, init funcionará en la creación y configuración de un registro de aplicación adecuado a través de Microsoft Graph y, a continuación, lo aplicará al clúster.

Puede cortocircuitar este trabajo, creando previamente un registro de aplicación y proporcionando valores para --sp-app-id, --sp-object-id y --sp-secret. Al proporcionar los campos sp, no se realizará ningún trabajo adicional a través de las operaciones de Microsoft Graph.

La creación previa de un registro de aplicaciones es útil cuando la entidad de seguridad de inicio de sesión tiene permisos de id. de Entra restringidos. Por ejemplo, en escenarios de CI/automation o en una separación de responsabilidad del usuario en las organizaciones.

az iot ops init --cluster
                --resource-group
                [--add-insecure-listener {false, true}]
                [--bfr]
                [--bfw]
                [--broker]
                [--broker-authn]
                [--broker-backend-part]
                [--broker-backend-rf]
                [--broker-backend-workers]
                [--broker-config-file]
                [--broker-listener]
                [--broker-mem-profile {High, Low, Medium, Tiny}]
                [--broker-service-type {ClusterIp, LoadBalancer, NodePort}]
                [--ca-dir]
                [--ca-file]
                [--ca-key-file]
                [--ca-valid-days]
                [--cluster-namespace]
                [--context]
                [--csi-config]
                [--csi-ver]
                [--custom-location]
                [--desc]
                [--df-profile-instances]
                [--disable-rotation {false, true}]
                [--disable-rsync-rules {false, true}]
                [--ensure-latest {false, true}]
                [--kubernetes-distro {k3s, k8s, microk8s}]
                [--kv-id]
                [--kv-spc-secret-name]
                [--location]
                [--name]
                [--no-block {false, true}]
                [--no-deploy {false, true}]
                [--no-progress {false, true}]
                [--no-tls {false, true}]
                [--rotation-int]
                [--runtime-socket]
                [--show-template {false, true}]
                [--simulate-plc {false, true}]
                [--sp-app-id]
                [--sp-object-id]
                [--sp-secret]
                [--sp-secret-valid-days]

Ejemplos

Entrada mínima para la configuración completa. Esto incluye la configuración de Key Vault, la implementación del controlador CSI, la configuración tls y la implementación de operaciones de IoT.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id /subscriptions/2cb3a427-1abc-48d0-9d03-dd240819742a/resourceGroups/myresourcegroup/providers/Microsoft.KeyVault/vaults/mykeyvault

La misma configuración que el ejemplo anterior, excepto con el uso de un identificador de aplicación existente y una marca para incluir un servidor PLC simulado como parte de la implementación. Incluir el identificador de aplicación impedirá que init cree un registro de aplicación.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --simulate-plc

Para omitir la implementación y centrarse solo en el controlador CSI de Key Vault y los flujos de trabajo de configuración de TLS, pase sencillo --no-deploy. Esto puede ser útil al desear implementar desde una herramienta diferente, como Portal.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --no-deploy

Para implementar solo operaciones de IoT en un clúster que ya se ha preajustado, simplemente omita --kv-id e incluya --no-tls.

az iot ops init --cluster mycluster -g myresourcegroup --no-tls

Use --no-block para realizar otro trabajo mientras la implementación está en marcha frente a la espera de que finalice la implementación antes de iniciar el otro trabajo.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --no-block

En este ejemplo se muestra cómo proporcionar valores para --sp-app-id, --sp-object-id y --sp-secret. Estos valores deben reflejar la entidad de servicio deseada que se usará para la sincronización de secretos del controlador CSI de Key Vault. Revise el resumen del comando para obtener más detalles.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --sp-object-id 224a7a3f-c63d-4923-8950-c4a85f0d2f29 --sp-secret $SP_SECRET

Para personalizar la configuración en tiempo de ejecución del controlador CSI de Key Vault, se puede usar --csi-config. Por ejemplo, establecer límites de recursos en la dependencia del contenedor de Telegraf.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --csi-config telegraf.resources.limits.memory=500Mi telegraf.resources.limits.cpu=100m

Parámetros requeridos

--cluster

Nombre de clúster de destino para la implementación de operaciones de IoT.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--add-insecure-listener

Cuando se habilite la implementación del agente mqtt, se incluirá un agente de escucha enlazado al puerto 1883 sin autenticación ni authZ.Solo para cargas de trabajo que no sean de producción.

Valores aceptados: false, true
--bfr --broker-frontend-replicas

Réplicas de front-end del agente mqtt.

Valor predeterminado: 2
--bfw --broker-frontend-workers

Trabajos de front-end del agente mqtt.

Valor predeterminado: 2
--broker

Nombre del agente mqtt.

Valor predeterminado: broker
--broker-authn

Nombre de autenticación del agente mqtt.

Valor predeterminado: authn
--broker-backend-part

Particiones de back-end del agente mqtt.

Valor predeterminado: 2
--broker-backend-rf

Factor de redundancia de back-end del agente mqtt.

Valor predeterminado: 2
--broker-backend-workers

Trabajos de back-end del agente mqtt.

Valor predeterminado: 2
--broker-config-file

Ruta de acceso a un archivo json con propiedades de configuración de broker personalizadas. Útil para escenarios avanzados. El formato esperado se describe en https://aka.ms/aziotops-broker-config.

--broker-listener

Nombre del agente de escucha de mqtt.

Valor predeterminado: listener
--broker-mem-profile

Perfil de memoria del agente mqtt.

Valores aceptados: High, Low, Medium, Tiny
Valor predeterminado: Medium
--broker-service-type

Tipo de servicio mqtt broker.

Valores aceptados: ClusterIp, LoadBalancer, NodePort
Valor predeterminado: ClusterIp
--ca-dir

El directorio local en el que se colocará la ENTIDAD de certificación de prueba generada y la clave privada. Si no se proporciona ningún directorio, no se escribirán archivos en el disco. Aplicable cuando no se proporciona --ca-file y --ca-key-file.

--ca-file

Ruta de acceso al archivo ca deseado en formato PEM.

--ca-key-file

Ruta de acceso al archivo de clave privada de CA en formato PEM. ! ¡Obligatorio! cuando se proporciona --ca-file.

--ca-valid-days

Opción para controlar la duración en días de la ca x509 generada por init. Aplicable si no se proporcionan --ca-file y --ca-key-file.

Valor predeterminado: 365
--cluster-namespace

El espacio de nombres del clúster en el que se implementará la infraestructura de operaciones de IoT. Debe estar en minúscula.

Valor predeterminado: azure-iot-operations
--context

Nombre de contexto de Kubeconfig que se va a usar para la comunicación de clúster k8s. Si no se proporciona ningún contexto current_context se usa.

--csi-config

Configuración personalizada de la extensión del controlador CSI. El formato es pares clave=valor separados por espacio. --csi-config se puede usar una o varias veces.

--csi-ver

Versión de la extensión del controlador CSI.

Valor predeterminado: 1.5.6
--custom-location

Nombre de ubicación personalizado correspondiente a la implementación de operaciones de IoT. El valor predeterminado está en el formato '{cluster_name}-{token}-ops-init-cl'.

--desc

Descripción de la instancia de operaciones de IoT.

--df-profile-instances

Recuento de instancias asociado al perfil de flujo de datos predeterminado.

Valor predeterminado: 1
--disable-rotation

Marca para deshabilitar la rotación de secretos.

Valores aceptados: false, true
--disable-rsync-rules

Las reglas de sincronización de recursos no se incluirán en la implementación de operaciones de IoT.

Valores aceptados: false, true
--ensure-latest

Asegúrese de que se usa la CLI de IoT Ops más reciente, lo que genera un error si hay disponible una actualización.

Valores aceptados: false, true
--kubernetes-distro

La distribución de Kubernetes que se va a usar para la configuración de Akri. La distribución seleccionada implica la ruta de acceso de socket del entorno de ejecución del contenedor predeterminada cuando no se proporciona ningún valor de socket --runtime-socket.

Valores aceptados: k3s, k8s, microk8s
Valor predeterminado: k8s
--kv-id

Id. de recurso de ARM de Key Vault. Al proporcionar este identificador de recurso, el cliente podrá configurar todos los recursos necesarios y la configuración del lado del clúster para habilitar el controlador CSI de Key Vault para operaciones de IoT.

--kv-spc-secret-name

Nombre del secreto de Key Vault que se va a usar como secreto de SPC predeterminado. Si el secreto no existe, se creará con un valor de marcador de posición seguro criptográficamente.

Valor predeterminado: azure-iot-operations
--location

Ubicación de ARM que se usará para el material adjunto RPSaaS aprovisionado. Si no se proporciona la ubicación del clúster conectado, se usará.

--name -n

Nombre de instancia de IoT Operations. El valor predeterminado está en el formato '{cluster_name}-ops-instance'.

--no-block

Vuelva inmediatamente después de que se haya iniciado la implementación de operaciones de IoT.

Valores aceptados: false, true
--no-deploy

Se omitirá el flujo de trabajo de implementación de operaciones de IoT.

Valores aceptados: false, true
--no-progress

Deshabilite la representación visual del trabajo.

Valores aceptados: false, true
--no-tls

Se omitirá el flujo de trabajo de configuración de TLS.

Valores aceptados: false, true
--rotation-int

Intervalo de sondeo de rotación.

Valor predeterminado: 1h
--runtime-socket

Ruta de acceso de nodo predeterminada del socket en tiempo de ejecución del contenedor. Si no se proporciona (valor predeterminado), la ruta de acceso del socket viene determinada por --kubernetes-distro.

--show-template

Marca cuando se establece, generará la plantilla prevista para la implementación.

Valores aceptados: false, true
--simulate-plc

Marca cuando se establezca, configurará el instalador del agente de OPC-UA para poner en marcha un servidor PLC.

Valores aceptados: false, true
--sp-app-id

Identificador de la aplicación de entidad de servicio. Si se proporciona, se usará para la configuración del controlador CSI. De lo contrario, se creará un registro de aplicación. Obligatorio si la entidad de seguridad que ha iniciado sesión no tiene permisos para consultar el grafo.

--sp-object-id

Identificador de objeto de entidad de servicio (sp). Si se proporciona, se usará para la configuración del controlador CSI. De lo contrario, se consultará el identificador de objeto desde el identificador de la aplicación, lo que crea el sp si no existe uno. Obligatorio si la entidad de seguridad que ha iniciado sesión no tiene permisos para consultar el grafo. Use az ad sp show --id <app Id> --query id -o tsv para generar el identificador de objeto adecuado. Como alternativa, puede ir a Aplicaciones empresariales en el inquilino de Entra Id.

--sp-secret

Secreto correspondiente al identificador de aplicación de entidad de servicio proporcionado. Si se proporciona, se usará para la configuración del controlador CSI. De lo contrario, se creará un nuevo secreto. Obligatorio si la entidad de seguridad que ha iniciado sesión no tiene permisos para consultar el grafo.

--sp-secret-valid-days

Opción para controlar la duración en días del secreto de la entidad de servicio generada por init. Aplicable si no se proporciona --sp-secret.

Valor predeterminado: 365
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 ops list

Vista previa

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

Enumeración de instancias de operaciones de IoT.

Use --query con la sintaxis de JMESPath deseada para consultar el resultado.

az iot ops list [--resource-group]

Ejemplos

Enumere todas las instancias de la suscripción.

az iot ops list

Enumera todas las instancias de un grupo de recursos determinado.

az iot ops list -g myresourcegroup

Enumere las instancias de la suscripción que tienen un valor de etiqueta determinado.

az iot ops list -g myresourcegroup --query "[?tags.env == 'prod']"

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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

Vista previa

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

Mostrar una instancia de operaciones de IoT.

Opcionalmente, el comando puede generar una estructura de árbol de los recursos asociados que representan la implementación de operaciones de IoT en el clúster de respaldo.

az iot ops show --name
                --resource-group
                [--tree {false, true}]

Ejemplos

Uso básico para mostrar una instancia.

az iot ops show --name myinstance -g myresourcegroup

Genera una estructura de árbol de recursos asociados que representa la implementación de operaciones de IoT.

az iot ops show --name myinstance -g myresourcegroup --tree

Parámetros requeridos

--name -n

Nombre de instancia de IoT Operations.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--tree

Use para visualizar la implementación de operaciones de IoT en el clúster de respaldo.

Valores aceptados: false, true
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 ops update

Vista previa

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

Actualice una instancia de operaciones de IoT.

Actualmente, se pueden actualizar las etiquetas y la descripción de la instancia.

az iot ops update --name
                  --resource-group
                  [--desc]
                  [--tags]

Ejemplos

Actualizar etiquetas de instancia. Esto equivale a un reemplazo.

az iot ops update --name myinstance -g myresourcegroup --tags a=b c=d

Quite las etiquetas de instancia.

az iot ops update --name myinstance -g myresourcegroup --tags ""

Actualice la descripción de la instancia.

az iot ops update --name myinstance -g myresourcegroup --desc "Fabrikam Widget Factory B42"

Parámetros requeridos

--name -n

Nombre de instancia de IoT Operations.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--desc

Descripción de la instancia de operaciones de IoT.

--tags

Etiquetas de instancia. Contenedor de propiedades en pares clave-valor con el formato siguiente: a=b c=d.

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 ops verify-host

Vista previa

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

Ejecuta un conjunto de comprobaciones de host de clúster para la compatibilidad de implementación de operaciones de IoT.

Diseñado para ejecutarse directamente en un host de clúster de destino. El comando puede pedir que aplique un conjunto de acciones con privilegios, como instalar una dependencia. En este caso, la CLI debe ejecutarse con permisos elevados. Por ejemplo, sudo AZURE_EXTENSION_DIR=~/.azure/cliextensions az iot ops verify-host.

az iot ops verify-host [--no-progress {false, true}]

Parámetros opcionales

--no-progress

Deshabilite la representación visual del trabajo.

Valores aceptados: false, true
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.