Sdílet prostřednictvím

az iot ops asset

  • Preview
  • Reference

Poznámka:

Tento odkaz je součástí rozšíření azure-iot-ops pro Azure CLI (verze 2.53.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az iot ops asset . Přečtěte si další informace o rozšířeních.

Skupina příkazů iot ops je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Správa prostředků

Příkazy

Name Description Typ Stav
az iot ops asset create

Vytvořte asset.

 Rozšíření Preview
az iot ops asset data-point

Správa datových bodů v assetu

 Rozšíření Preview
az iot ops asset data-point add

Přidejte datový bod k prostředku.

 Rozšíření Preview
az iot ops asset data-point export

Exportujte datové body v assetu.

 Rozšíření Preview
az iot ops asset data-point import

Importujte datové body v assetu.

 Rozšíření Preview
az iot ops asset data-point list

Výpis datových bodů v assetu

 Rozšíření Preview
az iot ops asset data-point remove

Odeberte datový bod v assetu.

 Rozšíření Preview
az iot ops asset delete

Odstraňte prostředek.

 Rozšíření Preview
az iot ops asset endpoint

Správa profilů koncových bodů prostředku

 Rozšíření Preview
az iot ops asset endpoint certificate

Správa vlastněných certifikátů v koncovém bodu prostředku

 Rozšíření Preview
az iot ops asset endpoint certificate add

Přidejte vlastní certifikát do koncového bodu prostředku.

 Rozšíření Preview
az iot ops asset endpoint certificate list

Výpis vlastněných certifikátů v koncovém bodu prostředku

 Rozšíření Preview
az iot ops asset endpoint certificate remove

Odeberte vlastněný certifikát v koncovém bodu prostředku.

 Rozšíření Preview
az iot ops asset endpoint create

Vytvoření koncového bodu prostředku

 Rozšíření Preview
az iot ops asset endpoint delete

Odstranění koncového bodu prostředku

 Rozšíření Preview
az iot ops asset endpoint query

Zadejte dotaz na Resource Graph pro koncové body prostředků.

 Rozšíření Preview
az iot ops asset endpoint show

Zobrazení koncového bodu prostředku

 Rozšíření Preview
az iot ops asset endpoint update

Aktualizace koncového bodu prostředku

 Rozšíření Preview
az iot ops asset event

Správa událostí v prostředku

 Rozšíření Preview
az iot ops asset event add

Přidejte událost k prostředku.

 Rozšíření Preview
az iot ops asset event export

Export událostí v assetu

 Rozšíření Preview
az iot ops asset event import

Import událostí v assetu

 Rozšíření Preview
az iot ops asset event list

Výpis událostí v assetu

 Rozšíření Preview
az iot ops asset event remove

Odeberte událost v prostředku.

 Rozšíření Preview
az iot ops asset query

Zadejte dotaz na Resource Graph pro prostředky.

 Rozšíření Preview
az iot ops asset show

Zobrazit prostředek

 Rozšíření Preview
az iot ops asset update

Aktualizujte prostředek.

 Rozšíření Preview

az iot ops asset create

Preview

Skupina příkazů iot ops je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Vytvořte asset.

Je nutné zadat vlastní umístění nebo název clusteru. Tento příkaz zkontroluje existenci přidruženého vlastního umístění a clusteru a zajistí správné nastavení obou s rozšířením microsoft.deviceregistry.assets.

Při vytváření prostředku musí být definován alespoň jeden datový bod nebo událost. Příklady formátů souborů najdete v tématu 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]

Příklady

Vytvořte prostředek pomocí daného vlastního umístění.

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

Vytvořte prostředek pomocí daného vlastního umístění a skupiny prostředků pro vlastní umístění. Skupina prostředků musí být zahrnuta, pokud existuje více vlastních umístění se stejným názvem v rámci předplatného.

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}

Vytvořte prostředek s použitím daného názvu clusteru. Skupina prostředků musí být zahrnuta, pokud v rámci předplatného existuje více clusterů se stejným názvem.

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}

Vytvořte prostředek pomocí daného názvu clusteru a vlastního umístění.

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

Vytvořte prostředek s výchozími nastaveními vlastního datového bodu a události.

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}

Vytvořte prostředek s dalšími vlastními atributy.

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}

Vytvořte prostředek s vlastním typem assetu, popisem, identifikátorem URI dokumentace, ID externího prostředku, revizí hardwaru, kódem produktu a revizí softwaru.

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}

Vytvořte prostředek se dvěma událostmi, výrobcem, identifikátorem URI výrobce, modelem a sériovým číslem.

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}

Vytvořte zakázaný prostředek se dvěma datovými body.

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}

Vytvořte prostředek pomocí souboru obsahujícího datové body a jiného souboru obsahujícího události.

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

Vytvořte asset s danými předem vyplněnými hodnotami.

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

Povinné parametry

--endpoint

Název koncového bodu prostředku

--name -n

Název prostředku.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--asset-type --at

Typ prostředku.

--attr --custom-attribute

Pár klíč=hodnota oddělený mezerníkem odpovídající dalším vlastním atributům prostředku.

--cg --cluster-resource-group

Skupina prostředků pro cluster

--cl --custom-location

Vlastní umístění použité k přidružení prostředku ke clusteru

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

Skupina prostředků pro vlastní umístění

--cls --custom-location-subscription

ID předplatného pro vlastní umístění. Pokud není k dispozici, použije se ID předplatného assetu.

--cluster -c

Cluster pro přidružení prostředku.

--cluster-subscription --cs

ID předplatného pro cluster Pokud není k dispozici, použije se ID předplatného assetu.

--data

Pár klíč=hodnota oddělený mezerníkem odpovídající vlastnostem datového bodu, který se má vytvořit. Podporují se následující klíčové hodnoty: capability_id, (povinné), name, observability_mode (žádné, měřidlo, čítač, histogram nebo protokol), (int), queue_size sampling_interval (int data_source ). --data lze použít 1 nebo vícekrát. Projděte si příklady nápovědy pro úplné použití parametrů.

--data-file --df

Cesta k souboru obsahujícímu datové body. Podporují se následující typy souborů: csv, json, portal-csv, yaml.

--data-publish-int --dpi

Výchozí interval publikování datových bodů

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

Výchozí velikost fronty pro datové body

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

Výchozí interval vzorkování (v milisekundách) pro datové body

Default value: 500
--description -d

Popis.

--disable

Zakažte prostředek.

Přípustné hodnoty: false, true
Default value: False
--display-name --dn

Zobrazovaný název.

--documentation-uri --du

Identifikátor URI dokumentace

--eai --external-asset-id

ID externího prostředku

--ef --event-file

Cesta k souboru obsahujícímu události. Podporují se následující typy souborů: csv, json, portal-csv, yaml.

--epi --event-publish-int

Výchozí interval publikování událostí

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

Výchozí velikost fronty pro události

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

Výchozí interval vzorkování (v milisekundách) pro události

Default value: 500
--event

Pár klíč=hodnota oddělený mezerníkem odpovídající vlastnostem události, kterou chcete vytvořit. Podporují se následující hodnoty klíče: capability_id, event_notifier (povinné), name, observability_mode (žádné nebo protokol), sampling_interval (int), queue_size (int). --event lze použít 1 nebo vícekrát. Projděte si příklady nápovědy pro úplné použití parametrů.

--hardware-revision --hr

Revize hardwaru.

--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--manufacturer

Výrobce.

--manufacturer-uri --mu

Identifikátor URI výrobce.

--model

Model.

--pc --product-code

Kód produktu.

--serial-number --sn

Sériové číslo.

--software-revision --sr

Revize softwaru.

--tags

Značky prostředků prostředků Taška vlastností ve dvojicích klíč-hodnota s následujícím formátem: a=b c=d.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot ops asset delete

Preview

Skupina příkazů iot ops je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Odstraňte prostředek.

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

Příklady

Odstraňte prostředek.

az iot ops asset delete --name {asset_name} -g {resource_group}

Povinné parametry

--name -n

Název prostředku.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot ops asset query

Preview

Skupina příkazů iot ops je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Zadejte dotaz na Resource Graph pro prostředky.

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]

Příklady

Dotaz na prostředky, které jsou v dané skupině prostředků zakázané.

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

Dotaz na prostředky, které mají daný model, výrobce a sériové číslo

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

Volitelné parametry

--asset-type --at

Typ prostředku.

--cl --custom-location

Vlastní umístění použité k přidružení prostředku ke clusteru

--description -d

Popis.

--disabled

Stav majetku.

Přípustné hodnoty: false, true
--display-name --dn

Zobrazovaný název.

--documentation-uri --du

Identifikátor URI dokumentace

--eai --external-asset-id

ID externího prostředku

--endpoint

Název koncového bodu prostředku

--hardware-revision --hr

Revize hardwaru.

--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--manufacturer

Výrobce.

--manufacturer-uri --mu

Identifikátor URI výrobce.

--model

Model.

--pc --product-code

Kód produktu.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--serial-number --sn

Sériové číslo.

--software-revision --sr

Revize softwaru.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot ops asset show

Preview

Skupina příkazů iot ops je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Zobrazit prostředek

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

Příklady

Zobrazí podrobnosti o prostředku.

az iot ops asset show --name {asset_name} -g {resource_group}

Povinné parametry

--name -n

Název prostředku.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot ops asset update

Preview

Skupina příkazů iot ops je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Aktualizujte prostředek.

Pokud chcete aktualizovat datové body a události, použijte prosím skupiny az iot ops asset data-point příkazů a az iot ops asset events v uvedeném pořadí.

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]

Příklady

Aktualizujte výchozí hodnoty datového bodu a události prostředku.

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}

Aktualizujte typ prostředku, popis, identifikátor URI dokumentace, ID externího prostředku, revizi hardwaru, kód produktu a revizi softwaru.

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}

Aktualizujte výrobce, identifikátor URI výrobce, model, sériové číslo a vlastní atribut.

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}

Zakažte prostředek a odeberte vlastní atribut s názvem "work_site".

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

Povinné parametry

--name -n

Název prostředku.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--asset-type --at

Typ prostředku.

--attr --custom-attribute

Pár klíč=hodnota oddělený mezerníkem odpovídající dalším vlastním atributům prostředku. Pokud chcete odebrat vlastní atribut, nastavte hodnotu atributu na "".

--data-publish-int --dpi

Výchozí interval publikování datových bodů

--data-queue-size --dqs

Výchozí velikost fronty pro datové body

--data-sample-int --dsi

Výchozí interval vzorkování (v milisekundách) pro datové body

--description -d

Popis.

--disable

Zakažte prostředek.

Přípustné hodnoty: false, true
--display-name --dn

Zobrazovaný název.

--documentation-uri --du

Identifikátor URI dokumentace

--eai --external-asset-id

ID externího prostředku

--epi --event-publish-int

Výchozí interval publikování událostí

--eqs --event-queue-size

Výchozí velikost fronty pro události

--esi --event-sample-int

Výchozí interval vzorkování (v milisekundách) pro události

--hardware-revision --hr

Revize hardwaru.

--manufacturer

Výrobce.

--manufacturer-uri --mu

Identifikátor URI výrobce.

--model

Model.

--pc --product-code

Kód produktu.

--serial-number --sn

Sériové číslo.

--software-revision --sr

Revize softwaru.

--tags

Značky prostředků prostředků Taška vlastností ve dvojicích klíč-hodnota s následujícím formátem: a=b c=d.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.