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.46.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 comando 'iot ops' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerenciar perfis de endpoint de ativos.

Comandos

Nome Description Tipo Status
az iot ops asset endpoint certificate

Gerenciar certificados de propriedade em um ponto de extremidade 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 ponto de extremidade de ativo.

Extensão Visualizar
az iot ops asset endpoint create

Crie um ponto de extremidade de ativo.

Extensão Visualizar
az iot ops asset endpoint delete

Excluir um ponto de extremidade de ativo.

Extensão Visualizar
az iot ops asset endpoint query

Consulte o gráfico de recursos para pontos de extremidade de ativos.

Extensão Visualizar
az iot ops asset endpoint show

Mostrar um ponto de extremidade de ativo.

Extensão Visualizar
az iot ops asset endpoint update

Atualizar um ponto de extremidade de ativo.

Extensão Visualizar

az iot ops asset endpoint create

Versão Prévia

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

Crie um ponto de extremidade 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]
                                 [--cl]
                                 [--clrg]
                                 [--cls]
                                 [--cluster]
                                 [--cluster-resource-group]
                                 [--cluster-subscription]
                                 [--location]
                                 [--password-ref]
                                 [--tags]
                                 [--ur]

Exemplos

Crie um ponto de extremidade 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 ponto de extremidade 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 ponto de extremidade de ativo com autenticação de usuário de nome de usuário e senha 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 ponto de extremidade de ativo com autenticação de usuário de nome de usuário-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 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 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 (por exemplo: 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 (required), (required), thumbprintpassword.--cert pode ser usado 1 ou mais vezes. Revise os exemplos de ajuda para uso completo de parâmetros.

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

--cl --custom-location

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

--clrg --custom-location-resource-group

Grupo de recursos para local personalizado.

--cls --custom-location-subscription

ID da assinatura para local personalizado.

--cluster -c

Cluster ao qual associar o ativo.

--cluster-resource-group --crg

Grupo de recursos para cluster.

--cluster-subscription --cs

ID de 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 de ponto de extremidade de ativo. Conjunto de propriedades em pares chave-valor 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 comando 'iot ops' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Excluir um ponto de extremidade de ativo.

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

Exemplos

Excluir um ponto de extremidade 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 comando 'iot ops' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Consulte o gráfico de recursos para pontos de extremidade de ativos.

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

Exemplos

Consulta de pontos de extremidade de ativos que possuem autenticação anônima.

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

Consulta de pontos de extremidade de ativos que tenham o endereço de destino e o local personalizados 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 (por exemplo: 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 comando 'iot ops' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Mostrar um ponto de extremidade de ativo.

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

Exemplos

Mostrar os detalhes de um ponto de extremidade 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 comando 'iot ops' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualizar um ponto de extremidade de ativo.

Para atualizar certificados de propriedade, 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 ponto de extremidade 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 e a configuração adicional de um ponto de extremidade de ativo 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 e a configuração adicional de um ponto de extremidade de ativo 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 e a configuração adicional de um ponto de extremidade de ativo 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 (por exemplo: 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 de ponto de extremidade de ativo. Conjunto de propriedades em pares chave-valor 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.