Partilhar via

az iot ops connector opcua client

  • Pré-visualizar

Note

Essa referência faz parte da extensão azure-iot-ops para a CLI do Azure (versão 2.67.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az iot ops connector opcua client. Saiba mais sobre extensões.

O grupo de comandos 'iot ops connector' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie o certificado de instância de aplicativo cliente de nível empresarial para o OPC UA Broker.

O conector para OPC UA faz uso de um único certificado de instância de aplicativo OPC UA para todas as sessões que estabelece para coletar dados de telemetria de servidores OPC UA. Para mais informações, consulte https://aka.ms/opcua-certificates.

Comandos

Name Description Tipo Status
az iot ops connector opcua client add

Adicione um certificado de instância de aplicativo cliente de nível empresarial.

 Extension Preview
az iot ops connector opcua client remove

Remova o certificado de instância do aplicativo cliente do OPC UA Broker.

 Extension Preview
az iot ops connector opcua client show

Mostrar detalhes do recurso secretsync 'aio-opc-ua-broker-client-certificate'.

 Extension Preview

az iot ops connector opcua client add

Pré-visualizar

O grupo de comandos 'iot ops connector' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Adicione um certificado de instância de aplicativo cliente de nível empresarial.

A extensão do arquivo de chave pública deve ser .der e a extensão do arquivo de chave privada deve ser .pem. Certifique-se de usar o mesmo nome de arquivo para chave pública e arquivo de chave privada. Azure resource secretproviderclass 'opc-ua-connector' e secretsync 'aio-opc-ua-broker-client-certificate' serão criados se não forem encontrados. O certificado recém-adicionado substituirá o certificado existente, se houver. Nota: O nome do assunto e o URI do aplicativo serão derivados automaticamente do certificado fornecido. Parâmetros opcionais podem ser usados para validar os respetivos valores de acordo com as expectativas antes que a operação prossiga.

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

Exemplos

Adicione um 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"

Adicione um certificado de cliente e ignore o prompt de confirmação de substituição quando o segredo já existir.

az iot ops connector opcua client add --instance instance --resource-group instanceresourcegroup --public-key-file "newopc.der" --private-key-file "newopc.pem" --overwrite-secret

Adicione um certificado de cliente com o nome do segredo da chave pública e privada personalizada.

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

Adicione um certificado de cliente com o nome do assunto e o URI do aplicativo especificados. Os valores serão usados para validar os valores de certificado existentes.

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 Obrigatórios

--instance -i -n

Nome da instância de Operações IoT.

--pkf --public-key-file

Arquivo que contém a chave pública do certificado de instância do aplicativo de nível empresarial no formato .der. O nome do arquivo será usado para gerar o nome do segredo da chave pública.

--private-key-file --prkf

Arquivo que contém a chave privada do certificado de instância do aplicativo de nível empresarial no formato .pem. O nome do arquivo será usado para gerar o nome secreto da chave privada.

--resource-group -g

Grupo de recursos de instância.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--application-uri --au

O URI da instância do aplicativo incorporado na instância do aplicativo. Pode ser encontrado em certificado de chave pública. Quando fornecido, o valor será usado para validar o URI do aplicativo do certificado.

--overwrite-secret

Confirme [y]es sem uma solicitação para substituir segredo. se o nome secreto existia no cofre de chaves do Azure. Útil para cenários de CI e automação.

Propriedade Valor
Default value: False
Valores aceites: false, true
--pks --public-key-secret-name

Nome do segredo de chave pública no Cofre da Chave. Se não for fornecido, o nome do arquivo de certificado será usado para gerar o nome secreto.

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

Nome secreto da chave privada no Cofre da Chave. Se não for fornecido, o nome do arquivo de certificado será usado para gerar o nome secreto.

--sn --subject-name

A cadeia de caracteres do nome da entidade incorporada no certificado da instância do aplicativo. Pode ser encontrado em certificado de chave pública. Quando fornecido, o valor será usado para validar o nome do assunto do certificado.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az iot ops connector opcua client remove

Pré-visualizar

O grupo de comandos 'iot ops connector' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Remova o certificado de instância do aplicativo cliente do OPC UA Broker.

Nota: A remoção de todos os certificados do armazenamento de certificados do cliente do OPC UA Broker acionará a exclusão do recurso secretsync 'aio-opc-ua-broker-client-certificate'. E essa operação acionará o fallback para o certificado padrão (baseado em cert-manager). Este fallback requer uma atualização de extensão aio. Certifique-se de remover o par de certificados de chave pública(.der) e privada(.pem) para evitar segredos órfãos.

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

Exemplos

Remova os certificados de cliente do armazenamento de certificados de cliente do OPC UA Broker.

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

Remova certificados de cliente do armazenamento de certificados de cliente, incluindo remover segredo de keyvault relacionado.

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

Forçar a operação de remoção de certificados, independentemente dos avisos. Pode levar a erros.

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

Remova os certificados de cliente do armazenamento de certificados do cliente e ignore o prompt de confirmação para remoção.

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

Parâmetros Obrigatórios

--certificate-names --cn

Nomes de certificados separados por espaço a serem removidos. Nota: os nomes podem ser encontrados na propriedade de recurso secretsync correspondente 'targetKey'.

--instance -i -n

Nome da instância de Operações IoT.

--resource-group -g

Grupo de recursos de instância.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--force

Forçar a execução da operação.

Propriedade Valor
Default value: False
Valores aceites: false, true
--include-secrets

Indica que o comando deve remover os segredos do cofre de chaves associados ao(s) certificado(s). Esta opção eliminará e eliminará os segredos.

Propriedade Valor
Default value: False
Valores aceites: false, true
--yes -y

Confirme [s]es sem um prompt. Útil para cenários de CI e automação.

Propriedade Valor
Default value: False
Valores aceites: false, true
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az iot ops connector opcua client show

Pré-visualizar

O grupo de comandos 'iot ops connector' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Mostrar detalhes do recurso secretsync 'aio-opc-ua-broker-client-certificate'.

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

Exemplos

Mostrar detalhes do recurso secretsync 'aio-opc-ua-broker-client-certificate'.

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

Parâmetros Obrigatórios

--instance -i -n

Nome da instância de Operações IoT.

--resource-group -g

Grupo de recursos de instância.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False