az iot ops asset

  • Förhandsgranskning
  • Referens

Kommentar

Den här referensen är en del av azure-iot-ops-tillägget för Azure CLI (version 2.46.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az iot ops-tillgångskommando . Läs mer om tillägg.

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hantera tillgångar.

Kommandon

Name Description Typ Status
az iot ops asset create

Skapa en tillgång.

 Anknytning Förhandsversion
az iot ops asset data-point

Hantera datapunkter i en tillgång.

 Anknytning Förhandsversion
az iot ops asset data-point add

Lägg till en datapunkt i en tillgång.

 Anknytning Förhandsversion
az iot ops asset data-point export

Exportera datapunkter i en tillgång.

 Anknytning Förhandsversion
az iot ops asset data-point import

Importera datapunkter i en tillgång.

 Anknytning Förhandsversion
az iot ops asset data-point list

Visa en lista över datapunkter i en tillgång.

 Anknytning Förhandsversion
az iot ops asset data-point remove

Ta bort en datapunkt i en tillgång.

 Anknytning Förhandsversion
az iot ops asset delete

Ta bort en tillgång.

 Anknytning Förhandsversion
az iot ops asset endpoint

Hantera tillgångsslutpunktsprofiler.

 Anknytning Förhandsversion
az iot ops asset endpoint certificate

Hantera ägda certifikat i en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint certificate add

Lägg till ett ägt certifikat till en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint certificate list

Visa en lista över ägda certifikat i en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint certificate remove

Ta bort ett ägt certifikat i en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint create

Skapa en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint delete

Ta bort en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint query

Fråga Resource Graph efter tillgångsslutpunkter.

 Anknytning Förhandsversion
az iot ops asset endpoint show

Visa en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset endpoint update

Uppdatera en tillgångsslutpunkt.

 Anknytning Förhandsversion
az iot ops asset event

Hantera händelser i en tillgång.

 Anknytning Förhandsversion
az iot ops asset event add

Lägg till en händelse i en tillgång.

 Anknytning Förhandsversion
az iot ops asset event export

Exportera händelser i en tillgång.

 Anknytning Förhandsversion
az iot ops asset event import

Importera händelser i en tillgång.

 Anknytning Förhandsversion
az iot ops asset event list

Visa en lista över händelser i en tillgång.

 Anknytning Förhandsversion
az iot ops asset event remove

Ta bort en händelse i en tillgång.

 Anknytning Förhandsversion
az iot ops asset query

Fråga Resursdiagrammet efter tillgångar.

 Anknytning Förhandsversion
az iot ops asset show

Visa en tillgång.

 Anknytning Förhandsversion
az iot ops asset update

Uppdatera en tillgång.

 Anknytning Förhandsversion

az iot ops asset create

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Skapa en tillgång.

Antingen måste du ange en anpassad plats eller ett klusternamn. Det här kommandot söker efter befintligheten för den associerade anpassade platsen och klustret och ser till att båda är korrekt konfigurerade med tillägget microsoft.deviceregistry.assets.

Minst en datapunkt eller händelse måste definieras när tillgången skapas.

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]

Exempel

Skapa en tillgång med den angivna anpassade platsen.

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

Skapa en tillgång med den angivna anpassade platsen och resursgruppen för den anpassade platsen. Resursgruppen måste inkluderas om det finns flera anpassade platser med samma namn i en prenumeration.

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}

Skapa en tillgång med det angivna klusternamnet. Resursgruppen måste inkluderas om det finns flera kluster med samma namn i en prenumeration.

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}

Skapa en tillgång med det angivna klusternamnet och den anpassade platsen.

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

Skapa en tillgång med anpassade datapunkter och händelsestandarder.

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}

Skapa en tillgång med anpassad tillgångstyp, beskrivning, dokumentations-URI, externt tillgångs-ID, maskinvarurevision, produktkod och programvarurevision.

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}

Skapa en tillgång med två händelser, tillverkare, tillverkare uri, modell, serienummer.

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}

Skapa en inaktiverad tillgång med två datapunkter.

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}

Skapa en tillgång med angivna förfyllda värden.

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

Obligatoriska parametrar

--endpoint

Tillgångsslutpunktsnamn.

--name -n

Tillgångsnamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--asset-type --at

Tillgångstyp.

--cl --custom-location

Anpassad plats som används för att associera tillgång med kluster.

--clrg --custom-location-resource-group

Resursgrupp för anpassad plats.

--cls --custom-location-subscription

Prenumerations-ID för anpassad plats. Om det inte anges används tillgångsprenumerations-ID.

--cluster -c

Kluster som tillgången ska associeras med.

--cluster-resource-group --crg

Resursgrupp för kluster.

--cluster-subscription --cs

Prenumerations-ID för kluster. Om det inte anges används tillgångsprenumerations-ID.

--data

Blankstegsavgränsad nyckel=värdepar som motsvarar egenskaperna för den datapunkt som ska skapas. Följande nyckelvärden stöds: capability_id, data_source (krävs), name, observability_mode (ingen, mätare, räknare, histogram eller logg), sampling_interval (int), queue_size (int). --data kan användas 1 eller fler gånger. Granska hjälpexemplen för fullständig parameteranvändning.

--data-publish-int --dpi

Standardpubliceringsintervall för datapunkter.

standardvärde: 1000
--data-queue-size --dqs

Standardköstorlek för datapunkter.

standardvärde: 1
--data-sample-int --dsi

Standardsamplingsintervall (i millisekunder) för datapunkter.

standardvärde: 500
--description -d

Beskrivning.

--disable

Inaktivera en tillgång.

accepterade värden: false, true
standardvärde: False
--display-name --dn

Visningsnamn.

--documentation-uri --du

Dokumentations-URI.

--eai --external-asset-id

Externt tillgångs-ID.

--epi --event-publish-int

Standardpubliceringsintervall för händelser.

standardvärde: 1000
--eqs --event-queue-size

Standardköstorlek för händelser.

standardvärde: 1
--esi --event-sample-int

Standardsamplingsintervall (i millisekunder) för händelser.

standardvärde: 500
--event

Blankstegsavgränsade nyckel=värdepar som motsvarar egenskaperna för händelsen som ska skapas. Följande nyckelvärden stöds: capability_id, event_notifier (krävs), name, observability_mode (ingen, mätare, räknare, histogram eller logg), sampling_interval (int), queue_size (int). --event kan användas 1 eller fler gånger. Granska hjälpexemplen för fullständig parameteranvändning.

--hardware-revision --hr

Maskinvarurevision.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--manufacturer

Tillverkare.

--manufacturer-uri --mu

Tillverkarens URI.

--model

Modell.

--pc --product-code

Produktkod.

--serial-number --sn

Serienummer.

--software-revision --sr

Programvarurevision.

--tags

Resurstaggar. Egenskapsväska i nyckel/värde-par med följande format: a=b c=d.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops asset delete

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Ta bort en tillgång.

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

Exempel

Ta bort en tillgång.

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

Obligatoriska parametrar

--name -n

Tillgångsnamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops asset query

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Fråga Resursdiagrammet efter tillgångar.

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]

Exempel

Fråga efter tillgångar som är inaktiverade i en viss resursgrupp.

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

Fråga efter tillgångar som har den angivna modellen, tillverkaren och serienumret.

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

Valfria parametrar

--asset-type --at

Tillgångstyp.

--cl --custom-location

Anpassad plats som används för att associera tillgång med kluster.

--description -d

Beskrivning.

--disabled

Tillgångstillstånd.

accepterade värden: false, true
--display-name --dn

Visningsnamn.

--documentation-uri --du

Dokumentations-URI.

--eai --external-asset-id

Externt tillgångs-ID.

--endpoint

Tillgångsslutpunktsnamn.

--hardware-revision --hr

Maskinvarurevision.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--manufacturer

Tillverkare.

--manufacturer-uri --mu

Tillverkarens URI.

--model

Modell.

--pc --product-code

Produktkod.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--serial-number --sn

Serienummer.

--software-revision --sr

Programvarurevision.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops asset show

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Visa en tillgång.

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

Exempel

Visa information om en tillgång.

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

Obligatoriska parametrar

--name -n

Tillgångsnamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops asset update

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Uppdatera en tillgång.

Om du vill uppdatera datapunkter och händelser använder du kommandogrupperna az iot ops asset data-pointaz iot ops asset events respektive .

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]

Exempel

Uppdatera standardvärdena för en tillgångs datapunkt och händelse.

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}

Uppdatera en tillgångs tillgångstyp, beskrivning, dokumentations-URI, externt tillgångs-ID, maskinvarurevision, produktkod och programvarurevision.

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}

Uppdatera en tillgångs tillverkare, tillverkare URI, modell, serienummer.

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

Inaktivera en tillgång.

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

Obligatoriska parametrar

--name -n

Tillgångsnamn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--asset-type --at

Tillgångstyp.

--data-publish-int --dpi

Standardpubliceringsintervall för datapunkter.

--data-queue-size --dqs

Standardköstorlek för datapunkter.

--data-sample-int --dsi

Standardsamplingsintervall (i millisekunder) för datapunkter.

--description -d

Beskrivning.

--disable

Inaktivera en tillgång.

accepterade värden: false, true
--display-name --dn

Visningsnamn.

--documentation-uri --du

Dokumentations-URI.

--eai --external-asset-id

Externt tillgångs-ID.

--epi --event-publish-int

Standardpubliceringsintervall för händelser.

--eqs --event-queue-size

Standardköstorlek för händelser.

--esi --event-sample-int

Standardsamplingsintervall (i millisekunder) för händelser.

--hardware-revision --hr

Maskinvarurevision.

--manufacturer

Tillverkare.

--manufacturer-uri --mu

Tillverkarens URI.

--model

Modell.

--pc --product-code

Produktkod.

--serial-number --sn

Serienummer.

--software-revision --sr

Programvarurevision.

--tags

Resurstaggar. Egenskapsväska i nyckel/värde-par med följande format: a=b c=d.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.