Compartir a través de

az iot device registration

  • Vista previa
  • Referencia

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 instalará automáticamente la primera vez que ejecute un comando az iot device registration . Obtenga más información sobre las extensiones.

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

Administrar registros de dispositivos IoT para ioT Device Provisioning Service.

Use az iot dps enrollment registration o az iot dps enrollment-group registration para ver y eliminar registros.

Comandos

Nombre Description Tipo Estado
az iot device registration create

Registre un dispositivo IoT con el servicio IoT Device Provisioning.

 Extensión Vista previa

az iot device registration create

Vista previa

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

Registre un dispositivo IoT con el servicio IoT Device Provisioning.

Se admiten los siguientes mecanismos de atestación:

  • Clave simétrica
  • Certificado x509 Si usa métodos de autenticación x509, se deben proporcionar los archivos de certificado y clave (y la frase de contraseña si es necesario).
az iot device registration create --registration-id
                                  [--auth-type {key, login}]
                                  [--certificate-file-path]
                                  [--ck]
                                  [--dps-name]
                                  [--enrollment-group-id]
                                  [--host]
                                  [--id-scope]
                                  [--key]
                                  [--key-file-path]
                                  [--login]
                                  [--pass]
                                  [--payload]
                                  [--resource-group]

Ejemplos

Registre un dispositivo IoT mediante una inscripción individual.

az iot device registration create -n {dps_name} --rid {registration_id}

Registre un dispositivo IoT mediante una inscripción de grupo.

az iot device registration create -n {dps_name} --rid {registration_id} --gid {group_enrollment_id}

Registre un dispositivo IoT mediante una inscripción individual, el ámbito de identificador del servicio Device Provisioning y una clave simétrica determinada. Esto omitirá la recuperación del ámbito de identificador y la clave simétrica de inscripción individal.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

Registre un dispositivo IoT mediante una inscripción de grupo, el ámbito de identificador del servicio Device Provisioning y una clave simétrica de grupo de inscripción determinada. Esto omitirá la recuperación del ámbito de identificador y la clave simétrica del grupo de inscripción. La clave simétrica usada para el registro de dispositivos se calculará a partir de la clave simétrica especificada.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --gid {group_enrollment_id} --key {symmetric_key} --ck

Registre un dispositivo IoT mediante una inscripción de grupo, el ámbito de identificador del servicio Device Provisioning y una clave simétrica determinada. Esto omitirá la recuperación del ámbito de identificador. Tenga en cuenta que, dado que la clave simétrica debe ser la clave de dispositivo calculada, no se necesita el identificador del grupo de inscripción.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

Registre un dispositivo IoT mediante una inscripción individual, el ámbito de identificador del servicio Device Provisioning y los archivos de certificado y clave especificados. Esto omitirá la recuperación del ámbito de identificador.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

Registre un dispositivo IoT mediante una inscripción individual, el ámbito del identificador del servicio Device Provisioning y los archivos de certificado y clave y la frase de contraseña para el archivo de clave. Esto omitirá la recuperación del ámbito de identificador.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file} --pass {passphrase}

Registre un dispositivo IoT mediante una inscripción de grupo, el ámbito de identificador del servicio Device Provisioning y los archivos de certificado y clave especificados. Esto omitirá la recuperación del ámbito de identificador. Tenga en cuenta que el identificador de inscripción de grupo no es necesario para las atestaciones x509 y el asunto del archivo de certificado es el identificador de registro.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

Parámetros requeridos

--registration-id --rid

Identificador de registro de dispositivo o identificador de inscripción individual.

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
--certificate-file-path --cp

Ruta de acceso al archivo PEM de certificado. Necesario para los registros x509.

--ck --compute-key

Marca para indicar que la clave simétrica para el registro del dispositivo debe calcularse desde la clave especificada con --symmetric-key.

Valor predeterminado: False
--dps-name -n

Nombre del servicio Azure IoT Hub Device Provisioning. Obligatorio si --login no se proporciona o no se proporcionan argumentos authenticaton y no se proporciona el ámbito --id-scope.

--enrollment-group-id --gid --group-id

Identificador del grupo de inscripción. Solo es necesario para recuperar argumentos de autenticación.

--host --provisioning-host

Punto de conexión que apunta al host de aprovisionamiento que se va a usar.

Valor predeterminado: global.azure-devices-provisioning.net
--id-scope --scope

Ámbito de identificador del servicio Azure IoT Hub Device Provisioning. Si se proporciona con argumentos de autenticación, evitará el inicio de sesión de sesión.

--key --symmetric-key

Clave de acceso compartido simétrica para el registro del dispositivo.

--key-file-path --kp

Ruta de acceso al archivo PEM de clave. Necesario para los registros x509.

--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 proporcionan argumentos --dps-name o authenticaton y --id-scope no se proporcionan.

--pass --passphrase

Frase de contraseña para el certificado.

--payload

Carga de asignación personalizada como JSON. Específicamente para su uso con directivas de asignación personalizadas mediante Azure Functions.

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