Compartir a través de

az iot ops connector opcua client

  • Vista previa
  • Referencia

Nota

Esta referencia forma parte de la extensión azure-iot-ops de para la CLI de Azure (versión 2.53.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az iot ops connector opcua client. Más información sobre las extensiones.

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

Administre el certificado de instancia de aplicación cliente de nivel empresarial para OPC UA Broker.

El conector de OPC UA usa un único certificado de instancia de aplicación de OPC UA para todas las sesiones que establece para recopilar datos de telemetría de servidores OPC UA. Para obtener más información, consulta https://aka.ms/opcua-certificates.

Comandos

Nombre Description Tipo Estado
az iot ops connector opcua client add

Agregue un certificado de instancia de aplicación cliente de nivel empresarial.

 Extensión Vista previa
az iot ops connector opcua client remove

Quite el certificado de instancia de aplicación cliente del Agente de OPC UA.

 Extensión Vista previa
az iot ops connector opcua client show

Muestra los detalles del recurso secretsync "aio-opc-ua-broker-client-certificate".

 Extensión Vista previa

az iot ops connector opcua client add

Vista previa

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

Agregue un certificado de instancia de aplicación cliente de nivel empresarial.

La extensión de archivo de clave pública debe ser .der y la extensión de archivo de clave privada debe ser .pem. Asegúrese de usar el mismo nombre de archivo para la clave pública y el archivo de clave privada. Si no se encuentra, se creará secret secretproviderclass "opc-ua-connector" y secretsync "aio-opc-ua-broker-client-certificate". El certificado recién agregado reemplazará el certificado existente si hay alguno.

az iot ops connector opcua client add --application-uri
                                      --instance
                                      --pkf
                                      --private-key-file
                                      --resource-group
                                      --sn
                                      [--overwrite-secret {false, true}]
                                      [--pks]
                                      [--private-key-secret-name]

Ejemplos

Agregue un certificado de cliente.

az iot ops connector opcua client add --instance instance --resource-group instanceresourcegroup --public-key-file "newopc.der" --private-key-file "newopc.pem" --subject-name "aio-opc-opcuabroker" --application-uri "urn:microsoft.com:aio:opc:opcuabroker"

Agregue un certificado de cliente y omita el mensaje de confirmación de sobrescritura cuando el secreto ya exista.

az iot ops connector opcua client add --instance instance --resource-group instanceresourcegroup --public-key-file "newopc.der" --private-key-file "newopc.pem" --subject-name "aio-opc-opcuabroker" --application-uri "urn:microsoft.com:aio:opc:opcuabroker" --overwrite-secret

Agregue un certificado de cliente con el nombre de secreto de clave pública y privada personalizado.

az iot ops connector opcua client add --instance instance --resource-group instanceresourcegroup --public-key-file "newopc.der" --private-key-file "newopc.pem" --public-key-secret-name public-secret-name --private-key-secret-name private-secret-name --subject-name "aio-opc-opcuabroker" --application-uri "urn:microsoft.com:aio:opc:opcuabroker"

Parámetros requeridos

--application-uri --au

URI de instancia de aplicación incrustado en la instancia de aplicación. Puede encontrarse en certificado de clave pública.

--instance -i -n

Nombre de instancia de IoT Operations.

--pkf --public-key-file

Archivo que contiene la clave pública del certificado de instancia de aplicación de nivel empresarial en formato .der. El nombre de archivo se usará para generar el nombre del secreto de clave pública.

--private-key-file --prkf

Archivo que contiene la clave privada del certificado de instancia de aplicación de nivel empresarial en formato .pem. El nombre de archivo se usará para generar el nombre del secreto de clave privada.

--resource-group -g

Grupo de recursos de instancia.

--sn --subject-name

Cadena de nombre de firmante incrustada en el certificado de instancia de aplicación. Puede encontrarse en certificado de clave pública.

Parámetros opcionales

--overwrite-secret

Confirme [y]es sin una solicitud para sobrescribir el secreto. si existía el nombre del secreto en El almacén de claves de Azure. Útil para escenarios de CI y automatización.

Valores aceptados: false, true
Valor predeterminado: False
--pks --public-key-secret-name

Nombre del secreto de clave pública en Key Vault. Si no se proporciona, el nombre del archivo de certificado se usará para generar el nombre del secreto.

--private-key-secret-name --prks

Nombre del secreto de clave privada en Key Vault. Si no se proporciona, el nombre del archivo de certificado se usará para generar el nombre del secreto.

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 ops connector opcua client remove

Vista previa

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

Quite el certificado de instancia de aplicación cliente del Agente de OPC UA.

Nota: Al quitar todos los certificados del almacén de certificados de cliente del agente de OPC UA, se desencadenará la eliminación del recurso secretsync "aio-opc-ua-broker-client-certificate". Y esta operación desencadenará la reserva al certificado predeterminado (basado en el administrador de certificados). Esta reserva requiere una actualización de extensión aio. Asegúrese de quitar el par de certificados de clave public(.der) y private(.pem) para evitar secretos huérfanos.

az iot ops connector opcua client remove --certificate-names
                                         --instance
                                         --resource-group
                                         [--force {false, true}]
                                         [--include-secrets {false, true}]
                                         [--yes {false, true}]

Ejemplos

Quite los certificados de cliente del almacén de certificados de cliente de OPC UA Broker.

az iot ops connector opcua client remove --instance instance --resource-group instanceresourcegroup --certificate-names testcert.der testcert.pem

Quite los certificados de cliente del almacén de certificados de cliente, incluido el secreto de keyvault relacionado.

az iot ops connector opcua client remove --instance instance --resource-group instanceresourcegroup --certificate-names testcert.der testcert.pem --include-secrets

Forzar la operación quitar certificados independientemente de las advertencias. Puede provocar errores.

az iot ops connector opcua client remove --instance instance --resource-group instanceresourcegroup --certificate-names testcert.der testcert.pem --force

Quite los certificados de cliente del almacén de certificados de cliente y omita la solicitud de confirmación para la eliminación.

az iot ops connector opcua client remove --instance instance --resource-group instanceresourcegroup --certificate-names testcert.der testcert.pem --yes

Parámetros requeridos

--certificate-names --cn

Nombres de certificado separados por espacios que se van a quitar. Nota: los nombres se pueden encontrar en la propiedad de recurso secretsync correspondiente "targetKey".

--instance -i -n

Nombre de instancia de IoT Operations.

--resource-group -g

Grupo de recursos de instancia.

Parámetros opcionales

--force

Forzar la ejecución de la operación.

Valores aceptados: false, true
Valor predeterminado: False
--include-secrets

Indica que el comando debe quitar los secretos del almacén de claves asociados a los certificados. Esta opción eliminará y purgará los secretos.

Valores aceptados: false, true
Valor predeterminado: False
--yes -y

Confirme [y]es sin un mensaje. Útil para escenarios de CI y automatización.

Valores aceptados: false, true
Valor predeterminado: False
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 ops connector opcua client show

Vista previa

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

Muestra los detalles del recurso secretsync "aio-opc-ua-broker-client-certificate".

az iot ops connector opcua client show --instance
                                       --resource-group

Ejemplos

Muestra los detalles del recurso secretsync "aio-opc-ua-broker-client-certificate".

az iot ops connector opcua client show --instance instance --resource-group instanceresourcegroup

Parámetros requeridos

--instance -i -n

Nombre de instancia de IoT Operations.

--resource-group -g

Grupo de recursos de instancia.

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.