Compartir vía

az iot dps

  • Referencia

Nota

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. Más información sobre las extensiones.

Administración del servicio Azure IoT Hub Device Provisioning.

Comandos

Nombre Description Tipo Estado
az iot dps certificate

Administrar certificados para una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps certificate create

Cree o cargue un certificado en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps certificate delete

Elimine un certificado en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps certificate generate-verification-code

Genere un código de verificación para un certificado en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps certificate list

Enumere todos los certificados contenidos en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps certificate show

Mostrar información sobre un certificado determinado en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps certificate update

Actualice un certificado en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps certificate verify

Compruebe un certificado en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps compute-device-key

Genere una clave SAS de dispositivo derivada.

 Extensión Obsolescente
az iot dps connection-string

Administrar cadenas de conexión para una instancia de Azure IoT Hub Device Provisioning Service.

 Extensión GA
az iot dps connection-string show

Muestra las cadenas de conexión para los servicios de Device Provisioning especificados mediante el nombre y la clave de directiva especificados.

 Extensión GA
az iot dps create

Cree una instancia del servicio Azure IoT Hub Device Provisioning.

 Núcleo GA
az iot dps delete

Elimine una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps enrollment

Administre las inscripciones de dispositivos individuales en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment-group

Administrar grupos de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment-group compute-device-key

Genere una clave SAS de dispositivo derivada para un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment-group create

Cree un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment-group delete

Elimine un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment-group list

Enumera los grupos de inscripciones en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment-group registration

Administrar registros de dispositivos del lado del servicio para un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment-group registration delete

Elimine un registro de dispositivos para un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment-group registration list

Enumere los registros de dispositivos de un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment-group registration show

Obtenga un registro de dispositivos para un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment-group show

Obtenga los detalles de un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment-group update

Actualice un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment create

Cree una inscripción de dispositivos individuales en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment delete

Elimine una inscripción de dispositivos individuales en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment list

Enumere las inscripciones de dispositivos individuales en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment registration

Administrar registros de dispositivos del lado del servicio para una inscripción individual en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment registration delete

Elimine un registro de dispositivos para una inscripción individual en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment registration show

Obtenga un registro de dispositivos para una inscripción individual en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment show

Obtenga los detalles de inscripción de dispositivos individuales en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps enrollment update

Actualice una inscripción de dispositivos individuales en un servicio Azure IoT Hub Device Provisioning.

 Extensión GA
az iot dps linked-hub

Administre ioT Hubs vinculados en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps linked-hub create

Cree un centro de IoT vinculado en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps linked-hub delete

Actualice un centro de IoT vinculado en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps linked-hub list

Enumere todos los centros de IoT vinculados en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps linked-hub show

Muestra los detalles de un centro de IoT vinculado en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps linked-hub update

Actualice un centro de IoT vinculado en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps list

Enumere las instancias del servicio Azure IoT Hub Device Provisioning.

 Núcleo GA
az iot dps policy

Administrar directivas de acceso compartido para una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps policy create

Cree una nueva directiva de acceso compartido en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps policy delete

Elimine una directiva de acceso compartido en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps policy list

Enumere todas las directivas de acceso compartido en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps policy show

Mostrar detalles de las directivas de acceso compartido en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps policy update

Actualice una directiva de acceso compartido en una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps registration

Administrar registros de dispositivos para un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión Obsolescente
az iot dps registration delete

Elimine un registro de dispositivos en un servicio Azure IoT Hub Device Provisioning.

 Extensión Obsolescente
az iot dps registration list

Enumere los registros de dispositivos de un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión Obsolescente
az iot dps registration show

Obtenga un registro de dispositivos para un grupo de inscripción en un servicio Azure IoT Hub Device Provisioning.

 Extensión Obsolescente
az iot dps show

Obtenga los detalles de una instancia de Azure IoT Hub Device Provisioning Service.

 Núcleo GA
az iot dps update

Actualice una instancia del servicio Azure IoT Hub Device Provisioning.

 Núcleo GA

az iot dps compute-device-key

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use "iot dps enrollment-group compute-device-key" en su lugar.

Genere una clave SAS de dispositivo derivada.

Genere una clave de dispositivo derivada para un grupo de inscripción de DPS.

az iot dps compute-device-key --registration-id
                              [--auth-type {key, login}]
                              [--dps-name]
                              [--eid]
                              [--key]
                              [--login]
                              [--resource-group]

Ejemplos

Calcule la clave de dispositivo con la clave simétrica especificada.

az iot dps compute-device-key --key {enrollement_group_symmetric_key} --registration-id {registration_id}

Calcule la clave de dispositivo con el grupo de inscripción especificado.

az iot dps compute-device-key -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --registration-id {registration_id}

Parámetros requeridos

--registration-id

Identificador del registro de dispositivos.

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 iotdps-data-auth-type={auth-type-value}.

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

Nombre o nombre de host del servicio Azure IoT Hub Device Provisioning. Obligatorio si no se proporciona --login.

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

Identificador del grupo de inscripción.

--key --symmetric-key

Clave de acceso compartido simétrica para el grupo de inscripción. Esto omite el registro de Device Provisioning Service 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 del identificador de registro.

--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 proporciona una cadena de conexión de entidad y un nombre, la cadena de conexión tiene prioridad. Obligatorio si no se proporciona --dps-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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az iot dps create

Editar

Cree una instancia del servicio Azure IoT Hub Device Provisioning.

Para obtener una introducción al servicio Azure IoT Hub Device Provisioning, consulte https://learn.microsoft.com/azure/iot-dps/about-iot-dps.

az iot dps create --name
                  --resource-group
                  [--edr {false, true}]
                  [--location]
                  [--sku {S1}]
                  [--tags]
                  [--unit]

Ejemplos

Cree un servicio Azure IoT Hub Device Provisioning con el plan de tarifa estándar S1, en la región del grupo de recursos.

az iot dps create --name MyDps --resource-group MyResourceGroup

Cree un servicio Azure IoT Hub Device Provisioning con el plan de tarifa estándar S1, en la región "eastus".

az iot dps create --name MyDps --resource-group MyResourceGroup --location eastus

Cree un servicio De aprovisionamiento de dispositivos de Azure IoT Hub con la residencia de datos aplicada. Esto deshabilitará la recuperación ante desastres entre regiones.

az iot dps create --name MyDps --resource-group MyResourceGroup --edr

Parámetros requeridos

--name -n

Nombre del servicio IoT Hub Device Provisioning.

--resource-group -g

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

Parámetros opcionales

--edr --enforce-data-residency

Aplique la residencia de datos para este servicio IoT Hub Device Provisioning mediante la deshabilitación de la recuperación ante desastres entre pares geográficos. 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/dpsdr.

Valores aceptados: false, true
--location -l

Ubicación del servicio IoT Hub Device Provisioning. El valor predeterminado es la ubicación del grupo de recursos de destino.

--sku

Plan de tarifa del servicio IoT Hub Device Provisioning.

Valores aceptados: S1
Valor predeterminado: S1
--tags

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

--unit

Unidades del servicio IoT Hub Device Provisioning.

Valor predeterminado: 1
Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az iot dps delete

Editar

Elimine una instancia de Azure IoT Hub Device Provisioning Service.

az iot dps delete [--ids]
                  [--name]
                  [--resource-group]
                  [--subscription]

Ejemplos

Eliminación de un servicio de aprovisionamiento de dispositivos de Azure IoT Hub "MyDps"

az iot dps delete --name MyDps --resource-group MyResourceGroup

Parámetros opcionales

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

--name -n

Nombre del servicio IoT Hub Device Provisioning.

--resource-group -g

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

--subscription

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

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az iot dps list

Editar

Enumere las instancias del servicio Azure IoT Hub Device Provisioning.

az iot dps list [--resource-group]

Ejemplos

Enumere todos los servicios de aprovisionamiento de dispositivos de Azure IoT Hub en una suscripción.

az iot dps list

Enumeración de todos los servicios de aprovisionamiento de dispositivos de Azure IoT Hub en el grupo de recursos "MyResourceGroup"

az iot dps list --resource-group MyResourceGroup

Parámetros opcionales

--resource-group -g

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

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az iot dps show

Editar

Obtenga los detalles de una instancia de Azure IoT Hub Device Provisioning Service.

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

Ejemplos

Mostrar detalles de una instancia de Azure IoT Hub Device Provisioning Service "MyDps"

az iot dps show --name MyDps --resource-group MyResourceGroup

Parámetros opcionales

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

--name -n

Nombre del servicio IoT Hub Device Provisioning.

--resource-group -g

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

--subscription

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

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.

az iot dps update

Editar

Actualice una instancia del servicio Azure IoT Hub Device Provisioning.

az iot dps update [--add]
                  [--force-string]
                  [--ids]
                  [--name]
                  [--remove]
                  [--resource-group]
                  [--set]
                  [--subscription]
                  [--tags]

Ejemplos

Actualización de la directiva de asignación a "GeoLatency" de un servicio de aprovisionamiento de dispositivos de Azure IoT Hub "MyDps"

az iot dps update --name MyDps --resource-group MyResourceGroup --set properties.allocationPolicy="GeoLatency"

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: []
--force-string

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

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

--name -n

Nombre del servicio IoT Hub Device Provisioning.

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

--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: []
--subscription

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

--tags

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

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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. Use --debug para registros de depuración completos.