Compartilhar via


az iot ops asset endpoint

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 asset endpoint . Saiba mais sobre extensões.

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerencie perfis de endpoint de ativos.

Comandos

Nome Description Tipo Status
az iot ops asset endpoint certificate

Gerencie certificados de propriedade em um endpoint de ativo.

Extensão Visualizar
az iot ops asset endpoint certificate add

Adicione um certificado de propriedade a um ponto de extremidade de ativo.

Extensão Visualizar
az iot ops asset endpoint certificate list

Listar certificados de propriedade em um ponto de extremidade de ativo.

Extensão Visualizar
az iot ops asset endpoint certificate remove

Remova um certificado de propriedade em um endpoint de ativo.

Extensão Visualizar
az iot ops asset endpoint create

Crie um endpoint de ativo.

Extensão Visualizar
az iot ops asset endpoint delete

Exclua um endpoint de ativo.

Extensão Visualizar
az iot ops asset endpoint query

Consulte o Resource Graph para pontos de extremidade de ativos.

Extensão Visualizar
az iot ops asset endpoint show

Mostrar um ponto de extremidade do ativo.

Extensão Visualizar
az iot ops asset endpoint update

Atualize um endpoint de ativo.

Extensão Visualizar

az iot ops asset endpoint create

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie um endpoint de ativo.

O local personalizado ou o nome do cluster devem ser fornecidos. Esse comando verificará a existência do local personalizado e do cluster associados e garantirá que ambos estejam configurados corretamente com a extensão microsoft.deviceregistry.assets.

O Agente OPC UA da Internet das Coisas do Azure (versão prévia) usa o mesmo certificado do cliente para todos os canais seguros entre ele e os servidores OPC UA aos quais ele se conecta.

az iot ops asset endpoint create --name
                                 --resource-group
                                 --ta
                                 [--ac]
                                 [--cert]
                                 [--cert-ref]
                                 [--cg]
                                 [--cl]
                                 [--clg]
                                 [--cls]
                                 [--cluster]
                                 [--cluster-subscription]
                                 [--location]
                                 [--password-ref]
                                 [--tags]
                                 [--ur]

Exemplos

Crie um endpoint de ativo com autenticação de usuário anônimo usando o local personalizado fornecido.

az iot ops asset endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --target-address {target_address}

Crie um endpoint de ativo com autenticação de usuário anônimo usando o local personalizado e o grupo de recursos fornecidos para o local personalizado. O grupo de recursos deve ser incluído se houver vários locais personalizados com o mesmo nome em uma assinatura.

az iot ops asset endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --custom-location-resource-group {custom_location_resource_group} --target-address {target_address}

Crie um endpoint de ativo com autenticação de usuário de nome de usuário e senha de usuário e certificados de propriedade pré-configurados com valores pré-preenchidos. As referências de nome de usuário e senha são definidas por meio do driver da Interface de Armazenamento de Contêiner do Azure Keyvault.

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --cert secret=aio-opc-ua-broker-client-certificate thumbprint=000000000000000000 password=aio-opc-ua-broker-client-certificate-password

Crie um ponto de extremidade de ativo com autenticação de usuário de nome de usuário e senha e configuração adicional com valores pré-preenchidos (exemplo de sintaxe do PowerShell).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

Crie um endpoint de ativo com autenticação de usuário de nome de usuário e senha e configuração adicional com valores pré-preenchidos (exemplo de sintaxe cmd).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

Crie um endpoint de ativo com autenticação de usuário de nome de usuário e senha e configuração adicional com valores pré-preenchidos (exemplo de sintaxe bash).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

Parâmetros Exigidos

--name -n

Nome do ponto de extremidade do ativo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--ta --target-address

Endereço de destino. Deve ser um endereço local válido.

Parâmetros Opcionais

--ac --additional-config

Configuração adicional para o tipo de conectividade (ex: OPC UA, Modbus, ONVIF).

--cert

Pares chave=valor separados por espaço correspondentes a certificados associados ao ponto de extremidade. Os seguintes valores de chave são suportados: secret (obrigatório), thumbprint (obrigatório), password.--cert pode ser usado 1 ou mais vezes. Examine os exemplos de ajuda para o uso completo do parâmetro.

--cert-ref --certificate-ref --cr

Referência para o certificado usado na autenticação. Esse método de autenticação de usuário ainda não é suportado.

--cg --cluster-resource-group

Grupo de recursos para cluster.

--cl --custom-location

Local personalizado usado para associar o ponto de extremidade do ativo ao cluster.

--clg --custom-location-resource-group

Grupo de recursos para local personalizado.

--cls --custom-location-subscription

ID de assinatura para local personalizado.

--cluster -c

Cluster ao qual associar o ativo.

--cluster-subscription --cs

ID da assinatura para cluster.

--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--password-ref --pr

Referência para a senha usada na autenticação.

--tags

Tags de recurso do Asset Endpoint. Recipiente de propriedades em pares de valores-chave com o seguinte formato: a=b c=d.

--ur --username-reference

Referência para o nome de usuário usado na autenticação.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops asset endpoint delete

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Exclua um endpoint de ativo.

az iot ops asset endpoint delete --name
                                 --resource-group

Exemplos

Exclua um endpoint de ativo.

az iot ops asset endpoint delete --name {asset_endpoint} -g {resource_group}

Parâmetros Exigidos

--name -n

Nome do ponto de extremidade do ativo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops asset endpoint query

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Consulte o Resource Graph para pontos de extremidade de ativos.

az iot ops asset endpoint query [--ac]
                                [--am]
                                [--cl]
                                [--location]
                                [--resource-group]
                                [--ta]

Exemplos

Consulte endpoints de ativos que possuem autenticação anônima.

az iot ops asset endpoint query --authentication-mode Anonymous

Consulte os pontos de extremidade de ativos que têm o endereço de destino e o local personalizado fornecidos.

az iot ops asset endpoint query --target-address {target_address} --custom-location {custom_location}

Parâmetros Opcionais

--ac --additional-config

Configuração adicional para o tipo de conectividade (ex: OPC UA, Modbus, ONVIF).

--am --authentication-mode

Modo de autenticação.

--cl --custom-location

Local personalizado usado para associar o ponto de extremidade do ativo ao cluster.

--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--ta --target-address

Endereço de destino. Deve ser um endereço local válido.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops asset endpoint show

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Mostrar um ponto de extremidade do ativo.

az iot ops asset endpoint show --name
                               --resource-group

Exemplos

Mostre os detalhes de um endpoint de ativo.

az iot ops asset endpoint show --name {asset_endpoint} -g {resource_group}

Parâmetros Exigidos

--name -n

Nome do ponto de extremidade do ativo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot ops asset endpoint update

Versão Prévia

O grupo de comandos 'iot ops' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualize um endpoint de ativo.

Para atualizar certificados próprios, use o grupo az iot ops asset endpoint certificatede comandos .

az iot ops asset endpoint update --name
                                 --resource-group
                                 [--ac]
                                 [--am]
                                 [--cert-ref]
                                 [--password-ref]
                                 [--ta]
                                 [--tags]
                                 [--ur]

Exemplos

Atualize o modo de autenticação de um ponto de extremidade de ativo para usar a autenticação de usuário anônimo.

az iot ops asset endpoint update --name {asset_endpoint} -g {resource_group} --authentication-mode Anonymous

Atualize a referência de nome de usuário e senha de um endpoint de ativo com valores pré-preenchidos. Isso transformará o modo de autenticação em nome de usuário-senha, se ainda não for assim.

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password"

Atualize o endereço de destino de um ponto de extremidade de ativo e a configuração adicional com valores pré-preenchidos (exemplo de sintaxe do PowerShell).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

Atualize o endereço de destino de um endpoint de ativo e a configuração adicional com valores pré-preenchidos (exemplo de sintaxe cmd).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

Atualize o endereço de destino de um endpoint de ativo e a configuração adicional com valores pré-preenchidos (exemplo de sintaxe bash).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

Parâmetros Exigidos

--name -n

Nome do ponto de extremidade do ativo.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--ac --additional-config

Configuração adicional para o tipo de conectividade (ex: OPC UA, Modbus, ONVIF).

--am --authentication-mode

Modo de autenticação.

--cert-ref --certificate-ref --cr

Referência para o certificado usado na autenticação. Esse método de autenticação de usuário ainda não é suportado.

--password-ref --pr

Referência para a senha usada na autenticação.

--ta --target-address

Endereço de destino. Deve ser um endereço local válido.

--tags

Tags de recurso do Asset Endpoint. Recipiente de propriedades em pares de valores-chave com o seguinte formato: a=b c=d.

--ur --username-reference

Referência para o nome de usuário usado na autenticação.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.