Dela via

az iot ops asset

  • Referens

Kommentar

Den här referensen är en del av azure-iot-ops-tillägget för Azure CLI (version 2.53.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.

Kapitalförvaltning.

Mer information om tillgångshantering finns i aka.ms/asset-overview.

Kommandon

Name Description Typ Status
az iot ops asset create

Skapa en tillgång.

 Anknytning GA
az iot ops asset dataset

Hantera datauppsättningar i en tillgång.

 Anknytning GA
az iot ops asset dataset list

Visa en lista över datauppsättningar i en tillgång.

 Anknytning GA
az iot ops asset dataset point

Hantera datapunkter i en tillgångsdatauppsättning.

 Anknytning GA
az iot ops asset dataset point add

Lägg till en datapunkt i en tillgångsdatauppsättning.

 Anknytning GA
az iot ops asset dataset point export

Exportera datapunkter i en tillgångsdatauppsättning.

 Anknytning GA
az iot ops asset dataset point import

Importera datapunkter i en tillgångsdatauppsättning.

 Anknytning GA
az iot ops asset dataset point list

Visa en lista över datapunkter i en tillgångsdatauppsättning.

 Anknytning GA
az iot ops asset dataset point remove

Ta bort en datapunkt i en tillgångsdatauppsättning.

 Anknytning GA
az iot ops asset dataset show

Visa en datauppsättning i en tillgång.

 Anknytning GA
az iot ops asset delete

Ta bort en tillgång.

 Anknytning GA
az iot ops asset endpoint

Hantera tillgångsslutpunktsprofiler.

 Anknytning GA
az iot ops asset endpoint create

Skapa tillgångsslutpunktsprofiler.

 Anknytning GA
az iot ops asset endpoint create opcua

Skapa en tillgångsslutpunktsprofil med en OPCUA-anslutningsapp.

 Anknytning GA
az iot ops asset endpoint delete

Ta bort en tillgångsslutpunktsprofil.

 Anknytning GA
az iot ops asset endpoint query

Fråga Resource Graph efter tillgångsslutpunktsprofiler.

 Anknytning GA
az iot ops asset endpoint show

Visa en tillgångsslutpunktsprofil.

 Anknytning GA
az iot ops asset endpoint update

Uppdatera en tillgångsslutpunktsprofil.

 Anknytning GA
az iot ops asset event

Hantera händelser i en tillgång.

 Anknytning GA
az iot ops asset event add

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

 Anknytning GA
az iot ops asset event export

Exportera händelser i en tillgång.

 Anknytning GA
az iot ops asset event import

Importera händelser i en tillgång.

 Anknytning GA
az iot ops asset event list

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

 Anknytning GA
az iot ops asset event remove

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

 Anknytning GA
az iot ops asset query

Fråga Resursdiagrammet efter tillgångar.

 Anknytning GA
az iot ops asset show

Visa en tillgång.

 Anknytning GA
az iot ops asset update

Uppdatera en tillgång.

 Anknytning GA

az iot ops asset create

Skapa en tillgång.

Exempel på filformat finns i 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}]

Exempel

Skapa en tillgång med den angivna instansen i samma resursgrupp.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance

Skapa en tillgång med den angivna instansen i en annan resursgrupp men samma prenumeration. Observera att den digitala driftupplevelsen kanske inte visar tillgången om den finns i en annan prenumeration än instansen.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --instance-resource-group myinstanceresourcegroup

Skapa en inaktiverad tillgång med hjälp av en fil som innehåller händelser.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event-file /path/to/myasset_events.csv --disable

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

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

Obligatoriska parametrar

--endpoint-profile --ep

Namn på tillgångsslutpunktsprofil.

--instance

Instansnamn som den skapade tillgången ska associeras med.

--name -n

Tillgångsnamn.

--resource-group -g

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

Valfria parametrar

--attr --custom-attribute

Blankstegsavgränsade nyckel=värdepar som motsvarar ytterligare anpassade attribut för tillgången. Den här parametern kan användas mer än en gång.

--dataset-publish-int --dpi

Standardpubliceringsintervall för datauppsättningar.

Standardvärde: 1000
--dataset-queue-size --dqs

Standardköstorlek för datauppsättningar.

Standardvärde: 1
--dataset-sample-int --dsi

Standardsamplingsintervall (i millisekunder) för datauppsättningar.

Standardvärde: 500
--description -d

Beskrivning.

--disable

Inaktivera en tillgång.

Godkända värden: false, true
Standardvärde: False
--display-name --dn

Visningsnamn.

--documentation-uri --du

Dokumentations-URI.

--eai --external-asset-id

Externt tillgångs-ID.

--ef --event-file

Filsökväg för filen som innehåller händelserna. Följande filtyper stöds: json, csv, yaml.

--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: event_notifier (krävs), name (krävs), observability_mode (ingen 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.

--ig --instance-resource-group

Instansresursgrupp. Om det inte anges används resursgruppen.

--instance-subscription --is
Inaktuell

Argumentet "instance_subscription" har blivit inaktuellt och tas bort i en framtida version.

Instansprenumerations-ID. Om det inte anges används tillgångsprenumerations-ID.

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

--topic-path --tp

Standardämnessökväg.

--topic-retain --tr

Standardprincip för kvarhållning av ämne.

Godkända värden: Keep, Never
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.

Godkända 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

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 myasset -g myresourcegroup

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.

Godkända 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

Fråga Resursdiagrammet efter tillgångar.

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}]

Exempel

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

az iot ops asset query -g myresourcegroup --disabled

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

az iot ops asset query --model model1 --manufacturer contoso --serial-number 000-000-ABC10

Valfria parametrar

--cq --custom-query

Anpassad fråga som ska användas. Alla andra frågeargument ignoreras.

--description -d

Beskrivning.

--disabled

Tillgångstillstånd.

Godkända värden: false, true
--display-name --dn

Visningsnamn.

--documentation-uri --du

Dokumentations-URI.

--eai --external-asset-id

Externt tillgångs-ID.

--endpoint-profile --ep

Namn på tillgångsslutpunktsprofil.

--hardware-revision --hr

Maskinvarurevision.

--ig --instance-resource-group

Instansresursgrupp. Om det inte anges används resursgruppen.

--instance

Instansnamn som den skapade tillgången ska associeras med.

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

--name -n

Tillgångsnamn.

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

--topic-path --tp

Standardämnessökväg.

--topic-retain --tr

Standardprincip för kvarhållning av ämne.

Godkända värden: Keep, Never
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.

Godkända 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

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 myasset -g myresourcegroup

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.

Godkända 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

Uppdatera en tillgång.

Om du vill uppdatera datauppsättningar och händelser använder du kommandogrupperna az iot ops asset datasetaz iot ops asset event respektive .

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}]

Exempel

Uppdatera en tillgångs datauppsättning och händelsestandarder.

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

Uppdatera en tillgångs beskrivning, dokumentations-uri, maskinvarurevision, produktkod och programvarurevision.

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

Uppdatera en tillgångs tillverkare, tillverkarens uri, modell, serienummer och anpassade attribut.

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

Inaktivera en tillgång och ta bort ett anpassat attribut med namnet "work_site".

az iot ops asset update --name myasset -g myresourcegroup --disable --custom-attribute work_site=""

Obligatoriska parametrar

--name -n

Tillgångsnamn.

--resource-group -g

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

Valfria parametrar

--attr --custom-attribute

Blankstegsavgränsade nyckel=värdepar som motsvarar ytterligare anpassade attribut för tillgången. Den här parametern kan användas mer än en gång. Om du vill ta bort ett anpassat attribut anger du attributets värde till "".

--dataset-publish-int --dpi

Standardpubliceringsintervall för datauppsättningar.

--dataset-queue-size --dqs

Standardköstorlek för datauppsättningar.

--dataset-sample-int --dsi

Standardsamplingsintervall (i millisekunder) för datauppsättningar.

--description -d

Beskrivning.

--disable

Inaktivera en tillgång.

Godkända värden: false, true
--display-name --dn

Visningsnamn.

--documentation-uri --du

Dokumentations-URI.

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

--topic-path --tp

Standardämnessökväg.

--topic-retain --tr

Standardprincip för kvarhållning av ämne.

Godkända värden: Keep, Never
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.

Godkända 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.