az iot hub certificate

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

Administre los certificados de IoT Hub.

Comandos

Nombre Description Tipo Estado
az iot hub certificate create

Cree o cargue un certificado de Azure IoT Hub.

 Core GA
az iot hub certificate delete

Elimina un certificado de Azure IoT Hub.

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

Enumera todos los certificados contenidos en una instancia de Azure IoT Hub.

 Core GA
az iot hub certificate root-authority

Administre la entidad raíz del certificado para una instancia de IoT Hub.

 Extensión Obsoleto
az iot hub certificate root-authority set

Establezca la entidad raíz del certificado para una instancia de IoT Hub en una versión específica.

 Extensión Obsoleto
az iot hub certificate root-authority show

Mostrar la entidad raíz del certificado actual para una instancia de IoT Hub.

 Extensión Obsoleto
az iot hub certificate show

Muestra información sobre un certificado de Azure IoT Hub determinado.

 Core GA
az iot hub certificate update

Actualice un certificado de Azure IoT Hub.

 Core GA
az iot hub certificate verify

Comprueba un certificado de Azure IoT Hub.

 Core GA

az iot hub certificate create

Editar

Cree o cargue un certificado de Azure IoT Hub.

Para obtener una explicación detallada de los certificados de ENTIDAD de certificación en Azure IoT Hub, consulte https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

az iot hub certificate create --hub-name
                              --name
                              --path
                              [--resource-group]
                              [--verified {false, true}]

Ejemplos

Carga un archivo PEM de certificado de ENTIDAD de certificación comprobado en un centro de IoT.

az iot hub certificate create --hub-name MyIotHub --name MyCertificate --path /certificates/Certificate.pem --verified

Carga un archivo CER de certificado de ENTIDAD de certificación en un centro de IoT.

az iot hub certificate create --hub-name MyIotHub --name MyCertificate --path /certificates/Certificate.cer

Creación o carga de un certificado de Azure IoT Hub (generado automáticamente)

az iot hub certificate create --hub-name MyIotHub --name MyCertificate --path /certificates/Certificate.cer --resource-group MyResourceGroup --subscription MySubscription

Parámetros requeridos

--hub-name

Nombre de IoT Hub.

--name -n

Nombre descriptivo del certificado.

--path -p

Ruta de acceso al archivo que contiene el certificado.

Parámetros opcionales

--resource-group -g

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

--verified -v

Valor booleano que indica si se comprueba o no el certificado.

Valores aceptados: false, true
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

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

--subscription

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

--verbose

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

az iot hub certificate delete

Editar

Elimina un certificado de Azure IoT Hub.

Para obtener una explicación detallada de los certificados de ENTIDAD de certificación en Azure IoT Hub, consulte https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

az iot hub certificate delete --etag
                              --name
                              [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--subscription]

Ejemplos

Elimina MyCertificate

az iot hub certificate delete --hub-name MyIotHub --name MyCertificate --etag AAAAAAAAAAA=

Parámetros requeridos

--etag -e

Etiqueta de entidad (etag) del objeto .

--name -n

Nombre descriptivo del certificado.

Parámetros opcionales

--hub-name

Nombre de IoT Hub.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--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 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 certificate generate-verification-code

Editar

Genera un código de verificación para un certificado de Azure IoT Hub.

Este código de verificación se usa para completar el paso de prueba de posesión de un certificado. Use este código de verificación como CN de un nuevo certificado firmado con la clave privada de certificados raíz. Para obtener una explicación detallada de los certificados de ENTIDAD de certificación en Azure IoT Hub, consulte https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

az iot hub certificate generate-verification-code --etag
                                                  --name
                                                  [--hub-name]
                                                  [--ids]
                                                  [--resource-group]
                                                  [--subscription]

Ejemplos

Genera un código de verificación para MyCertificate

az iot hub certificate generate-verification-code --hub-name MyIotHub --name MyCertificate --etag AAAAAAAAAAA=

Genera un código de verificación para un certificado de Azure IoT Hub (generado automáticamente)

az iot hub certificate generate-verification-code --etag AAAAAAAAAAA= --hub-name MyIotHub --name MyCertificate --resource-group MyResourceGroup --subscription MySubscription

Parámetros requeridos

--etag -e

Etiqueta de entidad (etag) del objeto .

--name -n

Nombre descriptivo del certificado.

Parámetros opcionales

--hub-name

Nombre de IoT Hub.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

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

Editar

Enumera todos los certificados contenidos en una instancia de Azure IoT Hub.

Para obtener una explicación detallada de los certificados de ENTIDAD de certificación en Azure IoT Hub, consulte https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Ejemplos

Enumeración de todos los certificados en MyIotHub

az iot hub certificate list --hub-name MyIotHub

Parámetros opcionales

--hub-name

Nombre de IoT Hub.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

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

Editar

Muestra información sobre un certificado de Azure IoT Hub determinado.

Para obtener una explicación detallada de los certificados de ENTIDAD de certificación en Azure IoT Hub, consulte https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

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

Ejemplos

Mostrar detalles sobre MyCertificate

az iot hub certificate show --hub-name MyIotHub --name MyCertificate

Muestra información sobre un certificado de Azure IoT Hub determinado (generado automáticamente)

az iot hub certificate show --hub-name MyIotHub --name MyCertificate --resource-group MyResourceGroup --subscription MySubscription

Parámetros requeridos

--name -n

Nombre descriptivo del certificado.

Parámetros opcionales

--hub-name

Nombre de IoT Hub.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

--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 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 certificate update

Editar

Actualice un certificado de Azure IoT Hub.

Carga un nuevo certificado para reemplazar el certificado existente por el mismo nombre. Para obtener una explicación detallada de los certificados de ENTIDAD de certificación en Azure IoT Hub, consulte https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

az iot hub certificate update --etag
                              --name
                              --path
                              [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--subscription]
                              [--verified {false, true}]

Ejemplos

Novedades un certificado de ENTIDAD de certificación en un centro de IoT mediante la carga de un nuevo archivo PEM.

az iot hub certificate update --hub-name MyIotHub --name MyCertificate --path /certificates/NewCertificate.pem --etag AAAAAAAAAAA=

Novedades un certificado de ENTIDAD de certificación en un centro de IoT mediante la carga de un nuevo archivo CER.

az iot hub certificate update --hub-name MyIotHub --name MyCertificate --path /certificates/NewCertificate.cer --etag AAAAAAAAAAA=

Parámetros requeridos

--etag -e

Etiqueta de entidad (etag) del objeto .

--name -n

Nombre descriptivo del certificado.

--path -p

Ruta de acceso al archivo que contiene el certificado.

Parámetros opcionales

--hub-name

Nombre de IoT Hub.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

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

--verified -v

Valor booleano que indica si se comprueba o no el certificado.

Valores aceptados: false, true
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

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

--subscription

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

--verbose

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

az iot hub certificate verify

Editar

Comprueba un certificado de Azure IoT Hub.

Comprueba un certificado cargando un certificado de verificación que contiene el código de verificación obtenido mediante una llamada a generate-verification-code. Este es el último paso del proceso de prueba de posesión. Para obtener una explicación detallada de los certificados de ENTIDAD de certificación en Azure IoT Hub, consulte https://docs.microsoft.com/azure/iot-hub/iot-hub-x509ca-overview.

az iot hub certificate verify --etag
                              --name
                              --path
                              [--hub-name]
                              [--ids]
                              [--resource-group]
                              [--subscription]

Ejemplos

Comprueba la propiedad de la clave privada MyCertificate.

az iot hub certificate verify --hub-name MyIotHub --name MyCertificate --path /certificates/Verification.pem --etag AAAAAAAAAAA=

Comprueba un certificado de Azure IoT Hub (generado automáticamente)

az iot hub certificate verify --etag AAAAAAAAAAA= --hub-name MyIotHub --name MyCertificate --path /certificates/Verification.pem --resource-group MyResourceGroup --subscription MySubscription

Parámetros requeridos

--etag -e

Etiqueta de entidad (etag) del objeto .

--name -n

Nombre descriptivo del certificado.

--path -p

Ruta de acceso al archivo que contiene el certificado.

Parámetros opcionales

--hub-name

Nombre de IoT Hub.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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".

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