az iot ops asset

Notitie

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

De opdrachtgroep 'iot ops' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Assets beheren.

Opdracht

Name	Description	Type	Status
az iot ops asset create	Maak een asset.	Toestel	Preview uitvoeren
az iot ops asset data-point	Gegevenspunten in een asset beheren.	Toestel	Preview uitvoeren
az iot ops asset data-point add	Voeg een gegevenspunt toe aan een asset.	Toestel	Preview uitvoeren
az iot ops asset data-point export	Gegevenspunten in een asset exporteren.	Toestel	Preview uitvoeren
az iot ops asset data-point import	Gegevenspunten in een asset importeren.	Toestel	Preview uitvoeren
az iot ops asset data-point list	Gegevenspunten in een asset weergeven.	Toestel	Preview uitvoeren
az iot ops asset data-point remove	Een gegevenspunt in een asset verwijderen.	Toestel	Preview uitvoeren
az iot ops asset delete	Een asset verwijderen.	Toestel	Preview uitvoeren
az iot ops asset endpoint	Asseteindpuntprofielen beheren.	Toestel	Preview uitvoeren
az iot ops asset endpoint certificate	Beheer certificaten in eigendom in een asseteindpunt.	Toestel	Preview uitvoeren
az iot ops asset endpoint certificate add	Voeg een certificaat in eigendom toe aan een asseteindpunt.	Toestel	Preview uitvoeren
az iot ops asset endpoint certificate list	Certificaten in eigendom weergeven in een asseteindpunt.	Toestel	Preview uitvoeren
az iot ops asset endpoint certificate remove	Verwijder een certificaat in eigendom in een asseteindpunt.	Toestel	Preview uitvoeren
az iot ops asset endpoint create	Maak een asseteindpunt.	Toestel	Preview uitvoeren
az iot ops asset endpoint delete	Een asseteindpunt verwijderen.	Toestel	Preview uitvoeren
az iot ops asset endpoint query	Voer een query uit op resourcegrafiek voor asseteindpunten.	Toestel	Preview uitvoeren
az iot ops asset endpoint show	Een asseteindpunt weergeven.	Toestel	Preview uitvoeren
az iot ops asset endpoint update	Een asseteindpunt bijwerken.	Toestel	Preview uitvoeren
az iot ops asset event	Gebeurtenissen in een asset beheren.	Toestel	Preview uitvoeren
az iot ops asset event add	Voeg een gebeurtenis toe aan een asset.	Toestel	Preview uitvoeren
az iot ops asset event export	Gebeurtenissen in een asset exporteren.	Toestel	Preview uitvoeren
az iot ops asset event import	Gebeurtenissen in een asset importeren.	Toestel	Preview uitvoeren
az iot ops asset event list	Gebeurtenissen in een asset weergeven.	Toestel	Preview uitvoeren
az iot ops asset event remove	Een gebeurtenis in een asset verwijderen.	Toestel	Preview uitvoeren
az iot ops asset query	Voer een query uit op resourcegrafiek voor assets.	Toestel	Preview uitvoeren
az iot ops asset show	Een asset weergeven.	Toestel	Preview uitvoeren
az iot ops asset update	Een asset bijwerken.	Toestel	Preview uitvoeren

az iot ops asset create

Preview

De opdrachtgroep 'iot ops' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Maak een asset.

Er moet een aangepaste locatie of clusternaam worden opgegeven. Met deze opdracht wordt gecontroleerd op de bestaande locatie van de gekoppelde aangepaste locatie en het cluster en controleert u of beide correct zijn ingesteld met de extensie microsoft.deviceregistry.assets.

Er moet ten minste één gegevenspunt of gebeurtenis worden gedefinieerd tijdens het maken van assets. Zie aka.ms/aziotops-assets voor voorbeelden van bestandsindelingen.

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]

Voorbeelden

Maak een asset met behulp van de opgegeven aangepaste locatie.

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

Maak een asset met behulp van de opgegeven aangepaste locatie en resourcegroep voor de aangepaste locatie. De resourcegroep moet worden opgenomen als er meerdere aangepaste locaties met dezelfde naam binnen een abonnement zijn.

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}

Maak een asset met behulp van de opgegeven clusternaam. De resourcegroep moet worden opgenomen als er meerdere clusters met dezelfde naam binnen een abonnement zijn.

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}

Maak een asset met behulp van de opgegeven clusternaam en aangepaste locatie.

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

Maak een asset met aangepaste gegevenspunt- en gebeurtenisstandaarden.

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}

Maak een asset met aanvullende aangepaste kenmerken.

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}

Maak een asset met aangepast assettype, beschrijving, documentatie-URI, externe asset-id, hardwarerevisie, productcode en softwarerevisie.

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}

Maak een asset met twee gebeurtenissen, fabrikant, fabrikant-URI, model, 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}

Maak een uitgeschakelde asset met twee gegevenspunten.

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}

Maak een asset met behulp van een bestand met gegevenspunten en een ander bestand met gebeurtenissen.

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

Maak een asset met de opgegeven vooraf ingevulde waarden.

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

Vereiste parameters

--endpoint

Naam van asseteindpunt.

--name -n

Assetnaam.

--resource-group -g

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

Optionele parameters

--asset-type --at

Assettype.

--attr --custom-attribute

Door spaties gescheiden sleutelparen=waardeparen die overeenkomen met aanvullende aangepaste kenmerken voor de asset.

--cg --cluster-resource-group

Resourcegroep voor cluster.

--cl --custom-location

Aangepaste locatie die wordt gebruikt om asset te koppelen aan cluster.

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

Resourcegroep voor aangepaste locatie.

--cls --custom-location-subscription

Abonnements-id voor aangepaste locatie. Als dit niet is opgegeven, wordt de id van het assetabonnement gebruikt.

--cluster -c

Cluster waaraan de asset moet worden gekoppeld.

--cluster-subscription --cs

Abonnements-id voor cluster. Als dit niet is opgegeven, wordt de id van het assetabonnement gebruikt.

--data

Door spaties gescheiden sleutelparen=waardeparen die overeenkomen met eigenschappen van het gegevenspunt dat moet worden gemaakt. De volgende sleutelwaarden worden ondersteund: capability_id, data_source (vereist), name( observability_mode geen, meter, meter, histogram of logboek), sampling_interval (int), queue_size (int). --gegevens kunnen 1 of meer keren worden gebruikt. Bekijk help-voorbeelden voor volledig parametergebruik.

--data-file --df

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

--data-publish-int --dpi

Standaardpublicatie-interval voor gegevenspunten.

Default value: 1000

--data-queue-size --dqs

Standaardwachtrijgrootte voor gegevenspunten.

Default value: 1

--data-sample-int --dsi

Standaardsamplingsinterval (in milliseconden) voor gegevenspunten.

Default value: 500

--description -d

Beschrijving.

--disable

Schakel een asset uit.

Geaccepteerde waarden: false, true

Default value: False

--display-name --dn

Weergavenaam.

--documentation-uri --du

Documentatie-URI.

--eai --external-asset-id

Externe asset-id.

--ef --event-file

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

--epi --event-publish-int

Standaardpublicatie-interval voor gebeurtenissen.

Default value: 1000

--eqs --event-queue-size

Standaardwachtrijgrootte voor gebeurtenissen.

Default value: 1

--esi --event-sample-int

Standaardsamplingsinterval (in milliseconden) voor gebeurtenissen.

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: capability_id, event_notifier (vereist), name( 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.

--hardware-revision --hr

Hardwarerevisie.

--location -l

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

--manufacturer

Fabrikant.

--manufacturer-uri --mu

Fabrikant-URI.

--model

Model.

--pc --product-code

Productcode.

--serial-number --sn

Serienummer.

--software-revision --sr

Softwarerevisie.

--tags

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

Globale parameters

--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

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

--subscription

Naam of id van het 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.

az iot ops asset delete

Preview

De opdrachtgroep 'iot ops' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een asset verwijderen.

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

Voorbeelden

Een asset verwijderen.

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

Vereiste parameters

--name -n

Assetnaam.

--resource-group -g

De naam van de 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.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

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

--subscription

Naam of id van het 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.

az iot ops asset query

Preview

De opdrachtgroep 'iot ops' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Voer een query uit op resourcegrafiek voor assets.

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]

Voorbeelden

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

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

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

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

Optionele parameters

--asset-type --at

Assettype.

--cl --custom-location

Aangepaste locatie die wordt gebruikt om asset te koppelen aan cluster.

--description -d

Beschrijving.

--disabled

Status van asset.

Geaccepteerde waarden: false, true

--display-name --dn

Weergavenaam.

--documentation-uri --du

Documentatie-URI.

--eai --external-asset-id

Externe asset-id.

--endpoint

Naam van asseteindpunt.

--hardware-revision --hr

Hardwarerevisie.

--location -l

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

--manufacturer

Fabrikant.

--manufacturer-uri --mu

Fabrikant-URI.

--model

Model.

--pc --product-code

Productcode.

--resource-group -g

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

--serial-number --sn

Serienummer.

--software-revision --sr

Softwarerevisie.

Globale parameters

--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

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

--subscription

Naam of id van het 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.

az iot ops asset show

Preview

De opdrachtgroep 'iot ops' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een asset weergeven.

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

Voorbeelden

De details van een asset weergeven.

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

Vereiste parameters

--name -n

Assetnaam.

--resource-group -g

De naam van de 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.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

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

--subscription

Naam of id van het 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.

az iot ops asset update

Preview

De opdrachtgroep 'iot ops' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een asset bijwerken.

Als u gegevenspunten en gebeurtenissen wilt bijwerken, gebruikt u respectievelijk de opdrachtgroepenaz iot ops asset data-point.az iot ops asset events

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]

Voorbeelden

Werk het gegevenspunt en de standaardwaarden voor gebeurtenissen van een asset bij.

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}

Werk het assettype, beschrijving, documentatie-URI, externe asset-id, hardwarerevisie, productcode en softwarerevisie bij.

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}

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

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}

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

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

Vereiste parameters

--name -n

Assetnaam.

--resource-group -g

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

Optionele parameters

--asset-type --at

Assettype.

--attr --custom-attribute

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

--data-publish-int --dpi

Standaardpublicatie-interval voor gegevenspunten.

--data-queue-size --dqs

Standaardwachtrijgrootte voor gegevenspunten.

--data-sample-int --dsi

Standaardsamplingsinterval (in milliseconden) voor gegevenspunten.

--description -d

Beschrijving.

--disable

Schakel een asset uit.

Geaccepteerde waarden: false, true

--display-name --dn

Weergavenaam.

--documentation-uri --du

Documentatie-URI.

--eai --external-asset-id

Externe asset-id.

--epi --event-publish-int

Standaardpublicatie-interval voor gebeurtenissen.

--eqs --event-queue-size

Standaardwachtrijgrootte voor gebeurtenissen.

--esi --event-sample-int

Standaardsamplingsinterval (in milliseconden) voor gebeurtenissen.

--hardware-revision --hr

Hardwarerevisie.

--manufacturer

Fabrikant.

--manufacturer-uri --mu

Fabrikant-URI.

--model

Model.

--pc --product-code

Productcode.

--serial-number --sn

Serienummer.

--software-revision --sr

Softwarerevisie.

--tags

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

Globale parameters

--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

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

--subscription

Naam of id van het 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.