Partilhar via


az iot ops asset endpoint

Nota

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 pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie perfis de ponto de extremidade de ativos.

Comandos

Name Description Tipo Status
az iot ops asset endpoint certificate

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

Extensão Pré-visualizar
az iot ops asset endpoint certificate add

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

Extensão Pré-visualizar
az iot ops asset endpoint certificate list

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

Extensão Pré-visualizar
az iot ops asset endpoint certificate remove

Remova um certificado de propriedade em um ponto de extremidade de ativo.

Extensão Pré-visualizar
az iot ops asset endpoint create

Crie um ponto de extremidade de ativo.

Extensão Pré-visualizar
az iot ops asset endpoint delete

Exclua um ponto de extremidade de ativo.

Extensão Pré-visualizar
az iot ops asset endpoint query

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

Extensão Pré-visualizar
az iot ops asset endpoint show

Mostrar um ponto de extremidade de ativo.

Extensão Pré-visualizar
az iot ops asset endpoint update

Atualize um ponto de extremidade de ativo.

Extensão Pré-visualizar

az iot ops asset endpoint create

Pré-visualizar

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

Crie um ponto de extremidade de ativo.

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

O Azure IoT OPC UA Broker (visualização) usa o mesmo certificado de 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 ponto de extremidade de ativo com autenticação de usuário anônima 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ônima usando o local personalizado fornecido e o grupo de recursos 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 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 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 Obrigatórios

--name -n

Nome do ponto de extremidade do ativo.

--resource-group -g

o 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 aos certificados associados ao ponto de extremidade. Os seguintes valores de chave são suportados: secret (required), thumbprint (required), password.--cert pode ser usado 1 ou mais vezes. Analise exemplos de ajuda para obter o uso completo de parâmetros.

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

Referência para o certificado usado na autenticação. Este método de autenticação do 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 localização personalizada.

--cls --custom-location-subscription

ID da subscrição para localização personalizada.

--cluster -c

Cluster ao qual associar o ativo.

--cluster-subscription --cs

ID de assinatura para cluster.

--location -l

Localização. 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 recursos do Asset Endpoint. Saco 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 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

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

--verbose

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

az iot ops asset endpoint delete

Pré-visualizar

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

Exclua um ponto de extremidade de ativo.

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

Exemplos

Exclua um ponto de extremidade de ativo.

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

Parâmetros Obrigatórios

--name -n

Nome do ponto de extremidade do ativo.

--resource-group -g

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

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

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

--verbose

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

az iot ops asset endpoint query

Pré-visualizar

O grupo de comandos 'iot ops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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 têm o endereço de destino fornecido e o local personalizado.

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

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

--resource-group -g

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

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

--verbose

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

az iot ops asset endpoint show

Pré-visualizar

O grupo de comandos 'iot ops' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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 Obrigatórios

--name -n

Nome do ponto de extremidade do ativo.

--resource-group -g

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

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

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

--verbose

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

az iot ops asset endpoint update

Pré-visualizar

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

Atualize um ponto de extremidade 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 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 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 ponto de extremidade 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 ponto de extremidade 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 Obrigatórios

--name -n

Nome do ponto de extremidade do ativo.

--resource-group -g

o 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. Este método de autenticação do 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 recursos do Asset Endpoint. Saco 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 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

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

--verbose

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