Delen via


az iot ops asset

Note

Deze verwijzing maakt deel uit van de azure-iot-ops-extensie voor de Azure CLI (versie 2.67.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az iot ops asset-opdracht uitvoert. Meer informatie over uitbreidingen.

Vermogensbeheer.

Deze opdrachtgroep is van toepassing op klassieke assets. Gebruik az iot ops ns opdrachten voor naamruimteasset (nieuwste versie). Meer informatie over assetbeheer vindt u op aka.ms/asset-overview.

Opdracht

Name Description Type Status
az iot ops asset create

Maak een asset.

Extension GA
az iot ops asset dataset

Gegevenssets in een asset beheren.

Extension GA
az iot ops asset dataset list

Lijst met gegevenssets binnen een asset.

Extension GA
az iot ops asset dataset point

Gegevenspunten in een assetgegevensset beheren.

Extension GA
az iot ops asset dataset point add

Voeg een gegevenspunt toe aan een assetgegevensset.

Extension GA
az iot ops asset dataset point export

Gegevenspunten exporteren in een assetgegevensset.

Extension GA
az iot ops asset dataset point import

Gegevenspunten importeren in een assetgegevensset.

Extension GA
az iot ops asset dataset point list

Gegevenspunten weergeven in een assetgegevensset.

Extension GA
az iot ops asset dataset point remove

Verwijder een gegevenspunt in een assetgegevensset.

Extension GA
az iot ops asset dataset show

Een gegevensset in een asset weergeven.

Extension GA
az iot ops asset delete

Een asset verwijderen.

Extension GA
az iot ops asset endpoint

Asseteindpuntprofielen beheren.

Extension GA
az iot ops asset endpoint create

Asseteindpuntprofielen maken.

Extension GA
az iot ops asset endpoint create opcua

Maak een asseteindpuntprofiel voor een OPCUA-connector.

Extension GA
az iot ops asset endpoint delete

Een asseteindpuntprofiel verwijderen.

Extension GA
az iot ops asset endpoint query

Voer een query uit op resourcegrafiek voor eindpuntprofielen voor assets.

Extension GA
az iot ops asset endpoint show

Een asseteindpuntprofiel weergeven.

Extension GA
az iot ops asset endpoint update

Werk een asseteindpuntprofiel bij.

Extension GA
az iot ops asset event

Gebeurtenissen in een asset beheren.

Extension GA
az iot ops asset event add

Voeg een gebeurtenis toe aan een asset.

Extension GA
az iot ops asset event export

Gebeurtenissen in een asset exporteren.

Extension GA
az iot ops asset event import

Gebeurtenissen in een asset importeren.

Extension GA
az iot ops asset event list

Gebeurtenissen in een asset weergeven.

Extension GA
az iot ops asset event remove

Een gebeurtenis in een asset verwijderen.

Extension GA
az iot ops asset query

Voer een query uit op resourcegrafiek voor assets.

Extension GA
az iot ops asset show

Een asset weergeven.

Extension GA
az iot ops asset update

Een asset bijwerken.

Extension GA

az iot ops asset create

Maak een asset.

Zie aka.ms/aziotops-assets voor voorbeelden van bestandsindelingen.

az iot ops asset create --endpoint-profile --ep
                        --instance
                        --name
                        --resource-group
                        [--attr --custom-attribute]
                        [--dataset-publish-int --dpi]
                        [--dataset-queue-size --dqs]
                        [--dataset-sample-int --dsi]
                        [--description]
                        [--disable {false, true}]
                        [--display-name --dn]
                        [--documentation-uri --du]
                        [--eai --external-asset-id]
                        [--ef --event-file]
                        [--epi --event-publish-int]
                        [--eqs --event-queue-size]
                        [--esi --event-sample-int]
                        [--event]
                        [--hardware-revision --hr]
                        [--ig --instance-resource-group]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri --mu]
                        [--model]
                        [--pc --product-code]
                        [--serial-number --sn]
                        [--software-revision --sr]
                        [--tags]
                        [--topic-path --tp]
                        [--topic-retain --tr {Keep, Never}]

Voorbeelden

Maak een asset met behulp van het opgegeven exemplaar in dezelfde resourcegroep.

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

Maak een asset met behulp van het opgegeven exemplaar in een andere resourcegroep, maar hetzelfde abonnement. Houd er rekening mee dat de Digital Operations Experience de asset mogelijk niet weergeeft als deze zich in een ander abonnement bevindt dan het exemplaar.

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

Maak een uitgeschakelde asset met behulp van een bestand met gebeurtenissen.

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

Maak een asset met de opgegeven vooraf ingevulde waarden.

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

Vereiste parameters

--endpoint-profile --ep

Naam van asseteindpuntprofiel.

--instance

Instantienaam waaraan de gemaakte asset moet worden gekoppeld.

--name -n

Assetnaam.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--attr --custom-attribute

Door spaties gescheiden sleutelparen=waardeparen die overeenkomen met aanvullende aangepaste kenmerken voor de asset. Deze parameter kan meerdere keren worden gebruikt.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--dataset-publish-int --dpi

Standaardpublicatie-interval voor gegevenssets.

Eigenschap Waarde
Parametergroep: Dataset Default Arguments
Default value: 1000
--dataset-queue-size --dqs

Standaardwachtrijgrootte voor gegevenssets.

Eigenschap Waarde
Parametergroep: Dataset Default Arguments
Default value: 1
--dataset-sample-int --dsi

Standaardsamplingsinterval (in milliseconden) voor gegevenssets.

Eigenschap Waarde
Parametergroep: Dataset Default Arguments
Default value: 500
--description -d

Description.

--disable

Schakel een asset uit.

Eigenschap Waarde
Default value: False
Geaccepteerde waarden: false, true
--display-name --dn

Weergavenaam.

--documentation-uri --du

Documentatie-URI.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--eai --external-asset-id

Externe asset-id.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--ef --event-file

Bestandspad voor het bestand met de gebeurtenissen. De volgende bestandstypen worden ondersteund: json, csv, yaml.

Eigenschap Waarde
Parametergroep: Event Arguments
--epi --event-publish-int

Standaardpublicatie-interval voor gebeurtenissen.

Eigenschap Waarde
Parametergroep: Event Default Arguments
Default value: 1000
--eqs --event-queue-size

Standaardwachtrijgrootte voor gebeurtenissen.

Eigenschap Waarde
Parametergroep: Event Default Arguments
Default value: 1
--esi --event-sample-int

Standaardsamplingsinterval (in milliseconden) voor gebeurtenissen.

Eigenschap Waarde
Parametergroep: Event Default Arguments
Default value: 500
--event

Door spaties gescheiden sleutelparen=waardeparen die overeenkomen met eigenschappen van de gebeurtenis die moeten worden gemaakt. De volgende sleutelwaarden worden ondersteund: event_notifier (vereist), name (vereist), observability_mode (geen of logboek), sampling_interval (int), queue_size (int). --event kan 1 of meer keer worden gebruikt. Bekijk help-voorbeelden voor volledig parametergebruik.

Eigenschap Waarde
Parametergroep: Event Arguments
--hardware-revision --hr

Hardwarerevisie.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--ig --instance-resource-group

Resourcegroep exemplaar. Als deze niet is opgegeven, wordt de assetresourcegroep gebruikt.

--location -l

Location. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--manufacturer

Manufacturer.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--manufacturer-uri --mu

Fabrikant-URI.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--model

Model.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--pc --product-code

Productcode.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--serial-number --sn

Serienummer.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--software-revision --sr

Softwarerevisie.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--tags

Assetresourcetags. Eigenschapsverzameling in sleutel-waardeparen met de volgende indeling: a=b c=d.

--topic-path --tp

Standaardonderwerppad.

Eigenschap Waarde
Parametergroep: MQTT Topic Default Arguments
--topic-retain --tr

Standaardonderwerp behoudt beleid.

Eigenschap Waarde
Parametergroep: MQTT Topic Default Arguments
Geaccepteerde waarden: Keep, Never
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az iot ops asset delete

Een asset verwijderen.

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

Voorbeelden

Een asset verwijderen.

az iot ops asset delete --name myasset -g myresourcegroup

Vereiste parameters

--name -n

Assetnaam.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az iot ops asset query

Voer een query uit op resourcegrafiek voor assets.

az iot ops asset query [--cq --custom-query]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name --dn]
                       [--documentation-uri --du]
                       [--eai --external-asset-id]
                       [--endpoint-profile --ep]
                       [--hardware-revision --hr]
                       [--ig --instance-resource-group]
                       [--instance]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri --mu]
                       [--model]
                       [--name]
                       [--pc --product-code]
                       [--resource-group]
                       [--serial-number --sn]
                       [--software-revision --sr]
                       [--topic-path --tp]
                       [--topic-retain --tr {Keep, Never}]

Voorbeelden

Query uitvoeren op assets die zijn uitgeschakeld binnen een bepaalde resourcegroep.

az iot ops asset query -g myresourcegroup --disabled

Voer een query uit voor assets met het opgegeven model, de fabrikant en het serienummer.

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--cq --custom-query

Aangepaste query die moet worden gebruikt. Alle andere queryargumenten worden genegeerd.

--description -d

Description.

--disabled

Status van asset.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
Geaccepteerde waarden: false, true
--display-name --dn

Weergavenaam.

--documentation-uri --du

Documentatie-URI.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--eai --external-asset-id

Externe asset-id.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--endpoint-profile --ep

Naam van asseteindpuntprofiel.

--hardware-revision --hr

Hardwarerevisie.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--ig --instance-resource-group

Resourcegroep exemplaar. Als deze niet is opgegeven, wordt de assetresourcegroep gebruikt.

--instance

Instantienaam waaraan de gemaakte asset moet worden gekoppeld.

--location -l

Location. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--manufacturer

Manufacturer.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--manufacturer-uri --mu

Fabrikant-URI.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--model

Model.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--name -n

Assetnaam.

--pc --product-code

Productcode.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--serial-number --sn

Serienummer.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--software-revision --sr

Softwarerevisie.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--topic-path --tp

Standaardonderwerppad.

Eigenschap Waarde
Parametergroep: MQTT Topic Default Arguments
--topic-retain --tr

Standaardonderwerp behoudt beleid.

Eigenschap Waarde
Parametergroep: MQTT Topic Default Arguments
Geaccepteerde waarden: Keep, Never
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az iot ops asset show

Een asset weergeven.

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

Voorbeelden

De details van een asset weergeven.

az iot ops asset show --name myasset -g myresourcegroup

Vereiste parameters

--name -n

Assetnaam.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az iot ops asset update

Een asset bijwerken.

Als u gegevenssets en gebeurtenissen wilt bijwerken, gebruikt u respectievelijk de opdrachtgroepen az iot ops asset datasetaz iot ops asset event .

az iot ops asset update --name
                        --resource-group
                        [--attr --custom-attribute]
                        [--dataset-publish-int --dpi]
                        [--dataset-queue-size --dqs]
                        [--dataset-sample-int --dsi]
                        [--description]
                        [--disable {false, true}]
                        [--display-name --dn]
                        [--documentation-uri --du]
                        [--epi --event-publish-int]
                        [--eqs --event-queue-size]
                        [--esi --event-sample-int]
                        [--hardware-revision --hr]
                        [--manufacturer]
                        [--manufacturer-uri --mu]
                        [--model]
                        [--pc --product-code]
                        [--serial-number --sn]
                        [--software-revision --sr]
                        [--tags]
                        [--topic-path --tp]
                        [--topic-retain --tr {Keep, Never}]

Voorbeelden

Werk de standaardinstellingen voor de gegevensset en gebeurtenis van een asset bij.

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

Werk de beschrijving van een asset, documentatie-URI, hardwarerevisie, productcode en softwarerevisie bij.

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

Werk de fabrikant, de fabrikant-URI, het model, het serienummer en het aangepaste kenmerk van een asset bij.

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

Schakel een asset uit en verwijder een aangepast kenmerk met de naam 'work_site'.

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

Vereiste parameters

--name -n

Assetnaam.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--attr --custom-attribute

Door spaties gescheiden sleutelparen=waardeparen die overeenkomen met aanvullende aangepaste kenmerken voor de asset. Deze parameter kan meerdere keren worden gebruikt. Als u een aangepast kenmerk wilt verwijderen, stelt u de waarde van het kenmerk in op ''.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--dataset-publish-int --dpi

Standaardpublicatie-interval voor gegevenssets.

Eigenschap Waarde
Parametergroep: Dataset Default Arguments
--dataset-queue-size --dqs

Standaardwachtrijgrootte voor gegevenssets.

Eigenschap Waarde
Parametergroep: Dataset Default Arguments
--dataset-sample-int --dsi

Standaardsamplingsinterval (in milliseconden) voor gegevenssets.

Eigenschap Waarde
Parametergroep: Dataset Default Arguments
--description -d

Description.

--disable

Schakel een asset uit.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--display-name --dn

Weergavenaam.

--documentation-uri --du

Documentatie-URI.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--epi --event-publish-int

Standaardpublicatie-interval voor gebeurtenissen.

Eigenschap Waarde
Parametergroep: Event Default Arguments
--eqs --event-queue-size

Standaardwachtrijgrootte voor gebeurtenissen.

Eigenschap Waarde
Parametergroep: Event Default Arguments
--esi --event-sample-int

Standaardsamplingsinterval (in milliseconden) voor gebeurtenissen.

Eigenschap Waarde
Parametergroep: Event Default Arguments
--hardware-revision --hr

Hardwarerevisie.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--manufacturer

Manufacturer.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--manufacturer-uri --mu

Fabrikant-URI.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--model

Model.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--pc --product-code

Productcode.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--serial-number --sn

Serienummer.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--software-revision --sr

Softwarerevisie.

Eigenschap Waarde
Parametergroep: Additional Info Arguments
--tags

Assetresourcetags. Eigenschapsverzameling in sleutel-waardeparen met de volgende indeling: a=b c=d.

--topic-path --tp

Standaardonderwerppad.

Eigenschap Waarde
Parametergroep: MQTT Topic Default Arguments
--topic-retain --tr

Standaardonderwerp behoudt beleid.

Eigenschap Waarde
Parametergroep: MQTT Topic Default Arguments
Geaccepteerde waarden: Keep, Never
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False