Compartir a través de


az iot hub device-identity

Nota:

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

Administre los dispositivos IoT.

Comandos

Nombre Description Tipo Estado
az iot hub device-identity children

Administrar relaciones de dispositivos secundarios para dispositivos IoT Edge.

Extensión GA
az iot hub device-identity children add

Agregue dispositivos como elementos secundarios a un dispositivo perimetral de destino.

Extensión GA
az iot hub device-identity children list

Genera la colección de dispositivos secundarios asignados.

Extensión GA
az iot hub device-identity children remove

Quite los dispositivos secundarios de un dispositivo perimetral de destino.

Extensión GA
az iot hub device-identity connection-string

Administrar la cadena de conexión del dispositivo IoT.

Extensión GA
az iot hub device-identity connection-string show

Mostrar un cadena de conexión de dispositivo ioT Hub determinado.

Extensión GA
az iot hub device-identity create

Cree un dispositivo en una instancia de IoT Hub.

Extensión GA
az iot hub device-identity delete

Elimine un dispositivo ioT Hub.

Extensión 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.

Extensión GA
az iot hub device-identity import

Importe identidades de dispositivo a IoT Hub desde un blob de contenedor de almacenamiento.

Extensión GA
az iot hub device-identity list

Enumeración de dispositivos en una instancia de IoT Hub.

Extensión GA
az iot hub device-identity parent

Administrar las relaciones de dispositivos primarios para dispositivos IoT.

Extensión GA
az iot hub device-identity parent set

Establezca el dispositivo primario de un dispositivo de destino.

Extensión GA
az iot hub device-identity parent show

Obtenga el dispositivo primario de un dispositivo de destino.

Extensión GA
az iot hub device-identity renew-key

Renueve las claves de destino de un dispositivo de IoT Hub con autenticación sas.

Extensión GA
az iot hub device-identity show

Obtenga los detalles de un dispositivo ioT Hub.

Extensión GA
az iot hub device-identity update

Actualice un dispositivo IoT Hub.

Extensión GA

az iot hub device-identity create

Cree un dispositivo en una instancia de IoT Hub.

Al usar el método de autenticación de shared_private_key (también conocido como claves simétricas), si no se proporciona ninguna clave personalizada, el servicio los generará para el dispositivo.

Si se proporciona un ámbito de dispositivo para un dispositivo perimetral, el valor se convertirá automáticamente en un ámbito primario.

az iot hub device-identity create --device-id
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--device-scope]
                                  [--edge-enabled {false, true}]
                                  [--hub-name]
                                  [--login]
                                  [--od]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--sta {disabled, enabled}]
                                  [--star]
                                  [--valid-days]

Ejemplos

Cree un dispositivo IoT habilitado para Edge con autorización predeterminada (clave privada compartida).

az iot hub device-identity create -n {iothub_name} -d {device_id} --ee

Cree un dispositivo IoT con autorización de certificado autofirmado, genere un certificado válido durante 10 días y, a continuación, use su huella digital.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --valid-days 10

Cree un dispositivo IoT con autorización de certificado autofirmado, genere un certificado de expiración predeterminada (365 días) y la salida al directorio de destino.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --output-dir /path/to/output

Cree un dispositivo IoT con autorización de certificado autofirmado y proporcione explícitamente huellas digitales principales y secundarias.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_thumbprint --ptp {thumbprint_1} --stp {thumbprint_2}

Cree un dispositivo IoT con autorización de entidad de certificación raíz con el estado y el motivo deshabilitados.

az iot hub device-identity create -n {iothub_name} -d {device_id} --am x509_ca --status disabled --status-reason 'for reasons'

Cree un dispositivo IoT con un ámbito de dispositivo.

az iot hub device-identity create -n {iothub_name} -d {device_id} --device-scope 'ms-azure-iot-edge://edge0-123456789123456789'

Parámetros requeridos

--device-id -d

Id. de dispositivo de destino.

Parámetros opcionales

--am --auth-method

El método de autorización con el que se va a crear una entidad.

Valores aceptados: shared_private_key, x509_ca, x509_thumbprint
Valor predeterminado: shared_private_key
--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>.

Valores aceptados: key, login
Valor predeterminado: key
--device-scope

El ámbito del dispositivo. En el caso de los dispositivos perimetrales, esto se genera automáticamente e inmutable. En el caso de los dispositivos hoja, establezca esta opción para crear una relación secundaria o primaria.

--edge-enabled --ee

Marca que indica la habilitación del borde.

Valores aceptados: false, true
Valor predeterminado: False
--hub-name -n

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

--login -l

Este comando admite una entidad cadena de conexión 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.

--od --output-dir

Genere un certificado autofirmado y use su huella digital. Salida al directorio de destino especificado.

--pk --primary-key

Clave de acceso compartido simétrica principal almacenada en formato base64.

--primary-thumbprint --ptp

Huella digital de certificado autofirmado que se usará para la huella digital principal.

--resource-group -g

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

--secondary-key --sk

Clave de acceso compartido simétrica secundaria almacenada en formato base64.

--secondary-thumbprint --stp

Huella digital de certificado autofirmado que se usará para la huella digital secundaria.

--sta --status

Establezca el estado del dispositivo tras la creación.

Valores aceptados: disabled, enabled
Valor predeterminado: enabled
--star --status-reason

Descripción del estado del dispositivo.

--valid-days --vd

Genere un certificado autofirmado y use su huella digital. Válido para el número de días especificado. Valor predeterminado: 365.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot hub device-identity delete

Elimine un dispositivo ioT Hub.

az iot hub device-identity delete --device-id
                                  [--auth-type {key, login}]
                                  [--etag]
                                  [--hub-name]
                                  [--login]
                                  [--resource-group]

Parámetros requeridos

--device-id -d

Id. de dispositivo de destino.

Parámetros opcionales

--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>.

Valores aceptados: key, login
Valor predeterminado: key
--etag -e

Etag o etiqueta de entidad correspondiente al último estado del recurso. Si no se proporciona ninguna etag, se usa el valor '*'.

--hub-name -n

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

--login -l

Este comando admite una entidad cadena de conexión 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.

--resource-group -g

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

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot hub device-identity export

Exporte todas las identidades de dispositivo de una instancia de IoT Hub a un contenedor de blobs de Azure Storage.

El blob de salida que contiene identidades de dispositivo es un archivo de texto denominado "devices.txt".

Permisos necesarios: directiva de acceso compartido de IoT Hub que admite "Lectura del registro y escritura del Registro" O una entidad de seguridad con el rol "Colaborador de datos de IoT Hub" en IoT Hub.

Los parámetros de nombre de la cuenta de almacenamiento y de contenedor de blobs solo se pueden usar cuando la cuenta de almacenamiento está en la misma suscripción que ioT Hub de entrada. Para la entrada del URI de SAS del contenedor de blobs en línea, revise las reglas de entrada de su entorno.

Para obtener más información, vea https://aka.ms/iothub-device-exportimport.

az iot hub device-identity export [--auth-type {key, login}]
                                  [--bc]
                                  [--bcu]
                                  [--hub-name]
                                  [--identity]
                                  [--ik {false, true}]
                                  [--login]
                                  [--resource-group]
                                  [--sa]

Ejemplos

Exporte todas las identidades de dispositivo a un contenedor de blobs configurado e incluya claves de dispositivo. El nombre del contenedor de blobs y el nombre de la cuenta de almacenamiento se proporcionan como parámetros para el comando.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name}

Exporte todas las identidades de dispositivo a un contenedor de blobs configurado e incluya claves de dispositivo. Usa un ejemplo de URI de SAS insertado.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices?sv=2019-02-02&st=2020-08-23T22%3A35%3A00Z&se=2020-08-24T22%3A35%3A00Z&sr=c&sp=rwd&sig=VrmJ5sQtW3kLzYg10VqmALGCp4vtYKSLNjZDDJBSh9s%3D'

Exporte todas las identidades de dispositivo a un contenedor de blobs configurado mediante una ruta de acceso de archivo que contiene el URI de SAS.

az iot hub device-identity export -n {iothub_name} --bcu {sas_uri_filepath}

Exporte todas las identidades de dispositivo a un contenedor de blobs configurado e incluya claves de dispositivo. Usa la identidad asignada por el sistema que tiene roles colaborador de datos de Storage Blob para la cuenta de almacenamiento. El nombre del contenedor de blobs y el nombre de la cuenta de almacenamiento se proporcionan como parámetros para el comando.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity [system]

Exporte todas las identidades de dispositivo a un contenedor de blobs configurado e incluya claves de dispositivo. Usa la identidad asignada por el sistema que tiene roles colaborador de datos de Storage Blob para la cuenta de almacenamiento. El URI del contenedor de blobs no necesita el token de SAS de blob.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity [system]

Exporte todas las identidades de dispositivo a un contenedor de blobs configurado e incluya claves de dispositivo. Usa la identidad administrada asignada por el usuario que tiene el rol Colaborador de datos de Storage Blob para la cuenta de almacenamiento. El nombre del contenedor de blobs y el nombre de la cuenta de almacenamiento se proporcionan como parámetros para el comando.

az iot hub device-identity export -n {iothub_name} --ik --bc {blob_container_name} --sa {storage_account_name} --identity {managed_identity_resource_id}

Exporte todas las identidades de dispositivo a un contenedor de blobs configurado e incluya claves de dispositivo. Usa la identidad administrada asignada por el usuario que tiene el rol Colaborador de datos de Storage Blob para la cuenta de almacenamiento. El URI del contenedor de blobs no necesita el token de SAS de blob.

az iot hub device-identity export -n {iothub_name} --ik --bcu 'https://mystorageaccount.blob.core.windows.net/devices' --identity {managed_identity_resource_id}

Parámetros opcionales

--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>.

Valores aceptados: key, login
Valor predeterminado: key
--bc --blob-container

Este contenedor de blobs se usa para generar el estado del trabajo de importación de identidad del dispositivo y los resultados. El parámetro se omite cuando se proporciona blob_container_uri. El acceso de escritura, lectura y eliminación es necesario para este contenedor de blobs.

--bcu --blob-container-uri

URI de firma de acceso compartido de blobs con acceso de escritura, lectura y eliminación a un contenedor de blobs. Se usa para generar el estado del trabajo y los resultados. Nota: cuando se usa la autenticación basada en identidades, se sigue necesitando un URI de https://, pero no es necesario ningún token de SAS. La entrada de este argumento puede estar insertada o desde una ruta de acceso de archivo.

--hub-name -n

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

--identity

Tipo de identidad administrada para determinar si se usa la identidad administrada asignada por el sistema o la identidad administrada asignada por el usuario. Para la identidad administrada asignada por el sistema, use [system]. En el caso de la identidad administrada asignada por el usuario, proporcione el identificador de recurso de identidad administrada asignada por el usuario. Esta identidad requiere roles de colaborador de datos de Storage Blob para la cuenta de almacenamiento.

--ik --include-keys

Si se establece, las claves se exportan normalmente. De lo contrario, las claves se establecen en NULL en la salida de exportación.

Valores aceptados: false, true
Valor predeterminado: False
--login -l

Este comando admite una entidad cadena de conexión 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.

--resource-group -g

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

--sa --storage-account

Nombre de la cuenta de Azure Storage que contiene el contenedor de blobs de salida. El parámetro se omite cuando se proporciona blob_container_uri. Se requiere acceso de escritura, lectura y eliminación.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot hub device-identity import

Importe identidades de dispositivo a IoT Hub desde un blob de contenedor de almacenamiento.

El archivo de entrada esperado que contiene identidades de dispositivo debe denominarse "devices.txt". El archivo de registro de salida "importErrors.log" está vacío cuando la importación se realiza correctamente y contiene registros de errores en caso de error de importación.

Permisos necesarios: directiva de acceso compartido de IoT Hub que admite "Lectura del registro y escritura del Registro" O una entidad de seguridad con el rol "Colaborador de datos de IoT Hub" en IoT Hub.

Los parámetros de nombre de la cuenta de almacenamiento y de contenedor de blobs solo se pueden usar cuando la cuenta de almacenamiento está en la misma suscripción que ioT Hub de entrada. Para la entrada del URI de SAS del contenedor de blobs en línea, revise las reglas de entrada de su entorno.

Para obtener más información, vea https://aka.ms/iothub-device-exportimport.

az iot hub device-identity import [--auth-type {key, login}]
                                  [--hub-name]
                                  [--ibc]
                                  [--ibcu]
                                  [--identity]
                                  [--input-storage-account]
                                  [--login]
                                  [--obc]
                                  [--obcu]
                                  [--osa]
                                  [--resource-group]

Ejemplos

Importe todas las identidades de dispositivo desde un blob proporcionando parámetros de comando para el contenedor de blobs de entrada y la cuenta de almacenamiento, así como el contenedor de blobs de salida y la cuenta de almacenamiento.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name}

Importe todas las identidades de dispositivo desde un blob mediante un URI de SAS insertado.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri}

Importe todas las identidades de dispositivo desde un blob mediante una ruta de acceso de archivo que contenga el URI de SAS.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri_filepath} --obcu {output_sas_uri_filepath}

Importe todas las identidades de dispositivo de un blob mediante una identidad asignada por el sistema que tenga roles colaborador de datos de Storage Blob para ambas cuentas de almacenamiento. El contenedor de blobs de entrada y la cuenta de almacenamiento, así como el contenedor de blobs de salida y la cuenta de almacenamiento se proporcionan como parámetros para el comando.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity [system]

Importe todas las identidades de dispositivo de un blob mediante una identidad asignada por el sistema que tenga roles colaborador de datos de Storage Blob para ambas cuentas de almacenamiento. El URI del contenedor de blobs no necesita el token de SAS de blob.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity [system]

Importe todas las identidades de dispositivo de un blob mediante una identidad administrada asignada por el usuario que tenga roles colaborador de datos de Storage Blob para ambas cuentas de almacenamiento. El contenedor de blobs de entrada y la cuenta de almacenamiento, así como el contenedor de blobs de salida y la cuenta de almacenamiento se proporcionan como parámetros para el comando.

az iot hub device-identity import -n {iothub_name} --ibc {input_blob_container_name} --isa {input_storage_account_name} --obc {output_blob_container_name} --osa {output_storage_account_name} --identity {managed_identity_resource_id}

Importe todas las identidades de dispositivo de un blob mediante una identidad administrada asignada por el usuario que tenga roles colaborador de datos de Storage Blob para ambas cuentas de almacenamiento. El URI del contenedor de blobs no necesita el token de SAS de blob.

az iot hub device-identity import -n {iothub_name} --ibcu {input_sas_uri} --obcu {output_sas_uri} --identity {managed_identity_resource_id}

Parámetros opcionales

--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>.

Valores aceptados: key, login
Valor predeterminado: key
--hub-name -n

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

--ibc --input-blob-container

Este contenedor de blobs almacena el archivo que define las operaciones que se van a realizar en el registro de identidades. El parámetro se omite cuando se proporciona input_blob_container_uri. El acceso de lectura es necesario para este contenedor de blobs.

--ibcu --input-blob-container-uri

URI de firma de acceso compartido de blobs con acceso de lectura a un contenedor de blobs. Este blob contiene las operaciones que se realizarán en el registro de identidad. Nota: cuando se usa la autenticación basada en identidades, se sigue necesitando un URI de https://, pero no es necesario ningún token de SAS. La entrada de este argumento puede estar insertada o desde una ruta de acceso de archivo.

--identity

Tipo de identidad administrada para determinar si se usa la identidad administrada asignada por el sistema o la identidad administrada asignada por el usuario. Para la identidad administrada asignada por el sistema, use [system]. En el caso de la identidad administrada asignada por el usuario, proporcione el identificador de recurso de identidad administrada asignada por el usuario. Esta identidad requiere un rol colaborador de datos de Storage Blob para el rol de colaborador y cuenta de almacenamiento de destino para IoT Hub.

--input-storage-account --isa

Nombre de la cuenta de Azure Storage que contiene el contenedor de blobs de entrada. Solo es necesario cuando no se proporciona input_blob_container_uri. Se requiere acceso de lectura.

--login -l

Este comando admite una entidad cadena de conexión 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.

--obc --output-blob-container

Este contenedor de blobs se usa para generar el estado del trabajo de importación de identidad del dispositivo y los resultados. Solo es necesario cuando no se proporciona input_blob_container_uri. El acceso de escritura es necesario para este contenedor de blobs.

--obcu --output-blob-container-uri

URI de firma de acceso compartido de blobs con acceso de escritura a un contenedor de blobs. Se usa para generar el estado del trabajo y los resultados. Nota: al usar la autenticación basada en identidades, todavía se requiere un URI de https:// sin el token de SAS. La entrada de este argumento puede estar insertada o desde una ruta de acceso de archivo.

--osa --output-storage-account

Nombre de la cuenta de Azure Storage que contiene el contenedor de blobs de salida. El parámetro se omite cuando se proporciona output_blob_container_uri. Se requiere acceso de escritura.

--resource-group -g

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

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot hub device-identity list

Enumeración de dispositivos en una instancia de IoT Hub.

Este comando es un alias para az iot hub device-twin list, que es muy recomendable sobre este comando. En el futuro, este az iot hub device-identity list comando se puede modificar o dejar de usar.

az iot hub device-identity list [--auth-type {key, login}]
                                [--edge-enabled {false, true}]
                                [--hub-name]
                                [--login]
                                [--resource-group]
                                [--top]

Parámetros opcionales

--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>.

Valores aceptados: key, login
Valor predeterminado: key
--edge-enabled --ee

Marca que indica la habilitación del borde.

Valores aceptados: false, true
Valor predeterminado: False
--hub-name -n

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

--login -l

Este comando admite una entidad cadena de conexión 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.

--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. Use -1 para ilimitado.

Valor predeterminado: 1000
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot hub device-identity renew-key

Renueve las claves de destino de un dispositivo de IoT Hub con autenticación sas.

az iot hub device-identity renew-key --device-id
                                     --hub-name
                                     --key-type {primary, secondary, swap}
                                     [--auth-type {key, login}]
                                     [--etag]
                                     [--login]
                                     [--resource-group]

Ejemplos

Renueve la clave principal.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt primary

Cambie las claves principal y secundaria.

az iot hub device-identity renew-key -d {device_id} -n {iothub_name} --kt swap

Parámetros requeridos

--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.

--key-type --kt

Tipo de clave de destino que se va a regenerar.

Valores aceptados: primary, secondary, swap

Parámetros opcionales

--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>.

Valores aceptados: key, login
Valor predeterminado: key
--etag -e

Etag o etiqueta de entidad correspondiente al último estado del recurso. Si no se proporciona ninguna etag, se usa el valor '*'.

--login -l

Este comando admite una entidad cadena de conexión 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.

--resource-group -g

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

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot hub device-identity show

Obtenga los detalles de un dispositivo ioT Hub.

az iot hub device-identity show --device-id
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--login]
                                [--resource-group]

Parámetros requeridos

--device-id -d

Id. de dispositivo de destino.

Parámetros opcionales

--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>.

Valores aceptados: key, login
Valor predeterminado: key
--hub-name -n

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

--login -l

Este comando admite una entidad cadena de conexión 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.

--resource-group -g

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

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot hub device-identity update

Actualice un dispositivo IoT Hub.

Use --set seguido de asignaciones de propiedades para actualizar un dispositivo. Aproveche los parámetros devueltos de "iot hub device-identity show".

az iot hub device-identity update --device-id
                                  [--add]
                                  [--am {shared_private_key, x509_ca, x509_thumbprint}]
                                  [--auth-type {key, login}]
                                  [--edge-enabled {false, true}]
                                  [--etag]
                                  [--force-string]
                                  [--hub-name]
                                  [--login]
                                  [--pk]
                                  [--primary-thumbprint]
                                  [--remove]
                                  [--resource-group]
                                  [--secondary-key]
                                  [--secondary-thumbprint]
                                  [--set]
                                  [--sta {disabled, enabled}]
                                  [--star]

Ejemplos

Activación de las funcionalidades perimetrales para el dispositivo

az iot hub device-identity update -d {device_id} -n {iothub_name} --set capabilities.iotEdge=true

Active las funcionalidades perimetrales para el dispositivo mediante el argumento de conveniencia.

az iot hub device-identity update -d {device_id} -n {iothub_name} --ee

Deshabilitar el estado del dispositivo

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled

Deshabilite el estado del dispositivo mediante el argumento de conveniencia.

az iot hub device-identity update -d {device_id} -n {iothub_name} --status disabled

En un comando

az iot hub device-identity update -d {device_id} -n {iothub_name} --set status=disabled capabilities.iotEdge=true

Parámetros requeridos

--device-id -d

Id. de dispositivo de destino.

Parámetros opcionales

--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>.

Valor predeterminado: []
--am --auth-method

El método de autorización con el que se va a crear una entidad.

Valores aceptados: shared_private_key, x509_ca, x509_thumbprint
--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>.

Valores aceptados: key, login
Valor predeterminado: key
--edge-enabled --ee

Marca que indica la habilitación del borde.

Valores aceptados: false, true
--etag -e

Etag o etiqueta de entidad correspondiente al último estado del recurso. Si no se proporciona ninguna etag, se usa el valor '*'.

--force-string

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

Valor predeterminado: False
--hub-name -n

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

--login -l

Este comando admite una entidad cadena de conexión 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.

--pk --primary-key

Clave de acceso compartido simétrica principal almacenada en formato base64.

--primary-thumbprint --ptp

Huella digital de certificado autofirmado que se usará para la huella digital principal.

--remove

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

Valor predeterminado: []
--resource-group -g

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

--secondary-key --sk

Clave de acceso compartido simétrica secundaria almacenada en formato base64.

--secondary-thumbprint --stp

Huella digital de certificado autofirmado que se usará para la huella digital secundaria.

--set

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

Valor predeterminado: []
--sta --status

Establezca el estado del dispositivo tras la creación.

Valores aceptados: disabled, enabled
--star --status-reason

Descripción del estado del dispositivo.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

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

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.