다음을 통해 공유

az iot ops asset endpoint

  • 미리 보기
  • 참조

참고 항목

이 참조는 Azure CLI(버전 2.53.0 이상)에 대한 azure-iot-ops 확장의 일부입니다. az iot ops asset endpoint 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

자산 엔드포인트 프로필을 관리합니다.

명령

Name Description 형식 상태
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

자산 엔드포인트에 대한 Resource Graph를 쿼리합니다.

 내선 번호 프리뷰
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 확장으로 올바르게 설정되었는지 확인합니다.

Azure IoT OPC UA Broker(미리 보기)는 자체와 연결하는 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 Container Storage 인터페이스 드라이버를 통해 설정됩니다.

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

사용자 지정 위치에 대한 구독 ID입니다.

--cluster -c

자산을 연결할 클러스터입니다.

--cluster-subscription --cs

클러스터에 대한 구독 ID입니다.

--location -l

위치. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--password-ref --pr

인증에 사용되는 암호에 대한 참조입니다.

--tags

자산 엔드포인트 리소스 태그입니다. a=b c=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

구독의 이름 또는 ID입니다. 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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot ops asset endpoint query

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

자산 엔드포인트에 대한 Resource Graph를 쿼리합니다.

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

위치. 값 출처: 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

구독의 이름 또는 ID입니다. 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

구독의 이름 또는 ID입니다. 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 c=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

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.