az iot ops asset

Note

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

자산 관리.

자산 관리에 대한 자세한 내용은 aka.ms/asset-overview 참조하세요.

명령

Name	Description	형식	상태
az iot ops asset create	자산을 만듭니다.	Extension	GA
az iot ops asset dataset	자산의 데이터 세트를 관리합니다.	Extension	GA
az iot ops asset dataset list	자산 내의 데이터 세트를 나열합니다.	Extension	GA
az iot ops asset dataset point	자산 데이터 세트의 데이터 요소를 관리합니다.	Extension	GA
az iot ops asset dataset point add	자산 데이터 세트에 데이터 포인트를 추가합니다.	Extension	GA
az iot ops asset dataset point export	자산 데이터 세트의 데이터 요소를 내보냅니다.	Extension	GA
az iot ops asset dataset point import	자산 데이터 세트의 데이터 요소를 가져옵니다.	Extension	GA
az iot ops asset dataset point list	자산 데이터 세트의 데이터 요소를 나열합니다.	Extension	GA
az iot ops asset dataset point remove	자산 데이터 세트의 데이터 포인트를 제거합니다.	Extension	GA
az iot ops asset dataset show	자산 내의 데이터 세트를 표시합니다.	Extension	GA
az iot ops asset delete	자산을 삭제합니다.	Extension	GA
az iot ops asset endpoint	자산 엔드포인트 프로필을 관리합니다.	Extension	GA
az iot ops asset endpoint create	자산 엔드포인트 프로필을 만듭니다.	Extension	GA
az iot ops asset endpoint create opcua	OPCUA 커넥터에 대한 자산 엔드포인트 프로필을 만듭니다.	Extension	GA
az iot ops asset endpoint delete	자산 엔드포인트 프로필을 삭제합니다.	Extension	GA
az iot ops asset endpoint query	자산 엔드포인트 프로필에 대한 Resource Graph를 쿼리합니다.	Extension	GA
az iot ops asset endpoint show	자산 엔드포인트 프로필을 표시합니다.	Extension	GA
az iot ops asset endpoint update	자산 엔드포인트 프로필을 업데이트합니다.	Extension	GA
az iot ops asset event	자산의 이벤트를 관리합니다.	Extension	GA
az iot ops asset event add	자산에 이벤트를 추가합니다.	Extension	GA
az iot ops asset event export	자산의 이벤트를 내보냅니다.	Extension	GA
az iot ops asset event import	자산에서 이벤트를 가져옵니다.	Extension	GA
az iot ops asset event list	자산의 이벤트를 나열합니다.	Extension	GA
az iot ops asset event remove	자산에서 이벤트를 제거합니다.	Extension	GA
az iot ops asset query	자산에 대한 Resource Graph를 쿼리합니다.	Extension	GA
az iot ops asset show	자산을 표시합니다.	Extension	GA
az iot ops asset update	자산을 업데이트합니다.	Extension	GA

az iot ops asset create

자산을 만듭니다.

파일 형식의 예제는 aka.ms/aziotops-assets 참조하세요.

az iot ops asset create --endpoint-profile --ep
                        --instance
                        --name
                        --resource-group
                        [--attr --custom-attribute]
                        [--dataset-publish-int --dpi]
                        [--dataset-queue-size --dqs]
                        [--dataset-sample-int --dsi]
                        [--description]
                        [--disable {false, true}]
                        [--display-name --dn]
                        [--documentation-uri --du]
                        [--eai --external-asset-id]
                        [--ef --event-file]
                        [--epi --event-publish-int]
                        [--eqs --event-queue-size]
                        [--esi --event-sample-int]
                        [--event]
                        [--hardware-revision --hr]
                        [--ig --instance-resource-group]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri --mu]
                        [--model]
                        [--pc --product-code]
                        [--serial-number --sn]
                        [--software-revision --sr]
                        [--tags]
                        [--topic-path --tp]
                        [--topic-retain --tr {Keep, Never}]

예제

동일한 리소스 그룹에서 지정된 인스턴스를 사용하여 자산을 만듭니다.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance

다른 리소스 그룹에 있지만 동일한 구독에서 지정된 인스턴스를 사용하여 자산을 만듭니다. 디지털 운영 환경은 인스턴스와 다른 구독에 있는 경우 자산을 표시하지 않을 수 있습니다.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --instance-resource-group myinstanceresourcegroup

이벤트를 포함하는 파일을 사용하여 비활성화된 자산을 만듭니다.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event-file /path/to/myasset_events.csv --disable

미리 채워진 지정된 값을 사용하여 자산을 만듭니다.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event event_notifier=EventNotifier1 name=myEvent1 observability_mode=log sampling_interval=10 queue_size=2 --event event_notifier=EventNotifier2 name=myEvent2 --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50 --description 'Description for a test asset.' --documentation-uri www.contoso.com --external-asset-id 000-000-1234 --hardware-revision 10.0 --product-code XXX100 --software-revision 0.1 --manufacturer Contoso --manufacturer-uri constoso.com --model AssetModel --serial-number 000-000-ABC10 --custom-attribute work_location=factory

필수 매개 변수

--endpoint-profile --ep

자산 엔드포인트 프로필 이름입니다.

--instance

만든 자산을 연결할 인스턴스 이름입니다.

--name -n

자산 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--attr --custom-attribute

자산에 대한 추가 사용자 지정 특성에 해당하는 공백으로 구분된 key=value 쌍입니다. 이 매개 변수는 두 번 이상 사용할 수 있습니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--dataset-publish-int --dpi

데이터 세트에 대한 기본 게시 간격입니다.

속성	값
매개 변수 그룹:	Dataset Default Arguments
Default value:	1000

--dataset-queue-size --dqs

데이터 세트의 기본 큐 크기입니다.

속성	값
매개 변수 그룹:	Dataset Default Arguments
Default value:	1

--dataset-sample-int --dsi

데이터 세트의 기본 샘플링 간격(밀리초)입니다.

속성	값
매개 변수 그룹:	Dataset Default Arguments
Default value:	500

--description -d

Description.

--disable

자산을 사용하지 않도록 설정합니다.

속성	값
Default value:	False
허용되는 값:	false, true

--display-name --dn

표시 이름입니다.

--documentation-uri --du

설명서 URI.

속성	값
매개 변수 그룹:	Additional Info Arguments

--eai --external-asset-id

외부 자산 ID입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--ef --event-file

이벤트를 포함하는 파일의 파일 경로입니다. 지원되는 파일 형식은 json, csv, yaml입니다.

속성	값
매개 변수 그룹:	Event Arguments

--epi --event-publish-int

이벤트에 대한 기본 게시 간격입니다.

속성	값
매개 변수 그룹:	Event Default Arguments
Default value:	1000

--eqs --event-queue-size

이벤트의 기본 큐 크기입니다.

속성	값
매개 변수 그룹:	Event Default Arguments
Default value:	1

--esi --event-sample-int

이벤트에 대한 기본 샘플링 간격(밀리초)입니다.

속성	값
매개 변수 그룹:	Event Default Arguments
Default value:	500

--event

만들 이벤트의 속성에 해당하는 공백으로 구분된 key=value 쌍입니다. 지원 event_notifier 되는 키 값은 (필수), (필수), nameobservability_mode (none 또는 log), sampling_interval (int), queue_size (int)입니다. --event는 1회 이상 사용할 수 있습니다. 전체 매개 변수 사용에 대한 도움말 예제를 검토합니다.

속성	값
매개 변수 그룹:	Event Arguments

--hardware-revision --hr

하드웨어 수정 버전입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--ig --instance-resource-group

인스턴스 리소스 그룹입니다. 제공되지 않으면 자산 리소스 그룹이 사용됩니다.

--location -l

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

--manufacturer

Manufacturer.

속성	값
매개 변수 그룹:	Additional Info Arguments

--manufacturer-uri --mu

제조업체 URI.

속성	값
매개 변수 그룹:	Additional Info Arguments

--model

Model.

속성	값
매개 변수 그룹:	Additional Info Arguments

--pc --product-code

제품 코드입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--serial-number --sn

일련 번호.

속성	값
매개 변수 그룹:	Additional Info Arguments

--software-revision --sr

소프트웨어 수정 버전입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--tags

자산 리소스 태그입니다. a=b c=d 형식의 키-값 쌍의 속성 모음입니다.

--topic-path --tp

기본 항목 경로입니다.

속성	값
매개 변수 그룹:	MQTT Topic Default Arguments

--topic-retain --tr

기본 항목은 정책을 유지합니다.

속성	값
매개 변수 그룹:	MQTT Topic Default Arguments
허용되는 값:	Keep, Never

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot ops asset delete

자산을 삭제합니다.

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

예제

자산을 삭제합니다.

az iot ops asset delete --name myasset -g myresourcegroup

필수 매개 변수

--name -n

자산 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot ops asset query

자산에 대한 Resource Graph를 쿼리합니다.

az iot ops asset query [--cq --custom-query]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name --dn]
                       [--documentation-uri --du]
                       [--eai --external-asset-id]
                       [--endpoint-profile --ep]
                       [--hardware-revision --hr]
                       [--ig --instance-resource-group]
                       [--instance]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri --mu]
                       [--model]
                       [--name]
                       [--pc --product-code]
                       [--resource-group]
                       [--serial-number --sn]
                       [--software-revision --sr]
                       [--topic-path --tp]
                       [--topic-retain --tr {Keep, Never}]

예제

지정된 리소스 그룹 내에서 사용하지 않도록 설정된 자산을 쿼리합니다.

az iot ops asset query -g myresourcegroup --disabled

지정된 모델, 제조업체 및 일련 번호가 있는 자산을 쿼리합니다.

az iot ops asset query --model model1 --manufacturer contoso --serial-number 000-000-ABC10

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--cq --custom-query

사용할 사용자 지정 쿼리입니다. 다른 모든 쿼리 인수는 무시됩니다.

--description -d

Description.

--disabled

자산의 상태입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments
허용되는 값:	false, true

--display-name --dn

표시 이름입니다.

--documentation-uri --du

설명서 URI.

속성	값
매개 변수 그룹:	Additional Info Arguments

--eai --external-asset-id

외부 자산 ID입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--endpoint-profile --ep

자산 엔드포인트 프로필 이름입니다.

--hardware-revision --hr

하드웨어 수정 버전입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--ig --instance-resource-group

인스턴스 리소스 그룹입니다. 제공되지 않으면 자산 리소스 그룹이 사용됩니다.

--instance

만든 자산을 연결할 인스턴스 이름입니다.

--location -l

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

--manufacturer

Manufacturer.

속성	값
매개 변수 그룹:	Additional Info Arguments

--manufacturer-uri --mu

제조업체 URI.

속성	값
매개 변수 그룹:	Additional Info Arguments

--model

Model.

속성	값
매개 변수 그룹:	Additional Info Arguments

--name -n

자산 이름입니다.

--pc --product-code

제품 코드입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

--serial-number --sn

일련 번호.

속성	값
매개 변수 그룹:	Additional Info Arguments

--software-revision --sr

소프트웨어 수정 버전입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--topic-path --tp

기본 항목 경로입니다.

속성	값
매개 변수 그룹:	MQTT Topic Default Arguments

--topic-retain --tr

기본 항목은 정책을 유지합니다.

속성	값
매개 변수 그룹:	MQTT Topic Default Arguments
허용되는 값:	Keep, Never

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot ops asset show

자산을 표시합니다.

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

예제

자산의 세부 정보를 표시합니다.

az iot ops asset show --name myasset -g myresourcegroup

필수 매개 변수

--name -n

자산 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az iot ops asset update

자산을 업데이트합니다.

데이터 세트 및 이벤트를 업데이트하려면 명령 그룹 az iot ops asset dataset 및 az iot ops asset event 각각을 사용하세요.

az iot ops asset update --name
                        --resource-group
                        [--attr --custom-attribute]
                        [--dataset-publish-int --dpi]
                        [--dataset-queue-size --dqs]
                        [--dataset-sample-int --dsi]
                        [--description]
                        [--disable {false, true}]
                        [--display-name --dn]
                        [--documentation-uri --du]
                        [--epi --event-publish-int]
                        [--eqs --event-queue-size]
                        [--esi --event-sample-int]
                        [--hardware-revision --hr]
                        [--manufacturer]
                        [--manufacturer-uri --mu]
                        [--model]
                        [--pc --product-code]
                        [--serial-number --sn]
                        [--software-revision --sr]
                        [--tags]
                        [--topic-path --tp]
                        [--topic-retain --tr {Keep, Never}]

예제

자산의 데이터 세트 및 이벤트 기본값을 업데이트합니다.

az iot ops asset update --name myasset -g myresourcegroup --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50

자산의 설명, 설명서 URI, 하드웨어 수정 버전, 제품 코드 및 소프트웨어 수정 버전을 업데이트합니다.

az iot ops asset update --name myasset -g myresourcegroup --description "Updated test asset description." --documentation-uri www.contoso.com --hardware-revision 11.0 --product-code XXX102 --software-revision 0.2

자산의 제조업체, 제조업체 URI, 모델, 일련 번호 및 사용자 지정 특성을 업데이트합니다.

az iot ops asset update --name myasset -g myresourcegroup --manufacturer Contoso --manufacturer-uri constoso2.com --model NewAssetModel --serial-number 000-000-ABC11 --custom-attribute work_location=new_factory --custom-attribute secondary_work_location=factory

자산을 사용하지 않도록 설정하고 "work_site"라는 사용자 지정 특성을 제거합니다.

az iot ops asset update --name myasset -g myresourcegroup --disable --custom-attribute work_site=""

필수 매개 변수

--name -n

자산 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--attr --custom-attribute

자산에 대한 추가 사용자 지정 특성에 해당하는 공백으로 구분된 key=value 쌍입니다. 이 매개 변수는 두 번 이상 사용할 수 있습니다. 사용자 지정 특성을 제거하려면 특성의 값을 ""로 설정하세요.

속성	값
매개 변수 그룹:	Additional Info Arguments

--dataset-publish-int --dpi

데이터 세트에 대한 기본 게시 간격입니다.

속성	값
매개 변수 그룹:	Dataset Default Arguments

--dataset-queue-size --dqs

데이터 세트의 기본 큐 크기입니다.

속성	값
매개 변수 그룹:	Dataset Default Arguments

--dataset-sample-int --dsi

데이터 세트의 기본 샘플링 간격(밀리초)입니다.

속성	값
매개 변수 그룹:	Dataset Default Arguments

--description -d

Description.

--disable

자산을 사용하지 않도록 설정합니다.

속성	값
허용되는 값:	false, true

--display-name --dn

표시 이름입니다.

--documentation-uri --du

설명서 URI.

속성	값
매개 변수 그룹:	Additional Info Arguments

--epi --event-publish-int

이벤트에 대한 기본 게시 간격입니다.

속성	값
매개 변수 그룹:	Event Default Arguments

--eqs --event-queue-size

이벤트의 기본 큐 크기입니다.

속성	값
매개 변수 그룹:	Event Default Arguments

--esi --event-sample-int

이벤트에 대한 기본 샘플링 간격(밀리초)입니다.

속성	값
매개 변수 그룹:	Event Default Arguments

--hardware-revision --hr

하드웨어 수정 버전입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--manufacturer

Manufacturer.

속성	값
매개 변수 그룹:	Additional Info Arguments

--manufacturer-uri --mu

제조업체 URI.

속성	값
매개 변수 그룹:	Additional Info Arguments

--model

Model.

속성	값
매개 변수 그룹:	Additional Info Arguments

--pc --product-code

제품 코드입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--serial-number --sn

일련 번호.

속성	값
매개 변수 그룹:	Additional Info Arguments

--software-revision --sr

소프트웨어 수정 버전입니다.

속성	값
매개 변수 그룹:	Additional Info Arguments

--tags

자산 리소스 태그입니다. a=b c=d 형식의 키-값 쌍의 속성 모음입니다.

--topic-path --tp

기본 항목 경로입니다.

속성	값
매개 변수 그룹:	MQTT Topic Default Arguments

--topic-retain --tr

기본 항목은 정책을 유지합니다.

속성	값
매개 변수 그룹:	MQTT Topic Default Arguments
허용되는 값:	Keep, Never

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False