다음을 통해 공유

az iot ops asset

  • 참조

참고 항목

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

자산 관리.

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

명령

Name Description 형식 상태
az iot ops asset create

자산을 만듭니다.

 내선 번호 조지아
az iot ops asset dataset

자산의 데이터 세트를 관리합니다.

 내선 번호 조지아
az iot ops asset dataset list

자산 내의 데이터 세트를 나열합니다.

 내선 번호 조지아
az iot ops asset dataset point

자산 데이터 세트의 데이터 요소를 관리합니다.

 내선 번호 조지아
az iot ops asset dataset point add

자산 데이터 세트에 데이터 포인트를 추가합니다.

 내선 번호 조지아
az iot ops asset dataset point export

자산 데이터 세트의 데이터 요소를 내보냅니다.

 내선 번호 조지아
az iot ops asset dataset point import

자산 데이터 세트의 데이터 요소를 가져옵니다.

 내선 번호 조지아
az iot ops asset dataset point list

자산 데이터 세트의 데이터 요소를 나열합니다.

 내선 번호 조지아
az iot ops asset dataset point remove

자산 데이터 세트의 데이터 포인트를 제거합니다.

 내선 번호 조지아
az iot ops asset dataset show

자산 내의 데이터 세트를 표시합니다.

 내선 번호 조지아
az iot ops asset delete

자산을 삭제합니다.

 내선 번호 조지아
az iot ops asset endpoint

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

 내선 번호 조지아
az iot ops asset endpoint create

자산 엔드포인트 프로필을 만듭니다.

 내선 번호 조지아
az iot ops asset endpoint create opcua

OPCUA 커넥터를 사용하여 자산 엔드포인트 프로필을 만듭니다.

 내선 번호 조지아
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 event

자산의 이벤트를 관리합니다.

 내선 번호 조지아
az iot ops asset event add

자산에 이벤트를 추가합니다.

 내선 번호 조지아
az iot ops asset event export

자산의 이벤트를 내보냅니다.

 내선 번호 조지아
az iot ops asset event import

자산에서 이벤트를 가져옵니다.

 내선 번호 조지아
az iot ops asset event list

자산의 이벤트를 나열합니다.

 내선 번호 조지아
az iot ops asset event remove

자산에서 이벤트를 제거합니다.

 내선 번호 조지아
az iot ops asset query

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

 내선 번호 조지아
az iot ops asset show

자산을 표시합니다.

 내선 번호 조지아
az iot ops asset update

자산을 업데이트합니다.

 내선 번호 조지아

az iot ops asset create

자산을 만듭니다.

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

az iot ops asset create --endpoint-profile
                        --instance
                        --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--ef]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--ig]
                        [--instance-subscription]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {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 쌍입니다. 이 매개 변수는 두 번 이상 사용할 수 있습니다.

--dataset-publish-int --dpi

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

Default value: 1000
--dataset-queue-size --dqs

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

Default value: 1
--dataset-sample-int --dsi

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

Default value: 500
--description -d

설명.

--disable

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

허용되는 값: false, true
Default value: False
--display-name --dn

표시 이름.

--documentation-uri --du

설명서 URI.

--eai --external-asset-id

외부 자산 ID입니다.

--ef --event-file

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

--epi --event-publish-int

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

Default value: 1000
--eqs --event-queue-size

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

Default value: 1
--esi --event-sample-int

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

Default value: 500
--event

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

--hardware-revision --hr

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

--ig --instance-resource-group

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

--instance-subscription --is
사용되지 않음

'instance_subscription' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

인스턴스 구독 ID입니다. 제공되지 않으면 자산 구독 ID가 사용됩니다.

--location -l

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

--manufacturer

제조업체.

--manufacturer-uri --mu

제조업체 URI.

--model

모델.

--pc --product-code

제품 코드입니다.

--serial-number --sn

일련 번호.

--software-revision --sr

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

--tags

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

--topic-path --tp

기본 항목 경로입니다.

--topic-retain --tr

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

허용되는 값: Keep, Never
전역 매개 변수
--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 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

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

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

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

az iot ops asset query [--cq]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint-profile]
                       [--hardware-revision]
                       [--ig]
                       [--instance]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--name]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]
                       [--topic-path]
                       [--topic-retain {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

설명.

--disabled

자산의 상태입니다.

허용되는 값: false, true
--display-name --dn

표시 이름.

--documentation-uri --du

설명서 URI.

--eai --external-asset-id

외부 자산 ID입니다.

--endpoint-profile --ep

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

--hardware-revision --hr

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

--ig --instance-resource-group

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

--instance

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

--location -l

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

--manufacturer

제조업체.

--manufacturer-uri --mu

제조업체 URI.

--model

모델.

--name -n

자산 이름입니다.

--pc --product-code

제품 코드입니다.

--resource-group -g

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

--serial-number --sn

일련 번호.

--software-revision --sr

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

--topic-path --tp

기본 항목 경로입니다.

--topic-retain --tr

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

허용되는 값: Keep, Never
전역 매개 변수
--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 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

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

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

자산을 업데이트합니다.

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

az iot ops asset update --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--hardware-revision]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {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 쌍입니다. 이 매개 변수는 두 번 이상 사용할 수 있습니다. 사용자 지정 특성을 제거하려면 특성의 값을 ""로 설정하세요.

--dataset-publish-int --dpi

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

--dataset-queue-size --dqs

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

--dataset-sample-int --dsi

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

--description -d

설명.

--disable

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

허용되는 값: false, true
--display-name --dn

표시 이름.

--documentation-uri --du

설명서 URI.

--epi --event-publish-int

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

--eqs --event-queue-size

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

--esi --event-sample-int

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

--hardware-revision --hr

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

--manufacturer

제조업체.

--manufacturer-uri --mu

제조업체 URI.

--model

모델.

--pc --product-code

제품 코드입니다.

--serial-number --sn

일련 번호.

--software-revision --sr

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

--tags

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

--topic-path --tp

기본 항목 경로입니다.

--topic-retain --tr

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

허용되는 값: Keep, Never
전역 매개 변수
--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를 사용합니다.