다음을 통해 공유

az iot ops asset

  • 미리 보기
  • 참조

참고 항목

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

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

자산을 관리합니다.

명령

Name Description 형식 상태
az iot ops asset create

자산을 만듭니다.

 내선 번호 프리뷰
az iot ops asset data-point

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

 내선 번호 프리뷰
az iot ops asset data-point add

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

 내선 번호 프리뷰
az iot ops asset data-point export

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

 내선 번호 프리뷰
az iot ops asset data-point import

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

 내선 번호 프리뷰
az iot ops asset data-point list

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

 내선 번호 프리뷰
az iot ops asset data-point remove

자산에서 데이터 포인트를 제거합니다.

 내선 번호 프리뷰
az iot ops asset delete

자산을 삭제합니다.

 내선 번호 프리뷰
az iot ops asset endpoint

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

 내선 번호 프리뷰
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 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

미리 보기

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

자산을 만듭니다.

사용자 지정 위치 또는 클러스터 이름을 제공해야 합니다. 이 명령은 연결된 사용자 지정 위치 및 클러스터의 존재 여부를 확인하고 둘 다 microsoft.deviceregistry.assets 확장으로 올바르게 설정되었는지 확인합니다.

자산을 만드는 동안 하나 이상의 데이터 요소 또는 이벤트를 정의해야 합니다. 파일 형식의 예제는 aka.ms/aziotops-assets 참조하세요.

az iot ops asset create --endpoint
                        --name
                        --resource-group
                        [--asset-type]
                        [--attr]
                        [--cg]
                        [--cl]
                        [--clg]
                        [--cls]
                        [--cluster]
                        [--cluster-subscription]
                        [--data]
                        [--data-file]
                        [--data-publish-int]
                        [--data-queue-size]
                        [--data-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--ef]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]

예제

지정된 사용자 지정 위치를 사용하여 자산을 만듭니다.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --data data_source={data_source}

지정된 사용자 지정 위치 및 사용자 지정 위치에 대한 리소스 그룹을 사용하여 자산을 만듭니다. 구독 내에 이름이 같은 사용자 지정 위치가 여러 개 있는 경우 리소스 그룹을 포함해야 합니다.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --custom-location-resource-group {custom_location_resource_group} --endpoint {endpoint} --data data_source={data_source}

지정된 클러스터 이름을 사용하여 자산을 만듭니다. 구독 내에 이름이 같은 여러 클러스터가 있는 경우 리소스 그룹을 포함해야 합니다.

az iot ops asset create --name {asset_name} -g {resource_group} --cluster {cluster} --cluster-resource-group {cluster_resource_group} --endpoint {endpoint} --event event_notifier={event_notifier}

지정된 클러스터 이름 및 사용자 지정 위치를 사용하여 자산을 만듭니다.

az iot ops asset create --name {asset_name} -g {resource_group} --cluster {cluster} --custom-location {custom_location} --endpoint {endpoint} --event event_notifier={event_notifier}

사용자 지정 데이터 요소 및 이벤트 기본값을 사용하여 자산을 만듭니다.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --data-publish-int {data_point_publishing_interval} --data-queue-size {data_point_queue_size} --data-sample-int {data_point_sampling_interval} --event-publish-int {event_publishing_interval} --event-queue-size {event_queue_size} --event-sample-int {event_sampling_interval} --event event_notifier={event_notifier}

추가 사용자 지정 특성을 사용하여 자산을 만듭니다.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --custom-attribute {attribute_key}={attribute_value} --custom-attribute {attribute_key}={attribute_value}

사용자 지정 자산 유형, 설명, 설명서 URI, 외부 자산 ID, 하드웨어 수정 버전, 제품 코드 및 소프트웨어 수정 버전을 사용하여 자산을 만듭니다.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --asset-type {asset_type} --description {description} --documentation-uri {documentation_uri} --external-asset-id {external_asset_id} --hardware-revision {hardware_revision} --product-code {product_code} --software-revision {software_revision} --data data_source={data_source}

제조업체, 제조업체 URI, 모델, 일련 번호라는 두 개의 이벤트를 사용하여 자산을 만듭니다.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --event capability_id={capability_id} event_notifier={event_notifier} name={name} observability_mode={observability_mode} sampling_interval={sampling_interval} queue_size={queue_size} --event event_notifier={event_notifier} --manufacturer {manufacturer} --manufacturer-uri {manufacturer_uri} --model {model} --serial-number {serial_number}

두 개의 데이터 요소를 사용하여 비활성화된 자산을 만듭니다.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --disable --data capability_id={capability_id} data_source={data_source} name={name} observability_mode={observability_mode} sampling_interval={sampling_interval} queue_size={queue_size} --data data_source={data_source}

데이터 요소가 포함된 파일과 이벤트를 포함하는 다른 파일을 사용하여 자산을 만듭니다.

az iot ops asset create --name MyAsset -g MyRg --custom-location MyLocation --endpoint exampleEndpoint --data-file /path/to/myasset_datapoints.json --event-file /path/to/myasset_events.csv

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

az iot ops asset create --name MyAsset -g MyRg --custom-location MyLocation --endpoint exampleEndpoint --data capability_id=myTagId data_source=NodeID1 name=myTagName1 observability_mode=counter sampling_interval=10 queue_size=2 --data data_source=NodeID2 --data-publish-int 1000 --data-queue-size 1 --data-sample-int 30 --asset-type customAsset --description 'Description for a test asset.' --documentation-uri www.help.com --external-asset-id 000-000-0000 --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

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

--name -n

자산 이름입니다.

--resource-group -g

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

선택적 매개 변수

--asset-type --at

자산 유형입니다.

--attr --custom-attribute

자산에 대한 추가 사용자 지정 특성에 해당하는 공백으로 구분된 key=value 쌍입니다.

--cg --cluster-resource-group

클러스터에 대한 리소스 그룹입니다.

--cl --custom-location

자산을 클러스터와 연결하는 데 사용되는 사용자 지정 위치입니다.

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

사용자 지정 위치에 대한 리소스 그룹입니다.

--cls --custom-location-subscription

사용자 지정 위치에 대한 구독 ID입니다. 제공되지 않으면 자산 구독 ID가 사용됩니다.

--cluster -c

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

--cluster-subscription --cs

클러스터에 대한 구독 ID입니다. 제공되지 않으면 자산 구독 ID가 사용됩니다.

--data

만들 데이터 요소의 속성에 해당하는 공백으로 구분된 key=value 쌍입니다. 지원 capability_id되는 키 값은 , data_source (필수), name( observability_mode none, 계기, 카운터, 히스토그램 또는 로그), sampling_interval (int), queue_size (int)입니다. --data는 1회 이상 사용할 수 있습니다. 전체 매개 변수 사용에 대한 도움말 예제를 검토합니다.

--data-file --df

데이터 요소를 포함하는 파일의 파일 경로입니다. 지원되는 파일 형식은 csv, json, portal-csv, yaml입니다.

--data-publish-int --dpi

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

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

데이터 요소의 기본 큐 크기입니다.

Default value: 1
--data-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

이벤트를 포함하는 파일의 파일 경로입니다. 지원되는 파일 형식은 csv, json, portal-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 쌍입니다. 지원 capability_id되는 키 값은 , event_notifier (필수), name, observability_mode (none 또는 log), sampling_interval (int), queue_size (int)입니다. --event는 1회 이상 사용할 수 있습니다. 전체 매개 변수 사용에 대한 도움말 예제를 검토합니다.

--hardware-revision --hr

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

--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 형식의 키-값 쌍의 속성 모음입니다.

전역 매개 변수
--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

미리 보기

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

자산을 삭제합니다.

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

예제

자산을 삭제합니다.

az iot ops asset delete --name {asset_name} -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 query

미리 보기

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

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

az iot ops asset query [--asset-type]
                       [--cl]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint]
                       [--hardware-revision]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]

예제

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

az iot ops asset query -g {resource_group} --disabled

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

az iot ops asset query --model {model} --manufacturer {manufacturer} --serial-number {serial_number}

선택적 매개 변수

--asset-type --at

자산 유형입니다.

--cl --custom-location

자산을 클러스터와 연결하는 데 사용되는 사용자 지정 위치입니다.

--description -d

설명.

--disabled

자산의 상태입니다.

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

표시 이름.

--documentation-uri --du

설명서 URI.

--eai --external-asset-id

외부 자산 ID입니다.

--endpoint

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

--hardware-revision --hr

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

--location -l

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

--manufacturer

제조업체.

--manufacturer-uri --mu

제조업체 URI.

--model

모델.

--pc --product-code

제품 코드입니다.

--resource-group -g

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

--serial-number --sn

일련 번호.

--software-revision --sr

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

전역 매개 변수
--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

미리 보기

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

자산을 표시합니다.

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

예제

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

az iot ops asset show --name {asset_name} -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 update

미리 보기

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

자산을 업데이트합니다.

데이터 포인트 및 이벤트를 업데이트하려면 명령 그룹 az iot ops asset data-point 및 az iot ops asset events 각각을 사용하세요.

az iot ops asset update --name
                        --resource-group
                        [--asset-type]
                        [--attr]
                        [--data-publish-int]
                        [--data-queue-size]
                        [--data-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--hardware-revision]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]

예제

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

az iot ops asset update --name {asset_name} -g {resource_group} --data-publish-int {data_point_publishing_interval} --data-queue-size {data_point_queue_size} --data-sample-int {data_point_sampling_interval} --event-publish-int {event_publishing_interval} --event-queue-size {event_queue_size} --event-sample-int {event_sampling_interval}

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

az iot ops asset update --name {asset_name} -g {resource_group} --asset-type {asset_type} --description {description} --documentation-uri {documentation_uri} --external-asset-id {external_asset_id} --hardware-revision {hardware_revision} --product-code {product_code} --software-revision {software_revision}

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

az iot ops asset update --name {asset_name} -g {resource_group} --manufacturer {manufacturer} --manufacturer-uri {manufacturer_uri} --model {model} --serial-number {serial_number} --custom-attribute {attribute_key}={attribute_value}

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

az iot ops asset update --name {asset_name} -g {resource_group} --disable --custom-attribute work_site=""

필수 매개 변수

--name -n

자산 이름입니다.

--resource-group -g

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

선택적 매개 변수

--asset-type --at

자산 유형입니다.

--attr --custom-attribute

자산에 대한 추가 사용자 지정 특성에 해당하는 공백으로 구분된 key=value 쌍입니다. 사용자 지정 특성을 제거하려면 특성의 값을 ""로 설정하세요.

--data-publish-int --dpi

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

--data-queue-size --dqs

데이터 요소의 기본 큐 크기입니다.

--data-sample-int --dsi

데이터 요소에 대한 기본 샘플링 간격(밀리초)입니다.

--description -d

설명.

--disable

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

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

표시 이름.

--documentation-uri --du

설명서 URI.

--eai --external-asset-id

외부 자산 ID입니다.

--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 형식의 키-값 쌍의 속성 모음입니다.

전역 매개 변수
--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를 사용합니다.