az iot ops asset

  • Preview
  • Reference

Poznámka:

Tento odkaz je součástí rozšíření azure-iot-ops pro Azure CLI (verze 2.46.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í Náhled
az iot ops asset data-point

Správa datových bodů v assetu

 Rozšíření Náhled
az iot ops asset data-point add

Přidejte datový bod k prostředku.

 Rozšíření Náhled
az iot ops asset data-point list

Výpis datových bodů v assetu

 Rozšíření Náhled
az iot ops asset data-point remove

Odeberte datový bod v assetu.

 Rozšíření Náhled
az iot ops asset delete

Odstraňte prostředek.

 Rozšíření Náhled
az iot ops asset endpoint

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

 Rozšíření Náhled
az iot ops asset endpoint certificate

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

 Rozšíření Náhled
az iot ops asset endpoint certificate add

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

 Rozšíření Náhled
az iot ops asset endpoint certificate list

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

 Rozšíření Náhled
az iot ops asset endpoint certificate remove

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

 Rozšíření Náhled
az iot ops asset endpoint create

Vytvoření koncového bodu prostředku

 Rozšíření Náhled
az iot ops asset endpoint delete

Odstranění koncového bodu prostředku

 Rozšíření Náhled
az iot ops asset endpoint query

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

 Rozšíření Náhled
az iot ops asset endpoint show

Zobrazení koncového bodu prostředku

 Rozšíření Náhled
az iot ops asset endpoint update

Aktualizace koncového bodu prostředku

 Rozšíření Náhled
az iot ops asset event

Správa událostí v prostředku

 Rozšíření Náhled
az iot ops asset event add

Přidejte událost k prostředku.

 Rozšíření Náhled
az iot ops asset event list

Výpis událostí v assetu

 Rozšíření Náhled
az iot ops asset event remove

Odeberte událost v prostředku.

 Rozšíření Náhled
az iot ops asset query

Zadejte dotaz na Resource Graph pro prostředky.

 Rozšíření Náhled
az iot ops asset show

Zobrazit prostředek

 Rozšíření Náhled
az iot ops asset update

Aktualizujte prostředek.

 Rozšíření Náhled

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.

az iot ops asset create --endpoint
                        --name
                        --resource-group
                        [--asset-type]
                        [--cl]
                        [--clrg]
                        [--cls]
                        [--cluster]
                        [--cluster-resource-group]
                        [--cluster-subscription]
                        [--data]
                        [--data-publish-int]
                        [--data-queue-size]
                        [--data-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--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 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 asset s danými předem vyplněnými hodnotami.

az iot ops asset create --name MyAsset -g MyRg --custom-location MyLocation --endpoint example.com --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

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.

--cl --custom-location

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

--clrg --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-resource-group --crg

Skupina prostředků pro cluster

--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_sizesampling_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-publish-int --dpi

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

výchozí hodnota: 1000
--data-queue-size --dqs

Výchozí velikost fronty pro datové body

výchozí hodnota: 1
--data-sample-int --dsi

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

výchozí hodnota: 500
--description -d

Popis.

--disable

Zakažte prostředek.

přijímané hodnoty: false, true
výchozí hodnota: False
--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í

výchozí hodnota: 1000
--eqs --event-queue-size

Výchozí velikost fronty pro události

výchozí hodnota: 1
--esi --event-sample-int

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

výchozí hodnota: 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í klíčové hodnoty: capability_id, (povinné), name, observability_mode (žádné, měřidlo, čítač, histogram nebo protokol), (int), queue_sizesampling_interval (int event_notifier ). --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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: 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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: 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řijímané 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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: 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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: 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]
                        [--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 aktiva, identifikátor URI výrobce, model, sériové číslo.

az iot ops asset update --name {asset_name} -g {resource_group} --manufacturer {manufacturer} --manufacturer-uri {manufacturer_uri} --model {model} --serial-number {serial_number}

Zakažte prostředek.

az iot ops asset update --name {asset_name} -g {resource_group} --disable

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.

--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řijímané 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řijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: 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.