az iot hub

Note

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Administración de azure IoT Hubs.

Comandos

Nombre	Description	Tipo	Estado
az iot hub certificate	Administre los certificados de IoT Hub.	Núcleo y extensión	GA
az iot hub certificate create	Cree o cargue un certificado de Azure IoT Hub.	Core	GA
az iot hub certificate create (azure-iot extensión)	Cree o cargue un certificado de Azure IoT Hub.	Extension	GA
az iot hub certificate delete	Elimina un certificado de Azure IoT Hub.	Core	GA
az iot hub certificate delete (azure-iot extensión)	Elimina un certificado de Azure IoT Hub.	Extension	GA
az iot hub certificate generate-verification-code	Genera un código de verificación para un certificado de Azure IoT Hub.	Core	GA
az iot hub certificate generate-verification-code (azure-iot extensión)	Genera un código de verificación para un certificado de Azure IoT Hub.	Extension	GA
az iot hub certificate list	Enumera todos los certificados contenidos en una instancia de Azure IoT Hub.	Core	GA
az iot hub certificate list (azure-iot extensión)	Enumera todos los certificados contenidos en una instancia de Azure IoT Hub.	Extension	GA
az iot hub certificate show	Muestra información sobre un certificado de Azure IoT Hub determinado.	Core	GA
az iot hub certificate show (azure-iot extensión)	Muestra información sobre un certificado de Azure IoT Hub determinado.	Extension	GA
az iot hub certificate update	Actualice un certificado de Azure IoT Hub.	Core	GA
az iot hub certificate update (azure-iot extensión)	Actualice un certificado de Azure IoT Hub.	Extension	GA
az iot hub certificate verify	Comprueba un certificado de Azure IoT Hub.	Core	GA
az iot hub certificate verify (azure-iot extensión)	Comprueba un certificado de Azure IoT Hub.	Extension	GA
az iot hub configuration	Administración de la configuración de administración automática a escala de dispositivos IoT.	Extension	GA
az iot hub configuration create	Cree una configuración de administración automática de dispositivos IoT en un centro de IoT de destino.	Extension	GA
az iot hub configuration delete	Elimine una configuración de dispositivo IoT.	Extension	GA
az iot hub configuration list	Enumere las configuraciones de administración automática de dispositivos de IoT en una instancia de IoT Hub.	Extension	GA
az iot hub configuration show	Obtenga los detalles de una configuración de administración automática de dispositivos IoT.	Extension	GA
az iot hub configuration show-metric	Evalúe una métrica de usuario o sistema de destino definida en una configuración de dispositivo IoT.	Extension	GA
az iot hub configuration update	Actualice las propiedades especificadas de una configuración de administración automática de dispositivos IoT.	Extension	GA
az iot hub connection-string	Administrar cadena de conexión de IoT Hub.	Extension	GA
az iot hub connection-string show	Muestre los cadena de conexión de los centros de IoT especificados mediante el nombre de directiva y la clave especificados.	Extension	GA
az iot hub consumer-group	Administre los grupos de consumidores del centro de eventos de un centro de IoT.	Núcleo y extensión	GA
az iot hub consumer-group create	Cree un grupo de consumidores del centro de eventos.	Core	GA
az iot hub consumer-group create (azure-iot extensión)	Cree un grupo de consumidores del centro de eventos.	Extension	GA
az iot hub consumer-group delete	Elimine un grupo de consumidores del centro de eventos.	Core	GA
az iot hub consumer-group delete (azure-iot extensión)	Elimine un grupo de consumidores del centro de eventos.	Extension	GA
az iot hub consumer-group list	Enumera los grupos de consumidores del centro de eventos.	Core	GA
az iot hub consumer-group list (azure-iot extensión)	Enumera los grupos de consumidores del centro de eventos.	Extension	GA
az iot hub consumer-group show	Obtenga los detalles de un grupo de consumidores del centro de eventos.	Core	GA
az iot hub consumer-group show (azure-iot extensión)	Obtenga los detalles de un grupo de consumidores del centro de eventos.	Extension	GA
az iot hub create	Cree una instancia de Azure IoT Hub.	Core	GA
az iot hub create (azure-iot extensión)	Cree una instancia de Azure IoT Hub.	Extension	GA
az iot hub delete	Elimine un centro de IoT.	Core	GA
az iot hub delete (azure-iot extensión)	Elimine un centro de IoT.	Extension	GA
az iot hub device-identity	Administre los dispositivos IoT.	Extension	GA
az iot hub device-identity children	Administrar relaciones de dispositivos secundarios para dispositivos IoT Edge.	Extension	GA
az iot hub device-identity children add	Agregue dispositivos como elementos secundarios a un dispositivo perimetral de destino.	Extension	GA
az iot hub device-identity children list	Genera la colección de dispositivos secundarios asignados.	Extension	GA
az iot hub device-identity children remove	Quite los dispositivos secundarios de un dispositivo perimetral de destino.	Extension	GA
az iot hub device-identity connection-string	Administrar la cadena de conexión del dispositivo IoT.	Extension	GA
az iot hub device-identity connection-string show	Mostrar un cadena de conexión de dispositivo ioT Hub determinado.	Extension	GA
az iot hub device-identity create	Cree un dispositivo en una instancia de IoT Hub.	Extension	GA
az iot hub device-identity delete	Elimine un dispositivo ioT Hub.	Extension	GA
az iot hub device-identity export	Exporte todas las identidades de dispositivo de una instancia de IoT Hub a un contenedor de blobs de Azure Storage.	Extension	GA
az iot hub device-identity import	Importe identidades de dispositivo a IoT Hub desde un blob de contenedor de almacenamiento.	Extension	GA
az iot hub device-identity list	Enumeración de dispositivos en una instancia de IoT Hub.	Extension	GA
az iot hub device-identity parent	Administrar las relaciones de dispositivos primarios para dispositivos IoT.	Extension	GA
az iot hub device-identity parent set	Establezca el dispositivo primario de un dispositivo de destino.	Extension	GA
az iot hub device-identity parent show	Obtenga el dispositivo primario de un dispositivo de destino.	Extension	GA
az iot hub device-identity renew-key	Renueve las claves de destino de los dispositivos de IoT Hub con autenticación sas.	Extension	GA
az iot hub device-identity show	Obtenga los detalles de un dispositivo ioT Hub.	Extension	GA
az iot hub device-identity update	Actualice un dispositivo IoT Hub.	Extension	GA
az iot hub device-twin	Administre la configuración de dispositivos gemelos de IoT.	Extension	GA
az iot hub device-twin list	Enumeración de dispositivos gemelos en una instancia de IoT Hub.	Extension	GA
az iot hub device-twin replace	Reemplace la definición del dispositivo gemelo por json de destino.	Extension	GA
az iot hub device-twin show	Obtenga una definición de dispositivo gemelo.	Extension	GA
az iot hub device-twin update	Actualice las propiedades y etiquetas deseadas del dispositivo gemelo.	Extension	GA
az iot hub devicestream	Administrar flujos de dispositivos de un centro de IoT.	Extension	Preview
az iot hub devicestream show	Obtenga los puntos de conexión de flujos de dispositivo de IoT Hub.	Extension	Preview
az iot hub digital-twin	Manipule e interactúe con el gemelo digital de un dispositivo ioT Hub.	Extension	GA
az iot hub digital-twin invoke-command	Invoque un comando raíz o de nivel de componente de un dispositivo gemelo digital.	Extension	GA
az iot hub digital-twin show	Mostrar el gemelo digital de un dispositivo ioT Hub.	Extension	GA
az iot hub digital-twin update	Actualice las propiedades de lectura y escritura de un dispositivo gemelo digital mediante la especificación de revisión JSON.	Extension	GA
az iot hub distributed-tracing	Administre la configuración distribuida por dispositivo.	Extension	Preview
az iot hub distributed-tracing show	Obtiene la configuración de seguimiento distribuido de un dispositivo.	Extension	Preview
az iot hub distributed-tracing update	Actualice las opciones de seguimiento distribuido de un dispositivo.	Extension	Preview
az iot hub generate-sas-token	Genere un token de SAS para un ioT Hub de destino, un dispositivo o un módulo.	Extension	GA
az iot hub identity	Administración de identidades de una instancia de Azure IoT Hub.	Núcleo y extensión	GA
az iot hub identity assign	Asigne identidades administradas a una instancia de IoT Hub.	Core	GA
az iot hub identity assign (azure-iot extensión)	Asigne identidades administradas a una instancia de IoT Hub.	Extension	GA
az iot hub identity remove	Quite las identidades administradas de una instancia de IoT Hub.	Core	GA
az iot hub identity remove (azure-iot extensión)	Quite las identidades administradas de una instancia de IoT Hub.	Extension	GA
az iot hub identity show	Mostrar las propiedades de identidad de una instancia de IoT Hub.	Core	GA
az iot hub identity show (azure-iot extensión)	Mostrar las propiedades de identidad de una instancia de IoT Hub.	Extension	GA
az iot hub invoke-device-method	Invoque un método de dispositivo.	Extension	GA
az iot hub invoke-module-method	Invoque un método de módulo.	Extension	GA
az iot hub job	Administración de trabajos de IoT Hub (v2).	Extension	GA
az iot hub job cancel	Cancelar un trabajo de IoT Hub.	Extension	GA
az iot hub job create	Cree y programe un trabajo de IoT Hub para su ejecución.	Extension	GA
az iot hub job list	Enumerar los trabajos históricos de una instancia de IoT Hub.	Extension	GA
az iot hub job show	Mostrar detalles de un trabajo de IoT Hub existente.	Extension	GA
az iot hub list	Enumeración de centros de IoT.	Core	GA
az iot hub list (azure-iot extensión)	Enumeración de centros de IoT.	Extension	GA
az iot hub list-skus	Enumere los planes de tarifa disponibles.	Core	GA
az iot hub list-skus (azure-iot extensión)	Enumere los planes de tarifa disponibles.	Extension	GA
az iot hub manual-failover	Inicie una conmutación por error manual para IoT Hub en la región de recuperación ante desastres emparejada geográficamente.	Core	GA
az iot hub manual-failover (azure-iot extensión)	Inicie una conmutación por error manual para IoT Hub en la región de recuperación ante desastres emparejada geográficamente.	Extension	GA
az iot hub message-endpoint	Administre puntos de conexión personalizados de una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint create	Agregue un punto de conexión a una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint create cosmosdb-container	Agregue un punto de conexión de contenedor de Cosmos DB para una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint create eventhub	Agregue un punto de conexión del centro de eventos para una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint create servicebus-queue	Agregue un punto de conexión de cola de Service Bus para una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint create servicebus-topic	Agregue un punto de conexión de tema de Service Bus para una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint create storage-container	Agregue un punto de conexión de contenedor de almacenamiento para una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint delete	Elimine todo o un punto de conexión específico para una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint list	Obtenga información sobre todos los puntos de conexión de una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint show	Obtenga información sobre el punto de conexión mencionado para una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint update	Actualice las propiedades de un punto de conexión existente para una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint update cosmosdb-container	Actualice las propiedades de un punto de conexión de contenedor de Cosmos DB existente para ioT Hub.	Extension	Preview
az iot hub message-endpoint update eventhub	Actualice las propiedades de un punto de conexión de Centro de eventos existente para una instancia de IoT Hub.	Extension	Preview
az iot hub message-endpoint update servicebus-queue	Actualice las propiedades de un punto de conexión de cola de Service Bus existente para ioT Hub.	Extension	Preview
az iot hub message-endpoint update servicebus-topic	Actualice las propiedades de un punto de conexión de tema de Service Bus existente para ioT Hub.	Extension	Preview
az iot hub message-endpoint update storage-container	Actualice las propiedades de un punto de conexión de contenedor de almacenamiento existente para ioT Hub.	Extension	Preview
az iot hub message-enrichment	Administre los enriquecimientos de mensajes para los puntos de conexión de una instancia de IoT Hub.	Núcleo y extensión	GA
az iot hub message-enrichment create	Cree un enriquecimiento de mensajes para los puntos de conexión elegidos en ioT Hub.	Core	GA
az iot hub message-enrichment create (azure-iot extensión)	Cree un enriquecimiento de mensajes para los puntos de conexión elegidos en ioT Hub.	Extension	GA
az iot hub message-enrichment delete	Elimine un enriquecimiento de mensajes en ioT Hub (por clave).	Core	GA
az iot hub message-enrichment delete (azure-iot extensión)	Elimine un enriquecimiento de mensajes en ioT Hub (por clave).	Extension	GA
az iot hub message-enrichment list	Obtenga información sobre todos los enriquecimientos de mensajes para IoT Hub.	Core	GA
az iot hub message-enrichment list (azure-iot extensión)	Obtenga información sobre todos los enriquecimientos de mensajes para IoT Hub.	Extension	GA
az iot hub message-enrichment update	Actualice un enriquecimiento de mensajes en el centro de IoT (por clave).	Core	GA
az iot hub message-enrichment update (azure-iot extensión)	Actualice un enriquecimiento de mensajes en el centro de IoT (por clave).	Extension	GA
az iot hub message-route	Administre rutas de una instancia de IoT Hub.	Extension	Preview
az iot hub message-route create	Agregue una ruta para una instancia de IoT Hub.	Extension	Preview
az iot hub message-route delete	Elimine todas las rutas o una ruta mencionada en una instancia de IoT Hub.	Extension	Preview
az iot hub message-route fallback	Administre la ruta de reserva de un centro de IoT.	Extension	Preview
az iot hub message-route fallback set	Habilite o deshabilite la ruta de reserva en una instancia de IoT Hub.	Extension	Preview
az iot hub message-route fallback show	Mostrar la ruta de reserva de una instancia de IoT Hub.	Extension	Preview
az iot hub message-route list	Obtenga todas las rutas de una instancia de IoT Hub.	Extension	Preview
az iot hub message-route show	Obtenga información sobre la ruta en una instancia de IoT Hub.	Extension	Preview
az iot hub message-route test	Pruebe todas las rutas o una ruta mencionada en una instancia de IoT Hub.	Extension	Preview
az iot hub message-route update	Actualice una ruta para una instancia de IoT Hub.	Extension	Preview
az iot hub module-identity	Administre módulos de dispositivo IoT.	Extension	GA
az iot hub module-identity connection-string	Administre la cadena de conexión del módulo de dispositivo IoT.	Extension	GA
az iot hub module-identity connection-string show	Mostrar un cadena de conexión del módulo de dispositivo IoT de destino.	Extension	GA
az iot hub module-identity create	Cree un módulo en un dispositivo IoT de destino en una instancia de IoT Hub.	Extension	GA
az iot hub module-identity delete	Elimine un dispositivo en una instancia de IoT Hub.	Extension	GA
az iot hub module-identity list	Enumere los módulos ubicados en un dispositivo IoT en una instancia de IoT Hub.	Extension	GA
az iot hub module-identity renew-key	Renueve las claves de destino de los módulos de dispositivo de IoT Hub con la autenticación sas.	Extension	GA
az iot hub module-identity show	Obtenga los detalles de un módulo de dispositivo IoT en una instancia de IoT Hub.	Extension	GA
az iot hub module-identity update	Actualice un módulo de dispositivo de IoT Hub.	Extension	GA
az iot hub module-twin	Administre la configuración de módulos gemelos de dispositivos IoT.	Extension	GA
az iot hub module-twin replace	Reemplace una definición de módulo gemelo por json de destino.	Extension	GA
az iot hub module-twin show	Mostrar una definición de módulo gemelo.	Extension	GA
az iot hub module-twin update	Actualice las propiedades y etiquetas deseadas del módulo gemelo.	Extension	GA
az iot hub monitor-events	Supervise los mensajes y telemetría del dispositivo enviados a ioT Hub.	Extension	GA
az iot hub monitor-feedback	Supervise los comentarios enviados por los dispositivos para confirmar los mensajes de la nube al dispositivo (C2D).	Extension	GA
az iot hub policy	Administrar directivas de acceso compartido de un centro de IoT.	Núcleo y extensión	GA
az iot hub policy create	Cree una nueva directiva de acceso compartido en un centro de IoT.	Core	GA
az iot hub policy create (azure-iot extensión)	Cree una nueva directiva de acceso compartido en un centro de IoT.	Extension	GA
az iot hub policy delete	Elimine una directiva de acceso compartido de un centro de IoT.	Core	GA
az iot hub policy delete (azure-iot extensión)	Elimine una directiva de acceso compartido de un centro de IoT.	Extension	GA
az iot hub policy list	Enumerar las directivas de acceso compartido de un centro de IoT.	Core	GA
az iot hub policy list (azure-iot extensión)	Enumerar las directivas de acceso compartido de un centro de IoT.	Extension	GA
az iot hub policy renew-key	Regenera las claves de una directiva de acceso compartido de un centro de IoT.	Core	GA
az iot hub policy renew-key (azure-iot extensión)	Regenera las claves de una directiva de acceso compartido de un centro de IoT.	Extension	GA
az iot hub policy show	Obtenga los detalles de una directiva de acceso compartido de un centro de IoT.	Core	GA
az iot hub policy show (azure-iot extensión)	Obtenga los detalles de una directiva de acceso compartido de un centro de IoT.	Extension	GA
az iot hub query	Consulte una instancia de IoT Hub con un lenguaje similar a SQL eficaz.	Extension	GA
az iot hub show	Obtenga los detalles de un centro de IoT.	Core	GA
az iot hub show (azure-iot extensión)	Obtenga los detalles de un centro de IoT.	Extension	GA
az iot hub show-quota-metrics	Obtenga las métricas de cuota de un centro de IoT.	Core	GA
az iot hub show-quota-metrics (azure-iot extensión)	Obtenga las métricas de cuota de un centro de IoT.	Extension	GA
az iot hub show-stats	Obtenga las estadísticas de un centro de IoT.	Core	GA
az iot hub show-stats (azure-iot extensión)	Obtenga las estadísticas de un centro de IoT.	Extension	GA
az iot hub state	Administre el estado de una instancia de IoT Hub.	Extension	Experimental
az iot hub state export	Exporte el estado de una instancia de IoT Hub a un archivo.	Extension	Experimental
az iot hub state import	Importe un estado del centro de conectividad de un archivo a una instancia de IoT Hub.	Extension	Experimental
az iot hub state migrate	Migre el estado de un centro a otro sin guardarlo en un archivo.	Extension	Experimental
az iot hub update	Actualice los metadatos de un centro de IoT.	Core	GA
az iot hub update (azure-iot extensión)	Actualice los metadatos de un centro de IoT.	Extension	GA
az iot hub wait	Espere hasta que se complete una operación en una instancia de IoT Hub.	Core	GA

az iot hub create

Cree una instancia de Azure IoT Hub.

Para obtener una introducción a Azure IoT Hub, consulte https://learn.microsoft.com/azure/iot-hub/.

az iot hub create --name
                  --resource-group
                  [--c2d-max-delivery-count --cdd]
                  [--c2d-ttl --ct]
                  [--dds --disable-device-sas {false, true}]
                  [--disable-local-auth --dla {false, true}]
                  [--disable-module-sas --dms {false, true}]
                  [--edr --enforce-data-residency {false, true}]
                  [--fc --fileupload-storage-container-name]
                  [--fcs --fileupload-storage-connectionstring]
                  [--fd --feedback-max-delivery-count]
                  [--feedback-lock-duration --fld]
                  [--feedback-ttl --ft]
                  [--fileupload-notification-lock-duration --fnld]
                  [--fileupload-notification-max-delivery-count --fnd]
                  [--fileupload-notification-ttl --fnt]
                  [--fileupload-notifications --fn {false, true}]
                  [--fileupload-sas-ttl --fst]
                  [--fileupload-storage-auth-type --fsa {identityBased, keyBased}]
                  [--fileupload-storage-identity --fsi]
                  [--location]
                  [--mi-system-assigned {false, true}]
                  [--mi-user-assigned]
                  [--min-tls-version --mintls]
                  [--no-wait]
                  [--partition-count]
                  [--rd --retention-day]
                  [--role]
                  [--scopes]
                  [--sku {B1, B2, B3, F1, S1, S2, S3}]
                  [--tags]
                  [--unit]

Ejemplos

Cree una instancia de IoT Hub con el plan de tarifa gratuito F1, en la región del grupo de recursos.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --sku F1 --partition-count 2

Cree una instancia de IoT Hub con el plan de tarifa estándar S1 y 4 particiones, en la región "westus", con etiquetas.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --tags a=b c=d

Cree una instancia de IoT Hub con una identidad administrada asignada por el sistema y asigne un rol y un ámbito a una cuenta de almacenamiento para la identidad creada.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --mi-system-assigned --role "Storage Blob Data Contributor" --scopes {resourceId}

Creación de una instancia de IoT Hub con autenticación local, claves SAS de dispositivo y claves SAS del módulo todas deshabilitadas

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --disable-local-auth --disable-device-sas --disable-module-sas

Cree una instancia de IoT Hub con la residencia de datos aplicada. Esto deshabilitará la recuperación ante desastres entre regiones.

az iot hub create --resource-group MyResourceGroup --name MyIoTHub --edr

Parámetros requeridos

--name -n

Nombre de IoT Hub.

--resource-group -g

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

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.

--c2d-max-delivery-count --cdd

El número de veces que el centro de IoT intentará entregar un mensaje de nube a dispositivo a un dispositivo, entre 1 y 100.

Propiedad	Valor
Valor predeterminado:	10

--c2d-ttl --ct

La cantidad de tiempo que un mensaje está disponible para que el dispositivo lo consuma antes de que IoT Hub expire, entre 1 y 48 horas.

Propiedad	Valor
Valor predeterminado:	1

--dds --disable-device-sas

Valor booleano que indica si se deben deshabilitar o no todos los dispositivos (incluidos los dispositivos perimetrales, pero los módulos excluidos) claves SAS con ámbito para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--disable-local-auth --dla

Valor booleano que indica si se deben deshabilitar o no claves SAS con ámbito de IoT Hub para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--disable-module-sas --dms

Valor booleano que indica si se deben deshabilitar o no claves SAS con ámbito de módulo para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--edr --enforce-data-residency

Aplique la residencia de datos para esta instancia de IoT Hub deshabilitando la recuperación ante desastres entre regiones. Esta propiedad es inmutable una vez establecida en el recurso. Solo está disponible en regiones seleccionadas. Obtenga más información en https://aka.ms/iothubdisabledr.

Propiedad	Valor
Valores aceptados:	false, true

--fc --fileupload-storage-container-name

Nombre del contenedor raíz donde se cargan los archivos. El contenedor no debe existir, pero debe ser creatable mediante el parámetro connectionString especificado.

--fcs --fileupload-storage-connectionstring

Cadena de conexión de la cuenta de Azure Storage a la que se cargan los archivos.

--fd --feedback-max-delivery-count

Número de veces que el centro de IoT intenta entregar un mensaje en la cola de comentarios, entre 1 y 100.

Propiedad	Valor
Valor predeterminado:	10

--feedback-lock-duration --fld

Duración del bloqueo de la cola de comentarios, entre 5 y 300 segundos.

Propiedad	Valor
Valor predeterminado:	5

--feedback-ttl --ft

Período de tiempo durante el cual el centro de IoT mantendrá los comentarios para la expiración o entrega de mensajes de nube a dispositivo, entre 1 y 48 horas.

Propiedad	Valor
Valor predeterminado:	1

--fileupload-notification-lock-duration --fnld

Duración del bloqueo de la cola de notificaciones de carga de archivos, entre 5 y 300 segundos.

Propiedad	Valor
Valor predeterminado:	5

--fileupload-notification-max-delivery-count --fnd

Número de veces que el centro de IoT intentará entregar un mensaje de notificación de archivo, entre 1 y 100.

Propiedad	Valor
Valor predeterminado:	10

--fileupload-notification-ttl --fnt

La cantidad de tiempo que una notificación de carga de archivos está disponible para que el servicio lo consuma antes de que IoT Hub expire, entre 1 y 48 horas.

Propiedad	Valor
Valor predeterminado:	1

--fileupload-notifications --fn

Valor booleano que indica si se va a registrar información sobre los archivos cargados en el punto de conexión de IoT Hub messages/servicebound/filenotifications.

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

--fileupload-sas-ttl --fst

La cantidad de tiempo que un URI de SAS generado por IoT Hub es válido antes de que expire, entre 1 y 24 horas.

Propiedad	Valor
Valor predeterminado:	1

--fileupload-storage-auth-type --fsa

Tipo de autenticación de la cuenta de Azure Storage a la que se cargan los archivos.

Propiedad	Valor
Valores aceptados:	identityBased, keyBased

--fileupload-storage-identity --fsi

Identidad administrada que se va a usar para la autenticación de carga de archivos. Use "[system]" para hacer referencia a la identidad administrada asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad administrada asignada por el usuario.

--location -l

Ubicación de ioT Hub. El valor predeterminado es la ubicación del grupo de recursos de destino.

--mi-system-assigned

Habilite la identidad administrada asignada por el sistema para este centro.

Propiedad	Valor
Valores aceptados:	false, true

--mi-user-assigned

Habilite las identidades administradas asignadas por el usuario para este centro. Acepte la lista separada por espacios de identificadores de recursos de identidad.

--min-tls-version --mintls

Especifique la versión mínima de TLS que se va a admitir para este centro. Se puede establecer en "1.0" o "1.2". Por ejemplo, la versión mínima de TLS establecida en "1.2" da como resultado que los clientes que usan una versión tls inferior a la 1.2 se rechacen.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--partition-count

Número de particiones del centro de eventos de respaldo para mensajes de dispositivo a nube.

Propiedad	Valor
Valor predeterminado:	4

--rd --retention-day

Especifica cuánto tiempo mantendrá este centro de IoT eventos de dispositivo a nube, entre 1 y 7 días.

Propiedad	Valor
Valor predeterminado:	1

--role

Rol que se va a asignar a la identidad administrada asignada por el sistema del centro.

--scopes

Lista separada por espacios de ámbitos para asignar el rol (--role) a la identidad administrada asignada por el sistema.

--sku

Plan de tarifa para Azure IoT Hub. Tenga en cuenta que solo se permite una instancia gratuita de IoT Hub (F1) en cada suscripción. Se producirá una excepción si las instancias libres superan una.

Propiedad	Valor
Valor predeterminado:	S1
Valores aceptados:	B1, B2, B3, F1, S1, S2, S3

--tags

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

--unit

Unidades en ioT Hub.

Propiedad	Valor
Valor predeterminado:	1

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 hub create (azure-iot extensión)

Cree una instancia de Azure IoT Hub.

Para obtener una introducción a Azure IoT Hub, consulte https://learn.microsoft.com/azure/iot-hub/.

az iot hub create --name
                  --resource-group
                  [--c2d-max-delivery-count --cdd]
                  [--c2d-ttl --ct]
                  [--custom-ns-role-id]
                  [--dds --disable-device-sas {false, true}]
                  [--disable-local-auth --dla {false, true}]
                  [--disable-module-sas --dms {false, true}]
                  [--edr --enforce-data-residency {false, true}]
                  [--fc --fileupload-storage-container-name]
                  [--fcs --fileupload-storage-connectionstring]
                  [--fd --feedback-max-delivery-count]
                  [--feedback-lock-duration --fld]
                  [--feedback-ttl --ft]
                  [--fileupload-notification-lock-duration --fnld]
                  [--fileupload-notification-max-delivery-count --fnd]
                  [--fileupload-notification-ttl --fnt]
                  [--fileupload-notifications --fn {false, true}]
                  [--fileupload-sas-ttl --fst]
                  [--fileupload-storage-auth-type --fsa {identityBased, keyBased}]
                  [--fileupload-storage-identity --fsi]
                  [--location]
                  [--mi-system-assigned {false, true}]
                  [--mi-user-assigned]
                  [--min-tls-version --mintls]
                  [--no-wait]
                  [--ns-identity-id]
                  [--ns-resource-id]
                  [--partition-count]
                  [--rd --retention-day]
                  [--role]
                  [--scopes]
                  [--skip-ns-ra {false, true}]
                  [--sku {B1, B2, B3, F1, GEN2, S1, S2, S3}]
                  [--tags]
                  [--unit]

Ejemplos

Cree una instancia de IoT Hub con el plan de tarifa gratuito F1, en la región del grupo de recursos.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --sku F1 --partition-count 2

Cree una instancia de IoT Hub con el plan de tarifa estándar S1 y 4 particiones, en la región "westus", con etiquetas.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --tags a=b c=d

Cree una instancia de IoT Hub con una identidad administrada asignada por el sistema y asigne un rol y un ámbito a una cuenta de almacenamiento para la identidad creada.

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --mi-system-assigned --role "Storage Blob Data Contributor" --scopes {resourceId}

Creación de una instancia de IoT Hub con autenticación local, claves SAS de dispositivo y claves SAS del módulo todas deshabilitadas

az iot hub create --resource-group MyResourceGroup --name MyIotHub --location westus --disable-local-auth --disable-device-sas --disable-module-sas

Cree una instancia de IoT Hub con la residencia de datos aplicada. Esto deshabilitará la recuperación ante desastres entre regiones.

az iot hub create --resource-group MyResourceGroup --name MyIoTHub --edr

Cree una instancia de IoT Hub de Generación2 con las propiedades del espacio de nombres del Registro de dispositivos.

az iot hub create --resource-group MyResourceGroup --name MyHub --sku GEN2 --ns-resource-id NamespaceResourceId --ns-identity-id UserIdentityResourceId

Cree una instancia de IoT Hub de Generación2 con las propiedades del espacio de nombres del Registro de dispositivos y la asignación de roles personalizada.

az iot hub create --resource-group MyResourceGroup --name MyHub --sku GEN2 --ns-resource-id NamespaceResourceId --ns-identity-id UserIdentityResourceId --custom-ns-role-id RoleResourceId

Cree una instancia de IoT Hub de Generación2 con las propiedades del espacio de nombres del Registro de dispositivos y omita la asignación de roles.

az iot hub create --resource-group MyResourceGroup --name MyHub --sku GEN2 --ns-resource-id NamespaceResourceId --ns-identity-id UserIdentityResourceId --skip-ns-ra

Parámetros requeridos

--name -n

Nombre de IoT Hub.

--resource-group -g

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

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.

--c2d-max-delivery-count --cdd

El número de veces que el centro de IoT intentará entregar un mensaje de nube a dispositivo a un dispositivo, entre 1 y 100.

Propiedad	Valor
Valor predeterminado:	10

--c2d-ttl --ct

La cantidad de tiempo que un mensaje está disponible para que el dispositivo lo consuma antes de que IoT Hub expire, entre 1 y 48 horas.

Propiedad	Valor
Valor predeterminado:	1

--custom-ns-role-id

Identificador de definición de roles completo que se aplicará al espacio de nombres de ADR, en el siguiente formato: /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleId}. Solo se aplica a Las instancias de IoT Hub de Gen2.

Propiedad	Valor
Grupo de parámetros:	ADR Namespace Role Assignment Arguments

--dds --disable-device-sas

Valor booleano que indica si se deben deshabilitar o no todos los dispositivos (incluidos los dispositivos perimetrales, pero los módulos excluidos) claves SAS con ámbito para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--disable-local-auth --dla

Valor booleano que indica si se deben deshabilitar o no claves SAS con ámbito de IoT Hub para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--disable-module-sas --dms

Valor booleano que indica si se deben deshabilitar o no claves SAS con ámbito de módulo para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--edr --enforce-data-residency

Aplique la residencia de datos para esta instancia de IoT Hub deshabilitando la recuperación ante desastres entre regiones. Esta propiedad es inmutable una vez establecida en el recurso. Solo está disponible en regiones seleccionadas. Obtenga más información en https://aka.ms/iothubdisabledr.

Propiedad	Valor
Valores aceptados:	false, true

--fc --fileupload-storage-container-name

Nombre del contenedor raíz donde se cargan los archivos. El contenedor no debe existir, pero debe ser creatable mediante el parámetro connectionString especificado.

--fcs --fileupload-storage-connectionstring

Cadena de conexión de la cuenta de Azure Storage a la que se cargan los archivos.

--fd --feedback-max-delivery-count

Número de veces que el centro de IoT intenta entregar un mensaje en la cola de comentarios, entre 1 y 100.

Propiedad	Valor
Valor predeterminado:	10

--feedback-lock-duration --fld

Duración del bloqueo de la cola de comentarios, entre 5 y 300 segundos.

Propiedad	Valor
Valor predeterminado:	5

--feedback-ttl --ft

Período de tiempo durante el cual el centro de IoT mantendrá los comentarios para la expiración o entrega de mensajes de nube a dispositivo, entre 1 y 48 horas.

Propiedad	Valor
Valor predeterminado:	1

--fileupload-notification-lock-duration --fnld

Duración del bloqueo de la cola de notificaciones de carga de archivos, entre 5 y 300 segundos.

Propiedad	Valor
Valor predeterminado:	5

--fileupload-notification-max-delivery-count --fnd

Número de veces que el centro de IoT intentará entregar un mensaje de notificación de archivo, entre 1 y 100.

Propiedad	Valor
Valor predeterminado:	10

--fileupload-notification-ttl --fnt

La cantidad de tiempo que una notificación de carga de archivos está disponible para que el servicio lo consuma antes de que IoT Hub expire, entre 1 y 48 horas.

Propiedad	Valor
Valor predeterminado:	1

--fileupload-notifications --fn

Valor booleano que indica si se va a registrar información sobre los archivos cargados en el punto de conexión de IoT Hub messages/servicebound/filenotifications.

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

--fileupload-sas-ttl --fst

La cantidad de tiempo que un URI de SAS generado por IoT Hub es válido antes de que expire, entre 1 y 24 horas.

Propiedad	Valor
Valor predeterminado:	1

--fileupload-storage-auth-type --fsa

Tipo de autenticación de la cuenta de Azure Storage a la que se cargan los archivos.

Propiedad	Valor
Valores aceptados:	identityBased, keyBased

--fileupload-storage-identity --fsi

Identidad administrada que se va a usar para la autenticación de carga de archivos. Use "[system]" para hacer referencia a la identidad administrada asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad administrada asignada por el usuario.

--location -l

Ubicación de ioT Hub. El valor predeterminado es la ubicación del grupo de recursos de destino.

--mi-system-assigned

Habilite la identidad administrada asignada por el sistema para este centro.

Propiedad	Valor
Valores aceptados:	false, true

--mi-user-assigned

Habilite las identidades administradas asignadas por el usuario para este centro. Acepte la lista separada por espacios de identificadores de recursos de identidad.

--min-tls-version --mintls

Especifique la versión mínima de TLS que se va a admitir para este centro. Se puede establecer en "1.0" o "1.2". Por ejemplo, la versión mínima de TLS establecida en "1.2" da como resultado que los clientes que usan una versión tls inferior a la 1.2 se rechacen.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--ns-identity-id

Identificador de recurso de identidad administrada por el usuario para acceder al espacio de nombres del Registro de dispositivos.

--ns-resource-id

Identificador de recurso del espacio de nombres del Registro de dispositivos para vincular a este centro de IoT.

--partition-count

Número de particiones del centro de eventos de respaldo para mensajes de dispositivo a nube.

Propiedad	Valor
Valor predeterminado:	4

--rd --retention-day

Especifica cuánto tiempo mantendrá este centro de IoT eventos de dispositivo a nube, entre 1 y 7 días.

Propiedad	Valor
Valor predeterminado:	1

--role

Rol que se va a asignar a la identidad administrada asignada por el sistema del centro.

--scopes

Lista separada por espacios de ámbitos para asignar el rol (--role) a la identidad administrada asignada por el sistema.

--skip-ns-ra

Se usa para omitir la asignación de roles del espacio de nombres de ADR después de la creación de IoT Hub. Solo se aplica a Las instancias de IoT Hub de Gen2.

Propiedad	Valor
Grupo de parámetros:	ADR Namespace Role Assignment Arguments
Valores aceptados:	false, true

--sku

Plan de tarifa para Azure IoT Hub. Tenga en cuenta que solo se permite una instancia gratuita de IoT Hub (F1) en cada suscripción. Se producirá una excepción si las instancias libres superan una.

Propiedad	Valor
Valor predeterminado:	S1
Valores aceptados:	B1, B2, B3, F1, GEN2, S1, S2, S3

--tags

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

--unit

Unidades en ioT Hub.

Propiedad	Valor
Valor predeterminado:	1

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

Elimine un centro de IoT.

az iot hub delete [--ids]
                  [--name]
                  [--no-wait]
                  [--resource-group]
                  [--subscription]

Ejemplos

Elimine un centro de IoT. (autogenerated)

az iot hub delete --name MyIoTHub --resource-group MyResourceGroup

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub delete (azure-iot extensión)

Elimine un centro de IoT.

az iot hub delete [--ids]
                  [--name]
                  [--no-wait]
                  [--resource-group]
                  [--subscription]

Ejemplos

Elimine un centro de IoT. (autogenerated)

az iot hub delete --name MyIoTHub --resource-group MyResourceGroup

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub generate-sas-token

Genere un token de SAS para un ioT Hub de destino, un dispositivo o un módulo.

En el caso de los tokens saS de dispositivo, el parámetro de directiva solo se usa para acceder al registro de dispositivos. Por lo tanto, la directiva debe tener acceso de lectura al Registro. Para los tokens de IoT Hub, la directiva forma parte de la SAS.

az iot hub generate-sas-token [--auth-type {key, login}]
                              [--connection-string --cs]
                              [--device-id]
                              [--du --duration]
                              [--hub-name]
                              [--key-type --kt {primary, secondary}]
                              [--login]
                              [--module-id]
                              [--pn --policy-name]
                              [--resource-group]

Ejemplos

Genere un token de SAS de IoT Hub mediante la directiva iothubowner y la clave principal.

az iot hub generate-sas-token -n {iothub_name}

Genere un token de SAS de IoT Hub mediante la directiva RegistryRead y la clave secundaria.

az iot hub generate-sas-token -n {iothub_name} --policy registryRead --key-type secondary

Genere un token de SAS de dispositivo mediante la directiva iothubowner para acceder al registro de dispositivos {iothub_name}.

az iot hub generate-sas-token -d {device_id} -n {iothub_name}

Generación de un token de SAS de dispositivo mediante una cadena de conexión de IoT Hub (con acceso al registro)

az iot hub generate-sas-token -d {device_id} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Generación de un token de SAS de IoT Hub mediante una cadena de conexión de IoT Hub

az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Generación de un token de SAS de dispositivo mediante un dispositivo cadena de conexión

az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;DeviceId=mydevice;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Generación de un token saS de módulo mediante un módulo cadena de conexión

az iot hub generate-sas-token --connection-string 'HostName=myhub.azure-devices.net;DeviceId=mydevice;ModuleId=mymodule;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

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.

--auth-type

Indica si la operación debe derivar automáticamente una clave de directiva o usar la sesión actual de Azure AD. Si el tipo de autenticación es login y se proporciona el nombre de host del recurso, se omitirá la búsqueda de recursos a menos que sea necesario. Puede configurar el valor predeterminado mediante az configure --defaults iothub-data-auth-type={auth-type-value}.

Propiedad	Valor
Grupo de parámetros:	Access Control Arguments
Valor predeterminado:	key
Valores aceptados:	key, login

--connection-string --cs

Cadena de conexión de destino. Esto omite el registro de IoT Hub y genera el token de SAS directamente desde la clave simétrica proporcionada sin ninguna validación adicional. Se omitirán todos los demás parámetros de comando aparte de la duración. Tipos de cadena de conexión admitidos: Iot Hub, Device, Module.

--device-id -d

Id. de dispositivo de destino.

--du --duration

Duración válida del token en segundos.

Propiedad	Valor
Valor predeterminado:	3600

--hub-name -n

Nombre o nombre de host de IoT Hub. Obligatorio si no se proporciona --login.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--key-type --kt

Tipo de clave de directiva de acceso compartido para la autenticación.

Propiedad	Valor
Valor predeterminado:	primary
Valores aceptados:	primary, secondary

--login -l

Este comando admite una cadena de conexión de entidad con derechos para realizar la acción. Use para evitar el inicio de sesión de sesión a través de "az login". Si se proporcionan las cadena de conexión y el nombre de una entidad, el cadena de conexión tiene prioridad. Obligatorio si no se proporciona --hub-name.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--module-id -m

Id. del módulo de destino.

--pn --policy-name

Directiva de acceso compartido con permisos de operación para la entidad de IoT Hub de destino.

Propiedad	Valor
Valor predeterminado:	iothubowner

--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 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 hub invoke-device-method

Invoque un método de dispositivo.

az iot hub invoke-device-method --device-id
                                --method-name --mn
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--method-payload --mp]
                                [--resource-group]
                                [--timeout --to]

Ejemplos

Invoque un método directo en un dispositivo.

az iot hub invoke-device-method --hub-name {iothub_name} --device-id {device_id} --method-name Reboot --method-payload '{"version":"1.0"}'

Parámetros requeridos

--device-id -d

Id. de dispositivo de destino.

--method-name --mn

Método de destino para la invocació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.

--auth-type

Indica si la operación debe derivar automáticamente una clave de directiva o usar la sesión actual de Azure AD. Si el tipo de autenticación es login y se proporciona el nombre de host del recurso, se omitirá la búsqueda de recursos a menos que sea necesario. Puede configurar el valor predeterminado mediante az configure --defaults iothub-data-auth-type={auth-type-value}.

Propiedad	Valor
Grupo de parámetros:	Access Control Arguments
Valor predeterminado:	key
Valores aceptados:	key, login

--hub-name -n

Nombre o nombre de host de IoT Hub. Obligatorio si no se proporciona --login.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--login -l

Este comando admite una cadena de conexión de entidad con derechos para realizar la acción. Use para evitar el inicio de sesión de sesión a través de "az login". Si se proporcionan las cadena de conexión y el nombre de una entidad, el cadena de conexión tiene prioridad. Obligatorio si no se proporciona --hub-name.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--method-payload --mp

Carga json que se va a pasar al método . Debe ser la ruta de acceso del archivo o json sin formato.

Propiedad	Valor
Valor predeterminado:	{}

--resource-group -g

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

--timeout --to

Número máximo de segundos para esperar el resultado del método de dispositivo.

Propiedad	Valor
Valor predeterminado:	30

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 hub invoke-module-method

Invoque un método de módulo.

Este comando admite módulos de dispositivos perimetrales y no perimetrales.

az iot hub invoke-module-method --device-id
                                --method-name --mn
                                --module-id
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--method-payload --mp]
                                [--resource-group]
                                [--timeout --to]

Ejemplos

Invoque un método directo en un módulo de dispositivo perimetral.

az iot hub invoke-module-method -n {iothub_name} -d {device_id} -m '$edgeAgent' --method-name 'RestartModule' --method-payload '{"schemaVersion": "1.0"}'

Parámetros requeridos

--device-id -d

Id. de dispositivo de destino.

--method-name --mn

Método de destino para la invocación.

--module-id -m

Id. del módulo de destino.

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.

--auth-type

Indica si la operación debe derivar automáticamente una clave de directiva o usar la sesión actual de Azure AD. Si el tipo de autenticación es login y se proporciona el nombre de host del recurso, se omitirá la búsqueda de recursos a menos que sea necesario. Puede configurar el valor predeterminado mediante az configure --defaults iothub-data-auth-type={auth-type-value}.

Propiedad	Valor
Grupo de parámetros:	Access Control Arguments
Valor predeterminado:	key
Valores aceptados:	key, login

--hub-name -n

Nombre o nombre de host de IoT Hub. Obligatorio si no se proporciona --login.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--login -l

Este comando admite una cadena de conexión de entidad con derechos para realizar la acción. Use para evitar el inicio de sesión de sesión a través de "az login". Si se proporcionan las cadena de conexión y el nombre de una entidad, el cadena de conexión tiene prioridad. Obligatorio si no se proporciona --hub-name.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--method-payload --mp

Carga json que se va a pasar al método . Debe ser la ruta de acceso del archivo o json sin formato.

Propiedad	Valor
Valor predeterminado:	{}

--resource-group -g

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

--timeout --to

Número máximo de segundos para esperar el resultado del método de módulo.

Propiedad	Valor
Valor predeterminado:	30

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

Enumeración de centros de IoT.

az iot hub list [--resource-group]

Ejemplos

Enumere todos los centros de IoT de una suscripción.

az iot hub list

Enumeración de todos los centros de IoT del grupo de recursos "MyGroup"

az iot hub list --resource-group MyGroup

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.

--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 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 hub list (azure-iot extensión)

Enumeración de centros de IoT.

az iot hub list [--resource-group]

Ejemplos

Enumere todos los centros de IoT de una suscripción.

az iot hub list

Enumeración de todos los centros de IoT del grupo de recursos "MyGroup"

az iot hub list --resource-group MyGroup

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.

--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 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 hub list-skus

Enumere los planes de tarifa disponibles.

az iot hub list-skus [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

Ejemplos

Enumere los planes de tarifa disponibles. (autogenerated)

az iot hub list-skus --name MyIoTHub

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub list-skus (azure-iot extensión)

Enumere los planes de tarifa disponibles.

az iot hub list-skus [--ids]
                     [--name]
                     [--resource-group]
                     [--subscription]

Ejemplos

Enumere los planes de tarifa disponibles. (autogenerated)

az iot hub list-skus --name MyIoTHub

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub manual-failover

Inicie una conmutación por error manual para IoT Hub en la región de recuperación ante desastres emparejada geográficamente.

az iot hub manual-failover [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]

Ejemplos

Inicie la conmutación por error "myhub" desde la región principal a la secundaria.

az iot hub manual-failover -n myhub

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub manual-failover (azure-iot extensión)

Inicie una conmutación por error manual para IoT Hub en la región de recuperación ante desastres emparejada geográficamente.

az iot hub manual-failover [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]

Ejemplos

Inicie la conmutación por error "myhub" desde la región principal a la secundaria.

az iot hub manual-failover -n myhub

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub monitor-events

Supervise los mensajes y telemetría del dispositivo enviados a ioT Hub.

Este comando se basa en y puede instalar el paquete Cython dependiente (uamqp) tras la primera ejecución. https://github.com/Azure/azure-uamqp-python

Nota: El evento se mostrará incluso si el cuerpo del mensaje no es descodificador unicode, en este caso, la parte de carga del evento se mostrará como {{carga no descodable}} con el resto de las propiedades del evento disponibles.

az iot hub monitor-events [--cg --consumer-group]
                          [--content-type --ct]
                          [--device-id]
                          [--device-query]
                          [--enqueued-time --et]
                          [--hub-name]
                          [--interface]
                          [--login]
                          [--mc --message-count]
                          [--module-id]
                          [--properties --props {all, anno, app, sys}]
                          [--repair {false, true}]
                          [--resource-group]
                          [--timeout --to]
                          [--yes {false, true}]

Ejemplos

Uso básico

az iot hub monitor-events -n {iothub_name}

Uso básico con una cadena de conexión de IoT Hub

az iot hub monitor-events -n {iothub_name} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Uso básico al filtrar en el dispositivo de destino

az iot hub monitor-events -n {iothub_name} -d {device_id}

Uso básico al filtrar dispositivos de destino con un carácter comodín en el identificador

az iot hub monitor-events -n {iothub_name} -d Device*

Filtrado de dispositivos mediante el lenguaje de consulta de IoT Hub

az iot hub monitor-events -n {iothub_name} -q "select * from devices where tags.location.region = 'US'"

Filtre el dispositivo y especifique un grupo de consumidores del centro de eventos al que se va a enlazar.

az iot hub monitor-events -n {iothub_name} -d {device_id} --cg {consumer_group_name}

Recibir anotaciones de mensaje (encabezados de mensaje)

az iot hub monitor-events -n {iothub_name} -d {device_id} --properties anno

Recibir anotaciones de mensaje + propiedades del sistema. Nunca se agota el tiempo de espera.

az iot hub monitor-events -n {iothub_name} -d {device_id} --properties anno sys --timeout 0

Recepción de todos los atributos de mensaje de todos los mensajes de dispositivo

az iot hub monitor-events -n {iothub_name} --props all

Recepción de todos los mensajes y análisis de la carga de mensajes como JSON

az iot hub monitor-events -n {iothub_name} --content-type application/json

Reciba el número especificado de mensajes del centro y, a continuación, se apague.

az iot hub monitor-events -n {iothub_name} --message-count {message_count}

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.

--cg --consumer-group -c

Especifique el grupo de consumidores que se usará al conectarse al punto de conexión del centro de eventos.

Propiedad	Valor
Valor predeterminado:	$Default

--content-type --ct

Especifique el tipo de contenido de la carga del mensaje para dar formato automáticamente a la salida a ese tipo.

--device-id -d

Id. de dispositivo de destino.

--device-query -q

Especifique una consulta personalizada para filtrar los dispositivos.

--enqueued-time --et -e

Indica la hora que se debe usar como punto de partida para leer los mensajes de las particiones. Las unidades son milisegundos desde la época unix. Si no se indica "ahora" se usa ninguna hora.

--hub-name -n

Nombre o nombre de host de IoT Hub. Obligatorio si no se proporciona --login.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--interface -i

Identificador de interfaz de destino en el que se va a filtrar. Por ejemplo: dtmi:com:example:TemperatureController;1.

--login -l

Este comando admite una cadena de conexión de entidad con derechos para realizar la acción. Use para evitar el inicio de sesión de sesión a través de "az login". Si se proporcionan las cadena de conexión y el nombre de una entidad, el cadena de conexión tiene prioridad. Obligatorio si no se proporciona --hub-name.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--mc --message-count

Número de mensajes de telemetría que se van a capturar antes de que finalice el monitor. Si no se especifica, el monitor sigue ejecutándose hasta que se cumpla el umbral de tiempo de espera de no recibir mensajes del centro.

--module-id -m

Id. del módulo de destino.

--properties --props -p

Indique las propiedades del mensaje clave que se van a generar. sys = propiedades del sistema, app = propiedades de la aplicación, anno = anotaciones.

Propiedad	Valor
Valores aceptados:	all, anno, app, sys

--repair -r

Vuelva a instalar la dependencia de uamqp compatible con la versión de la extensión. Valor predeterminado: false.

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

--resource-group -g

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

--timeout --to -t

Máximo de segundos para mantener la conexión sin recibir el mensaje. Use 0 para infinito.

Propiedad	Valor
Valor predeterminado:	300

--yes -y

Omita las indicaciones del usuario. Indica la aceptación de la acción. Se usa principalmente para escenarios de automatización. Valor predeterminado: false.

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 hub monitor-feedback

Supervise los comentarios enviados por los dispositivos para confirmar los mensajes de la nube al dispositivo (C2D).

Este comando se basa en y puede instalar el paquete Cython dependiente (uamqp) tras la primera ejecución. https://github.com/Azure/azure-uamqp-python.

az iot hub monitor-feedback [--auth-type {key, login}]
                            [--device-id]
                            [--hub-name]
                            [--login]
                            [--repair {false, true}]
                            [--resource-group]
                            [--wait-on-msg]
                            [--yes {false, true}]

Ejemplos

Uso básico

az iot hub monitor-feedback -n {iothub_name}

Uso básico con una cadena de conexión de IoT Hub

az iot hub monitor-feedback -n {iothub_name} --login 'HostName=myhub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=12345'

Uso básico al filtrar en el dispositivo de destino

az iot hub monitor-feedback -n {iothub_name} -d {device_id}

Supervisión de comentarios de salida al recibir un mensaje con un identificador específico (uuid)

az iot hub monitor-feedback -n {iothub_name} -d {device_id} -w {message_id}

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.

--auth-type

Indica si la operación debe derivar automáticamente una clave de directiva o usar la sesión actual de Azure AD. Si el tipo de autenticación es login y se proporciona el nombre de host del recurso, se omitirá la búsqueda de recursos a menos que sea necesario. Puede configurar el valor predeterminado mediante az configure --defaults iothub-data-auth-type={auth-type-value}.

Propiedad	Valor
Grupo de parámetros:	Access Control Arguments
Valor predeterminado:	key
Valores aceptados:	key, login

--device-id -d

Id. de dispositivo de destino.

--hub-name -n

Nombre o nombre de host de IoT Hub. Obligatorio si no se proporciona --login.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--login -l

Este comando admite una cadena de conexión de entidad con derechos para realizar la acción. Use para evitar el inicio de sesión de sesión a través de "az login". Si se proporcionan las cadena de conexión y el nombre de una entidad, el cadena de conexión tiene prioridad. Obligatorio si no se proporciona --hub-name.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--repair -r

Vuelva a instalar la dependencia de uamqp compatible con la versión de la extensión. Valor predeterminado: false.

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

--resource-group -g

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

--wait-on-msg -w

El monitor de comentarios se bloqueará hasta que se reciba un mensaje con un identificador específico (uuid).

--yes -y

Omita las indicaciones del usuario. Indica la aceptación de la acción. Se usa principalmente para escenarios de automatización. Valor predeterminado: false.

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 hub query

Consulte una instancia de IoT Hub con un lenguaje similar a SQL eficaz.

Recupere información sobre dispositivos y módulos gemelos, trabajos y enrutamiento de mensajes. Consulte https://learn.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language para obtener más información.

az iot hub query --query-command
                 [--auth-type {key, login}]
                 [--hub-name]
                 [--login]
                 [--resource-group]
                 [--top]

Ejemplos

Consulte todos los datos de dispositivos gemelos en una instancia de Azure IoT Hub.

az iot hub query -n {iothub_name} -q "select * from devices"

Consulte todos los datos del módulo gemelo en el dispositivo de destino.

az iot hub query -n {iothub_name} -q "select * from devices.modules where devices.deviceId = '{device_id}'"

Parámetros requeridos

--query-command -q

Consulta de usuario que se va a ejecutar.

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.

--auth-type

Indica si la operación debe derivar automáticamente una clave de directiva o usar la sesión actual de Azure AD. Si el tipo de autenticación es login y se proporciona el nombre de host del recurso, se omitirá la búsqueda de recursos a menos que sea necesario. Puede configurar el valor predeterminado mediante az configure --defaults iothub-data-auth-type={auth-type-value}.

Propiedad	Valor
Grupo de parámetros:	Access Control Arguments
Valor predeterminado:	key
Valores aceptados:	key, login

--hub-name -n

Nombre o nombre de host de IoT Hub. Obligatorio si no se proporciona --login.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--login -l

Este comando admite una cadena de conexión de entidad con derechos para realizar la acción. Use para evitar el inicio de sesión de sesión a través de "az login". Si se proporcionan las cadena de conexión y el nombre de una entidad, el cadena de conexión tiene prioridad. Obligatorio si no se proporciona --hub-name.

Propiedad	Valor
Grupo de parámetros:	IoT Hub Identifier Arguments

--resource-group -g

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

--top

Número máximo de elementos que se van a devolver. De forma predeterminada, la consulta no tiene ningún límite.

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

Obtenga los detalles de un centro de IoT.

az iot hub show [--ids]
                [--name]
                [--resource-group]
                [--subscription]

Ejemplos

Obtenga los detalles de un centro de IoT. (autogenerated)

az iot hub show --name MyIoTHub

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub show (azure-iot extensión)

Obtenga los detalles de un centro de IoT.

az iot hub show [--ids]
                [--name]
                [--resource-group]
                [--subscription]

Ejemplos

Obtenga los detalles de un centro de IoT. (autogenerated)

az iot hub show --name MyIoTHub

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub show-quota-metrics

Obtenga las métricas de cuota de un centro de IoT.

az iot hub show-quota-metrics [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

Ejemplos

Obtenga las métricas de cuota de un centro de IoT. (autogenerated)

az iot hub show-quota-metrics --ids {ids}

Obtenga las métricas de cuota de un centro de IoT. (autogenerated)

az iot hub show-quota-metrics --name MyIoTHub

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub show-quota-metrics (azure-iot extensión)

Obtenga las métricas de cuota de un centro de IoT.

az iot hub show-quota-metrics [--ids]
                              [--name]
                              [--resource-group]
                              [--subscription]

Ejemplos

Obtenga las métricas de cuota de un centro de IoT. (autogenerated)

az iot hub show-quota-metrics --ids {ids}

Obtenga las métricas de cuota de un centro de IoT. (autogenerated)

az iot hub show-quota-metrics --name MyIoTHub

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub show-stats

Obtenga las estadísticas de un centro de IoT.

az iot hub show-stats [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

Ejemplos

Obtenga las estadísticas de un centro de IoT. (autogenerated)

az iot hub show-stats --name MyIoTHub

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub show-stats (azure-iot extensión)

Obtenga las estadísticas de un centro de IoT.

az iot hub show-stats [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

Ejemplos

Obtenga las estadísticas de un centro de IoT. (autogenerated)

az iot hub show-stats --name MyIoTHub

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub update

Actualice los metadatos de un centro de IoT.

az iot hub update [--add]
                  [--c2d-max-delivery-count --cdd]
                  [--c2d-ttl --ct]
                  [--dds --disable-device-sas {false, true}]
                  [--disable-local-auth --dla {false, true}]
                  [--disable-module-sas --dms {false, true}]
                  [--fc --fileupload-storage-container-name]
                  [--fcs --fileupload-storage-connectionstring]
                  [--fd --feedback-max-delivery-count]
                  [--feedback-lock-duration --fld]
                  [--feedback-ttl --ft]
                  [--fileupload-notification-lock-duration --fnld]
                  [--fileupload-notification-max-delivery-count --fnd]
                  [--fileupload-notification-ttl --fnt]
                  [--fileupload-notifications --fn {false, true}]
                  [--fileupload-sas-ttl --fst]
                  [--fileupload-storage-auth-type --fsa {identityBased, keyBased}]
                  [--fileupload-storage-identity --fsi]
                  [--force-string]
                  [--ids]
                  [--min-tls-version --mintls]
                  [--name]
                  [--rd --retention-day]
                  [--remove]
                  [--resource-group]
                  [--set]
                  [--sku {B1, B2, B3, F1, S1, S2, S3}]
                  [--subscription]
                  [--tags]
                  [--unit]

Ejemplos

Adición de la configuración del contenedor de almacenamiento a la carga de archivos

az iot hub update --name MyIotHub --fileupload-storage-connectionstring "connection-string" \ --fileupload-storage-container-name "container_name"

Agregue una regla de filtro de firewall para aceptar el tráfico de la máscara IP 127.0.0.0/31.

az iot hub update --name MyIotHub --add properties.ipFilterRules filter_name=test-rule action=Accept ip_mask=127.0.0.0/31

Actualice los metadatos de un centro de IoT. (autogenerated)

az iot hub update --name MyIotHub --set properties.allocationPolicy="GeoLatency"

Actualice las unidades de una instancia de IoT Hub a 2 y agregue etiquetas

az iot hub update -n MyIotHub --unit 2 --tags a=b c=d

Actualización del plan de tarifa de una instancia de IoT Hub como S2

az iot hub update -n MyIotHub --sku S2

Actualizar los días de retención de eventos de dispositivo a nube de IoT Hub como 3 días

az iot hub update -n MyIotHub --retention-day 3

Actualización de la configuración de mensajería de nube a dispositivo de IoT Hub

az iot hub update --name MyIotHub --c2d-max-delivery-count 30 --c2d-ttl 5

Actualización de la configuración de cola de comentarios de IoT Hub

az iot hub update --name MyIoTHub --feedback-max-delivery-count 20 --feedback-lock-duration 100 --feedback-ttl 4

Actualice la configuración de carga de archivos de IoT Hub y asigne una identidad administrada al usuario para la carga de archivos.

az iot hub update -n MyIoTHub --fileupload-sas-ttl 5 --fileupload-storage-auth-type identityBased --fileupload-storage-identity [system]

Actualizar la configuración de notificación de carga de archivos de IoT Hub y la duración del bloqueo de cola

az iot hub update -n MyIoTHub --fileupload-notification-max-delivery-count 50 --fileupload-notification-ttl 48 --fileupload-notifications --fileupload-notification-lock-duration 10

Actualización de la autenticación local de IoT Hub, la SAS del dispositivo y la configuración de SAS del módulo

az iot hub update -n MyIoTHub --disable-local-auth --disable-device-sas false --disable-module-sas true

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.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--c2d-max-delivery-count --cdd

El número de veces que el centro de IoT intentará entregar un mensaje de nube a dispositivo a un dispositivo, entre 1 y 100.

--c2d-ttl --ct

La cantidad de tiempo que un mensaje está disponible para que el dispositivo lo consuma antes de que IoT Hub expire, entre 1 y 48 horas.

--dds --disable-device-sas

Valor booleano que indica si se deben deshabilitar o no todos los dispositivos (incluidos los dispositivos perimetrales, pero los módulos excluidos) claves SAS con ámbito para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--disable-local-auth --dla

Valor booleano que indica si se deben deshabilitar o no claves SAS con ámbito de IoT Hub para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--disable-module-sas --dms

Valor booleano que indica si se deben deshabilitar o no claves SAS con ámbito de módulo para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--fc --fileupload-storage-container-name

Nombre del contenedor raíz donde se cargan los archivos. El contenedor no debe existir, pero debe ser creatable mediante el parámetro connectionString especificado.

--fcs --fileupload-storage-connectionstring

Cadena de conexión de la cuenta de Azure Storage a la que se cargan los archivos.

--fd --feedback-max-delivery-count

Número de veces que el centro de IoT intenta entregar un mensaje en la cola de comentarios, entre 1 y 100.

--feedback-lock-duration --fld

Duración del bloqueo de la cola de comentarios, entre 5 y 300 segundos.

--feedback-ttl --ft

Período de tiempo durante el cual el centro de IoT mantendrá los comentarios para la expiración o entrega de mensajes de nube a dispositivo, entre 1 y 48 horas.

--fileupload-notification-lock-duration --fnld

Duración del bloqueo de la cola de notificaciones de carga de archivos, entre 5 y 300 segundos.

--fileupload-notification-max-delivery-count --fnd

Número de veces que el centro de IoT intentará entregar un mensaje de notificación de archivo, entre 1 y 100.

--fileupload-notification-ttl --fnt

La cantidad de tiempo que una notificación de carga de archivos está disponible para que el servicio lo consuma antes de que IoT Hub expire, entre 1 y 48 horas.

--fileupload-notifications --fn

Valor booleano que indica si se va a registrar información sobre los archivos cargados en el punto de conexión de IoT Hub messages/servicebound/filenotifications.

Propiedad	Valor
Valores aceptados:	false, true

--fileupload-sas-ttl --fst

La cantidad de tiempo que un URI de SAS generado por IoT Hub es válido antes de que expire, entre 1 y 24 horas.

--fileupload-storage-auth-type --fsa

Tipo de autenticación de la cuenta de Azure Storage a la que se cargan los archivos.

Propiedad	Valor
Valores aceptados:	identityBased, keyBased

--fileupload-storage-identity --fsi

Identidad administrada que se va a usar para la autenticación de carga de archivos. Use "[system]" para hacer referencia a la identidad administrada asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad administrada asignada por el usuario.

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	False

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--min-tls-version --mintls

Especifique la versión mínima de TLS que se va a admitir para este centro. Se puede establecer en "1.0" o "1.2". Por ejemplo, la versión mínima de TLS establecida en "1.2" da como resultado que los clientes que usan una versión tls inferior a la 1.2 se rechacen.

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--rd --retention-day

Especifica cuánto tiempo mantendrá este centro de IoT eventos de dispositivo a nube, entre 1 y 7 días.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--sku

Plan de tarifa para Azure IoT Hub. Tenga en cuenta que solo se permite una instancia gratuita de IoT Hub (F1) en cada suscripción. Se producirá una excepción si las instancias libres superan una.

Propiedad	Valor
Valores aceptados:	B1, B2, B3, F1, S1, S2, S3

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--tags

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

--unit

Unidades en ioT Hub.

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub update (azure-iot extensión)

Actualice los metadatos de un centro de IoT.

az iot hub update [--add]
                  [--c2d-max-delivery-count --cdd]
                  [--c2d-ttl --ct]
                  [--dds --disable-device-sas {false, true}]
                  [--disable-local-auth --dla {false, true}]
                  [--disable-module-sas --dms {false, true}]
                  [--fc --fileupload-storage-container-name]
                  [--fcs --fileupload-storage-connectionstring]
                  [--fd --feedback-max-delivery-count]
                  [--feedback-lock-duration --fld]
                  [--feedback-ttl --ft]
                  [--fileupload-notification-lock-duration --fnld]
                  [--fileupload-notification-max-delivery-count --fnd]
                  [--fileupload-notification-ttl --fnt]
                  [--fileupload-notifications --fn {false, true}]
                  [--fileupload-sas-ttl --fst]
                  [--fileupload-storage-auth-type --fsa {identityBased, keyBased}]
                  [--fileupload-storage-identity --fsi]
                  [--force-string]
                  [--ids]
                  [--min-tls-version --mintls]
                  [--name]
                  [--ns-identity-id]
                  [--rd --retention-day]
                  [--remove]
                  [--resource-group]
                  [--set]
                  [--sku {B1, B2, B3, F1, GEN2, S1, S2, S3}]
                  [--subscription]
                  [--tags]
                  [--unit]

Ejemplos

Adición de la configuración del contenedor de almacenamiento a la carga de archivos

az iot hub update --name MyIotHub --fileupload-storage-connectionstring "connection-string" \ --fileupload-storage-container-name "container_name"

Agregue una regla de filtro de firewall para aceptar el tráfico de la máscara IP 127.0.0.0/31.

az iot hub update --name MyIotHub --add properties.ipFilterRules filter_name=test-rule action=Accept ip_mask=127.0.0.0/31

Actualice los metadatos de un centro de IoT. (autogenerated)

az iot hub update --name MyIotHub --set properties.allocationPolicy="GeoLatency"

Actualice las unidades de una instancia de IoT Hub a 2 y agregue etiquetas

az iot hub update -n MyIotHub --unit 2 --tags a=b c=d

Actualización del plan de tarifa de una instancia de IoT Hub como S2

az iot hub update -n MyIotHub --sku S2

Actualizar los días de retención de eventos de dispositivo a nube de IoT Hub como 3 días

az iot hub update -n MyIotHub --retention-day 3

Actualización de la configuración de mensajería de nube a dispositivo de IoT Hub

az iot hub update --name MyIotHub --c2d-max-delivery-count 30 --c2d-ttl 5

Actualización de la configuración de cola de comentarios de IoT Hub

az iot hub update --name MyIoTHub --feedback-max-delivery-count 20 --feedback-lock-duration 100 --feedback-ttl 4

Actualice la configuración de carga de archivos de IoT Hub y asigne una identidad administrada al usuario para la carga de archivos.

az iot hub update -n MyIoTHub --fileupload-sas-ttl 5 --fileupload-storage-auth-type identityBased --fileupload-storage-identity [system]

Actualizar la configuración de notificación de carga de archivos de IoT Hub y la duración del bloqueo de cola

az iot hub update -n MyIoTHub --fileupload-notification-max-delivery-count 50 --fileupload-notification-ttl 48 --fileupload-notifications --fileupload-notification-lock-duration 10

Actualización de la autenticación local de IoT Hub, la SAS del dispositivo y la configuración de SAS del módulo

az iot hub update -n MyIoTHub --disable-local-auth --disable-device-sas false --disable-module-sas true

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.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--c2d-max-delivery-count --cdd

El número de veces que el centro de IoT intentará entregar un mensaje de nube a dispositivo a un dispositivo, entre 1 y 100.

--c2d-ttl --ct

La cantidad de tiempo que un mensaje está disponible para que el dispositivo lo consuma antes de que IoT Hub expire, entre 1 y 48 horas.

--dds --disable-device-sas

Valor booleano que indica si se deben deshabilitar o no todos los dispositivos (incluidos los dispositivos perimetrales, pero los módulos excluidos) claves SAS con ámbito para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--disable-local-auth --dla

Valor booleano que indica si se deben deshabilitar o no claves SAS con ámbito de IoT Hub para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--disable-module-sas --dms

Valor booleano que indica si se deben deshabilitar o no claves SAS con ámbito de módulo para la autenticación.

Propiedad	Valor
Valores aceptados:	false, true

--fc --fileupload-storage-container-name

Nombre del contenedor raíz donde se cargan los archivos. El contenedor no debe existir, pero debe ser creatable mediante el parámetro connectionString especificado.

--fcs --fileupload-storage-connectionstring

Cadena de conexión de la cuenta de Azure Storage a la que se cargan los archivos.

--fd --feedback-max-delivery-count

Número de veces que el centro de IoT intenta entregar un mensaje en la cola de comentarios, entre 1 y 100.

--feedback-lock-duration --fld

Duración del bloqueo de la cola de comentarios, entre 5 y 300 segundos.

--feedback-ttl --ft

Período de tiempo durante el cual el centro de IoT mantendrá los comentarios para la expiración o entrega de mensajes de nube a dispositivo, entre 1 y 48 horas.

--fileupload-notification-lock-duration --fnld

Duración del bloqueo de la cola de notificaciones de carga de archivos, entre 5 y 300 segundos.

--fileupload-notification-max-delivery-count --fnd

Número de veces que el centro de IoT intentará entregar un mensaje de notificación de archivo, entre 1 y 100.

--fileupload-notification-ttl --fnt

La cantidad de tiempo que una notificación de carga de archivos está disponible para que el servicio lo consuma antes de que IoT Hub expire, entre 1 y 48 horas.

--fileupload-notifications --fn

Valor booleano que indica si se va a registrar información sobre los archivos cargados en el punto de conexión de IoT Hub messages/servicebound/filenotifications.

Propiedad	Valor
Valores aceptados:	false, true

--fileupload-sas-ttl --fst

La cantidad de tiempo que un URI de SAS generado por IoT Hub es válido antes de que expire, entre 1 y 24 horas.

--fileupload-storage-auth-type --fsa

Tipo de autenticación de la cuenta de Azure Storage a la que se cargan los archivos.

Propiedad	Valor
Valores aceptados:	identityBased, keyBased

--fileupload-storage-identity --fsi

Identidad administrada que se va a usar para la autenticación de carga de archivos. Use "[system]" para hacer referencia a la identidad administrada asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad administrada asignada por el usuario.

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	False

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--min-tls-version --mintls

Especifique la versión mínima de TLS que se va a admitir para este centro. Se puede establecer en "1.0" o "1.2". Por ejemplo, la versión mínima de TLS establecida en "1.2" da como resultado que los clientes que usan una versión tls inferior a la 1.2 se rechacen.

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--ns-identity-id

Identificador de recurso de identidad administrada por el usuario para acceder al espacio de nombres del Registro de dispositivos.

--rd --retention-day

Especifica cuánto tiempo mantendrá este centro de IoT eventos de dispositivo a nube, entre 1 y 7 días.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--sku

Plan de tarifa para Azure IoT Hub. Tenga en cuenta que solo se permite una instancia gratuita de IoT Hub (F1) en cada suscripción. Se producirá una excepción si las instancias libres superan una.

Propiedad	Valor
Valores aceptados:	B1, B2, B3, F1, GEN2, S1, S2, S3

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--tags

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

--unit

Unidades en ioT Hub.

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az iot hub wait

Espere hasta que se complete una operación en una instancia de IoT Hub.

az iot hub wait [--created]
                [--custom]
                [--deleted]
                [--exists]
                [--ids]
                [--interval]
                [--name]
                [--resource-group]
                [--subscription]
                [--timeout]
                [--updated]

Ejemplos

Espere hasta que se cree una instancia de IoT Hub existente

az iot hub wait -n MyIoTHub --created

Espere hasta que se elimine una instancia de IoT Hub.

az iot hub wait -n MyIoTHub --deleted

Espere hasta que una instancia de IoT Hub existente tenga un estado activo

az iot hub wait -n MyIoTHub --custom "properties.state=='Active'"

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.

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments

--deleted

Espere hasta que se elimine.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

--exists

Espere hasta que exista el recurso.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--interval

Intervalo de sondeo en segundos.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	30

--name -n

Nombre de IoT Hub.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--resource-group -g

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

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad	Valor
Grupo de parámetros:	Resource Id Arguments

--timeout

Espera máxima en segundos.

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	3600

--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Propiedad	Valor
Grupo de parámetros:	Wait Condition Arguments
Valor predeterminado:	False

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False