Freigeben über

az iot ops asset

  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-ops-Erweiterung für die Azure CLI (Version 2.53.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az iot ops-Objektbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Vermögensverwaltung.

Weitere Informationen zur Bestandsverwaltung finden Sie unter aka.ms/asset-overview.

Befehle

Name Beschreibung Typ Status
az iot ops asset create

Erstellen Sie ein Medienobjekt.

 Erweiterung GA
az iot ops asset dataset

Verwalten von Datasets in einer Ressource.

 Erweiterung GA
az iot ops asset dataset list

Auflisten von Datasets innerhalb einer Ressource.

 Erweiterung GA
az iot ops asset dataset point

Verwalten von Datenpunkten in einem Objektdatensatz.

 Erweiterung GA
az iot ops asset dataset point add

Fügen Sie einem Objektdatensatz einen Datenpunkt hinzu.

 Erweiterung GA
az iot ops asset dataset point export

Exportieren von Datenpunkten in einem Objektdatensatz.

 Erweiterung GA
az iot ops asset dataset point import

Importieren von Datenpunkten in einem Asset-Dataset.

 Erweiterung GA
az iot ops asset dataset point list

Auflisten von Datenpunkten in einem Asset-Dataset.

 Erweiterung GA
az iot ops asset dataset point remove

Entfernen eines Datenpunkts in einem Objektdatensatz.

 Erweiterung GA
az iot ops asset dataset show

Anzeigen eines Datasets innerhalb einer Ressource.

 Erweiterung GA
az iot ops asset delete

Löschen sie eine Ressource.

 Erweiterung GA
az iot ops asset endpoint

Verwalten von Objektendpunktprofilen.

 Erweiterung GA
az iot ops asset endpoint create

Erstellen Sie Objektendpunktprofile.

 Erweiterung GA
az iot ops asset endpoint create opcua

Erstellen Sie ein Objektendpunktprofil mit einem OPCUA-Connector.

 Erweiterung GA
az iot ops asset endpoint delete

Löschen Eines Objektendpunktprofils.

 Erweiterung GA
az iot ops asset endpoint query

Abfragen des Ressourcendiagramms für Ressourcenendpunktprofile.

 Erweiterung GA
az iot ops asset endpoint show

Anzeigen eines Objektendpunktprofils.

 Erweiterung GA
az iot ops asset endpoint update

Aktualisieren sie ein Objektendpunktprofil.

 Erweiterung GA
az iot ops asset event

Verwalten von Ereignissen in einer Ressource.

 Erweiterung GA
az iot ops asset event add

Fügen Sie einem Objekt ein Ereignis hinzu.

 Erweiterung GA
az iot ops asset event export

Exportieren von Ereignissen in einem Objekt.

 Erweiterung GA
az iot ops asset event import

Importieren von Ereignissen in einer Ressource.

 Erweiterung GA
az iot ops asset event list

Auflisten von Ereignissen in einer Ressource.

 Erweiterung GA
az iot ops asset event remove

Entfernen eines Ereignisses in einer Ressource.

 Erweiterung GA
az iot ops asset query

Abfragen des Ressourcendiagramms für Ressourcen.

 Erweiterung GA
az iot ops asset show

Ein Objekt anzeigen.

 Erweiterung GA
az iot ops asset update

Aktualisieren sie eine Ressource.

 Erweiterung GA

az iot ops asset create

Erstellen Sie ein Medienobjekt.

Beispiele für Dateiformate finden Sie unter 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}]

Beispiele

Erstellen Sie eine Ressource mithilfe der angegebenen Instanz in derselben Ressourcengruppe.

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

Erstellen Sie eine Ressource mithilfe der angegebenen Instanz in einer anderen Ressourcengruppe, aber mit demselben Abonnement. Beachten Sie, dass die Digital Operations Experience die Ressource möglicherweise nicht anzeigt, wenn sie sich in einem anderen Abonnement als die Instanz befindet.

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

Erstellen Sie eine deaktivierte Ressource mithilfe einer Datei, die Ereignisse enthält.

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

Erstellen Sie eine Ressource mit den angegebenen vorgefüllten Werten.

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

Erforderliche Parameter

--endpoint-profile --ep

Name des Objektendpunktprofils.

--instance

Instanzname, dem die erstellte Ressource zugeordnet werden soll.

--name -n

Objektname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--attr --custom-attribute

Durch Leerzeichen getrennte Schlüssel=Wertpaare, die zusätzlichen benutzerdefinierten Attributen für das Objekt entsprechen. Dieser Parameter kann mehrmals verwendet werden.

--dataset-publish-int --dpi

Standardveröffentlichungsintervall für Datasets.

Standardwert: 1000
--dataset-queue-size --dqs

Standardwarteschlangengröße für Datasets.

Standardwert: 1
--dataset-sample-int --dsi

Standard-Samplingintervall (in Millisekunden) für Datasets.

Standardwert: 500
--description -d

Beschreibung:

--disable

Deaktivieren Sie eine Ressource.

Zulässige Werte: false, true
Standardwert: False
--display-name --dn

Anzeigename.

--documentation-uri --du

Dokumentations-URI.

--eai --external-asset-id

Id der externen Ressource.

--ef --event-file

Dateipfad für die Datei, die die Ereignisse enthält. Die folgenden Dateitypen werden unterstützt: json, csv, yaml.

--epi --event-publish-int

Standardveröffentlichungsintervall für Ereignisse.

Standardwert: 1000
--eqs --event-queue-size

Standardwarteschlangengröße für Ereignisse.

Standardwert: 1
--esi --event-sample-int

Standard-Samplingintervall (in Millisekunden) für Ereignisse.

Standardwert: 500
--event

Leerzeichentrennte Schlüssel=Wertpaare, die eigenschaften des zu erstellenden Ereignisses entsprechen. Die folgenden Schlüsselwerte werden unterstützt: event_notifier (erforderlich), (erforderlich), nameobservability_mode (none oder log), (int), sampling_intervalqueue_size (int). --event kann 1 oder mehr verwendet werden. Überprüfen Sie Die Hilfebeispiele für die vollständige Parameterverwendung.

--hardware-revision --hr

Hardwarerevision.

--ig --instance-resource-group

Instanzressourcengruppe. Falls nicht angegeben, wird die Ressourcengruppe "Ressourcen" verwendet.

--instance-subscription --is
Als veraltet markiert

Das Argument "instance_subscription" ist veraltet und wird in einer zukünftigen Version entfernt.

Instanzabonnement-ID. Wenn nicht angegeben, wird die Objektabonnement-ID verwendet.

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--manufacturer

Hersteller.

--manufacturer-uri --mu

Hersteller-URI.

--model

Modell.

--pc --product-code

Produktcode.

--serial-number --sn

Seriennummer

--software-revision --sr

Softwarerevision.

--tags

Ressourcentags für Ressourcen. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d.

--topic-path --tp

Standardthemapfad.

--topic-retain --tr

Standardrichtlinie für die Aufbewahrung von Themen.

Zulässige Werte: Keep, Never
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot ops asset delete

Löschen sie eine Ressource.

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

Beispiele

Löschen sie eine Ressource.

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

Erforderliche Parameter

--name -n

Objektname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot ops asset query

Abfragen des Ressourcendiagramms für Ressourcen.

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

Beispiele

Abfragen nach Ressourcen, die in einer bestimmten Ressourcengruppe deaktiviert sind.

az iot ops asset query -g myresourcegroup --disabled

Fragen Sie nach Ressourcen ab, die über das angegebene Modell, den Hersteller und die Seriennummer verfügen.

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

Optionale Parameter

--cq --custom-query

Benutzerdefinierte Abfrage, die verwendet werden soll. Alle anderen Abfrageargumente werden ignoriert.

--description -d

Beschreibung:

--disabled

Status des Vermögens.

Zulässige Werte: false, true
--display-name --dn

Anzeigename.

--documentation-uri --du

Dokumentations-URI.

--eai --external-asset-id

Id der externen Ressource.

--endpoint-profile --ep

Name des Objektendpunktprofils.

--hardware-revision --hr

Hardwarerevision.

--ig --instance-resource-group

Instanzressourcengruppe. Falls nicht angegeben, wird die Ressourcengruppe "Ressourcen" verwendet.

--instance

Instanzname, dem die erstellte Ressource zugeordnet werden soll.

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--manufacturer

Hersteller.

--manufacturer-uri --mu

Hersteller-URI.

--model

Modell.

--name -n

Objektname.

--pc --product-code

Produktcode.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--serial-number --sn

Seriennummer

--software-revision --sr

Softwarerevision.

--topic-path --tp

Standardthemapfad.

--topic-retain --tr

Standardrichtlinie für die Aufbewahrung von Themen.

Zulässige Werte: Keep, Never
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot ops asset show

Ein Objekt anzeigen.

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

Beispiele

Zeigen Sie die Details einer Ressource an.

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

Erforderliche Parameter

--name -n

Objektname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot ops asset update

Aktualisieren sie eine Ressource.

Um Datasets und Ereignisse zu aktualisieren, verwenden Sie bitte die Befehlsgruppen az iot ops asset dataset bzw az iot ops asset event .

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

Beispiele

Aktualisieren Sie das Dataset und die Ereignisstandardwerte einer Ressource.

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

Aktualisieren Sie die Beschreibung, den Dokumentations-URI, die Hardwarerevision, den Produktcode und die Softwarerevision.

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

Aktualisieren Sie den Hersteller, den Hersteller-URI, das Modell, die Seriennummer und das benutzerdefinierte 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

Deaktivieren Sie eine Ressource, und entfernen Sie ein benutzerdefiniertes Attribut namens "work_site".

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

Erforderliche Parameter

--name -n

Objektname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--attr --custom-attribute

Durch Leerzeichen getrennte Schlüssel=Wertpaare, die zusätzlichen benutzerdefinierten Attributen für das Objekt entsprechen. Dieser Parameter kann mehrmals verwendet werden. Um ein benutzerdefiniertes Attribut zu entfernen, legen Sie den Wert des Attributs auf "" fest.

--dataset-publish-int --dpi

Standardveröffentlichungsintervall für Datasets.

--dataset-queue-size --dqs

Standardwarteschlangengröße für Datasets.

--dataset-sample-int --dsi

Standard-Samplingintervall (in Millisekunden) für Datasets.

--description -d

Beschreibung:

--disable

Deaktivieren Sie eine Ressource.

Zulässige Werte: false, true
--display-name --dn

Anzeigename.

--documentation-uri --du

Dokumentations-URI.

--epi --event-publish-int

Standardveröffentlichungsintervall für Ereignisse.

--eqs --event-queue-size

Standardwarteschlangengröße für Ereignisse.

--esi --event-sample-int

Standard-Samplingintervall (in Millisekunden) für Ereignisse.

--hardware-revision --hr

Hardwarerevision.

--manufacturer

Hersteller.

--manufacturer-uri --mu

Hersteller-URI.

--model

Modell.

--pc --product-code

Produktcode.

--serial-number --sn

Seriennummer

--software-revision --sr

Softwarerevision.

--tags

Ressourcentags für Ressourcen. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d.

--topic-path --tp

Standardthemapfad.

--topic-retain --tr

Standardrichtlinie für die Aufbewahrung von Themen.

Zulässige Werte: Keep, Never
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.