Partilhar via

az iot ops connector opcua client

  • Pré-visualizar
  • Referência

Observação

Essa referência faz parte da extensão azure-iot-ops para a CLI do Azure (versão 2.53.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 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.

 Extensão Previsualizar
az iot ops connector opcua client remove

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

 Extensão Previsualizar
az iot ops connector opcua client show

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

 Extensão Previsualizar

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

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]

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" --subject-name "aio-opc-opcuabroker" --application-uri "urn:microsoft.com:aio:opc:opcuabroker"

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" --subject-name "aio-opc-opcuabroker" --application-uri "urn:microsoft.com:aio:opc:opcuabroker" --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 --subject-name "aio-opc-opcuabroker" --application-uri "urn:microsoft.com:aio:opc:opcuabroker"

Parâmetros Obrigatórios

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

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

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

Parâmetros Opcionais

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

Valores aceites: false, true
Default value: False
--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.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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

--force

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

Valores aceites: false, true
Default value: False
--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.

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

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

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.