Поделиться через

az iot ops asset endpoint

  • Предварительный просмотр
  • Ссылка

Примечание.

Эта ссылка является частью расширения azure-iot-ops для Azure CLI (версия 2.53.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az iot ops asset endpoint . Подробнее о расширениях.

Группа команд iot ops находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Управление профилями конечных точек активов.

Команды

Имя Описание Тип Состояние
az iot ops asset endpoint certificate

Управление собственными сертификатами в конечной точке ресурса.

 Расширение Предварительный просмотр
az iot ops asset endpoint certificate add

Добавьте собственный сертификат в конечную точку ресурса.

 Расширение Предварительный просмотр
az iot ops asset endpoint certificate list

Вывод списка принадлежащих сертификатов в конечной точке ресурса.

 Расширение Предварительный просмотр
az iot ops asset endpoint certificate remove

Удалите принадлежащий сертификат в конечной точке ресурса.

 Расширение Предварительный просмотр
az iot ops asset endpoint create

Создайте конечную точку ресурса.

 Расширение Предварительный просмотр
az iot ops asset endpoint delete

Удаление конечной точки ресурса.

 Расширение Предварительный просмотр
az iot ops asset endpoint query

Запрос графа ресурсов для конечных точек активов.

 Расширение Предварительный просмотр
az iot ops asset endpoint show

Отображение конечной точки ресурса.

 Расширение Предварительный просмотр
az iot ops asset endpoint update

Обновите конечную точку ресурса.

 Расширение Предварительный просмотр

az iot ops asset endpoint create

Предварительный просмотр

Группа команд iot ops находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Создайте конечную точку ресурса.

Необходимо указать пользовательское расположение или имя кластера. Эта команда проверяет наличие связанного пользовательского расположения и кластера и гарантирует правильность настройки с расширением microsoft.deviceregistry.assets.

Брокер OPC UA в Azure IoT (предварительная версия) использует один и тот же сертификат клиента для всех защищенных каналов между собой и серверами OPC UA, к которым он подключается.

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]

Примеры

Создайте конечную точку ресурса с анонимной проверкой подлинности пользователя с помощью заданного пользовательского расположения.

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

Создайте конечную точку ресурса с анонимной проверкой подлинности пользователя, используя заданное пользовательское расположение и группу ресурсов для пользовательского расположения. Группа ресурсов должна быть включена, если в подписке есть несколько пользовательских расположений с одинаковым именем.

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}

Создайте конечную точку ресурса с проверкой подлинности пользователя и предварительно настроенными сертификатами с предварительно заполненными значениями. Ссылки на имя пользователя и пароль задаются с помощью драйвера интерфейса хранилища контейнеров 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

Создайте конечную точку ресурса с проверкой подлинности пользователя с паролем имени пользователя и дополнительной конфигурации с предварительно заполненными значениями (пример синтаксиса 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}}'

Создайте конечную точку ресурса с проверкой подлинности пользователя с паролем имени пользователя и дополнительной конфигурации с предварительно заполненными значениями (пример синтаксиса 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}}"

Создайте конечную точку ресурса с проверкой подлинности пользователя с паролем имени пользователя и дополнительной конфигурации с предварительно заполненными значениями (пример синтаксиса 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}}'

Обязательные параметры

--name -n

Имя конечной точки ресурса.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--ta --target-address

Целевой адрес. Должен быть допустимым локальным адресом.

Необязательные параметры

--ac --additional-config

Дополнительная конфигурация для типа подключения (например, OPC UA, Modbus, ONVIF).

--cert

Пары key=value, разделенные пробелами, соответствующие сертификатам, связанным с конечной точкой. Поддерживаются следующие ключевые значения: secret (обязательно), thumbprint (обязательно), password.--cert можно использовать 1 или более раз. Ознакомьтесь с примерами справки по полному использованию параметров.

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

Справочник по сертификату, используемому в проверке подлинности. Этот метод проверки подлинности пользователя еще не поддерживается.

--cg --cluster-resource-group

Группа ресурсов для кластера.

--cl --custom-location

Настраиваемое расположение, используемое для связывания конечной точки ресурса с кластером.

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

Группа ресурсов для пользовательского расположения.

--cls --custom-location-subscription

Идентификатор подписки для пользовательского расположения.

--cluster -c

Кластер для связывания ресурса с.

--cluster-subscription --cs

Идентификатор подписки для кластера.

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--password-ref --pr

Ссылка на пароль, используемый в проверке подлинности.

--tags

Теги ресурсов конечной точки ресурса ресурса. Контейнер свойств в парах "ключ-значение" со следующим форматом: a=b=b=d.

--ur --username-reference

Ссылка на имя пользователя, используемое в проверке подлинности.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot ops asset endpoint delete

Предварительный просмотр

Группа команд iot ops находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Удаление конечной точки ресурса.

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

Примеры

Удаление конечной точки ресурса.

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

Обязательные параметры

--name -n

Имя конечной точки ресурса.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot ops asset endpoint query

Предварительный просмотр

Группа команд iot ops находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Запрос графа ресурсов для конечных точек активов.

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

Примеры

Запрос конечных точек активов, которые не могут выполнять анонимную проверку подлинности.

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

Запрос конечных точек ресурса с заданным целевым адресом и пользовательским расположением.

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

Необязательные параметры

--ac --additional-config

Дополнительная конфигурация для типа подключения (например, OPC UA, Modbus, ONVIF).

--am --authentication-mode

Режим проверки подлинности.

--cl --custom-location

Настраиваемое расположение, используемое для связывания конечной точки ресурса с кластером.

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--ta --target-address

Целевой адрес. Должен быть допустимым локальным адресом.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot ops asset endpoint show

Предварительный просмотр

Группа команд iot ops находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Отображение конечной точки ресурса.

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

Примеры

Отображение сведений о конечной точке ресурса.

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

Обязательные параметры

--name -n

Имя конечной точки ресурса.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot ops asset endpoint update

Предварительный просмотр

Группа команд iot ops находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Обновите конечную точку ресурса.

Чтобы обновить собственные сертификаты, используйте группу az iot ops asset endpoint certificateкоманд.

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

Примеры

Обновите режим проверки подлинности конечной точки ресурса, чтобы использовать анонимную проверку подлинности пользователя.

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

Обновите имя пользователя и пароль конечной точки ресурса с предварительно заполненными значениями. При этом режим проверки подлинности преобразуется в имя пользователя-пароль, если он еще не так.

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"

Обновите целевой адрес конечной точки ресурса и дополнительную конфигурацию с предварительно заполненными значениями (пример синтаксиса 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}}'

Обновите целевой адрес конечной точки ресурса и дополнительную конфигурацию с предварительно заполненными значениями (пример синтаксиса 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}}"

Обновите целевой адрес конечной точки ресурса и дополнительную конфигурацию с предварительно заполненными значениями (пример синтаксиса 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}}'

Обязательные параметры

--name -n

Имя конечной точки ресурса.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Необязательные параметры

--ac --additional-config

Дополнительная конфигурация для типа подключения (например, OPC UA, Modbus, ONVIF).

--am --authentication-mode

Режим проверки подлинности.

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

Справочник по сертификату, используемому в проверке подлинности. Этот метод проверки подлинности пользователя еще не поддерживается.

--password-ref --pr

Ссылка на пароль, используемый в проверке подлинности.

--ta --target-address

Целевой адрес. Должен быть допустимым локальным адресом.

--tags

Теги ресурсов конечной точки ресурса ресурса. Контейнер свойств в парах "ключ-значение" со следующим форматом: a=b=b=d.

--ur --username-reference

Ссылка на имя пользователя, используемое в проверке подлинности.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.