Share via

az iot ops asset

  • Vorschau
  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-ops-Erweiterung für die Azure CLI (Version 2.46.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

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten von Ressourcen.

Befehle

Name Beschreibung Typ Status
az iot ops asset create

Erstellen Sie ein Medienobjekt.

 Erweiterung Vorschau
az iot ops asset data-point

Verwalten von Datenpunkten in einem Objekt.

 Erweiterung Vorschau
az iot ops asset data-point add

Fügen Sie einem Objekt einen Datenpunkt hinzu.

 Erweiterung Vorschau
az iot ops asset data-point export

Exportieren von Datenpunkten in einer Ressource.

 Erweiterung Vorschau
az iot ops asset data-point import

Importieren von Datenpunkten in einer Ressource.

 Erweiterung Vorschau
az iot ops asset data-point list

Auflisten von Datenpunkten in einem Objekt.

 Erweiterung Vorschau
az iot ops asset data-point remove

Entfernen eines Datenpunkts in einer Ressource.

 Erweiterung Vorschau
az iot ops asset delete

Löschen sie eine Ressource.

 Erweiterung Vorschau
az iot ops asset endpoint

Verwalten von Objektendpunktprofilen.

 Erweiterung Vorschau
az iot ops asset endpoint certificate

Verwalten von zertifikateigenen Zertifikaten in einem Objektendpunkt.

 Erweiterung Vorschau
az iot ops asset endpoint certificate add

Fügen Sie einem Objektendpunkt ein eigenes Zertifikat hinzu.

 Erweiterung Vorschau
az iot ops asset endpoint certificate list

Auflisten von zertifikateigenen Zertifikaten in einem Objektendpunkt.

 Erweiterung Vorschau
az iot ops asset endpoint certificate remove

Entfernen Eines eigenen Zertifikats in einem Objektendpunkt.

 Erweiterung Vorschau
az iot ops asset endpoint create

Erstellen Sie einen Objektendpunkt.

 Erweiterung Vorschau
az iot ops asset endpoint delete

Löschen sie einen Objektendpunkt.

 Erweiterung Vorschau
az iot ops asset endpoint query

Abfragen des Ressourcendiagramms für Ressourcenendpunkte.

 Erweiterung Vorschau
az iot ops asset endpoint show

Anzeigen eines Objektendpunkts.

 Erweiterung Vorschau
az iot ops asset endpoint update

Aktualisieren eines Objektendpunkts.

 Erweiterung Vorschau
az iot ops asset event

Verwalten von Ereignissen in einer Ressource.

 Erweiterung Vorschau
az iot ops asset event add

Fügen Sie einem Objekt ein Ereignis hinzu.

 Erweiterung Vorschau
az iot ops asset event export

Exportieren von Ereignissen in einem Objekt.

 Erweiterung Vorschau
az iot ops asset event import

Importieren von Ereignissen in einer Ressource.

 Erweiterung Vorschau
az iot ops asset event list

Auflisten von Ereignissen in einer Ressource.

 Erweiterung Vorschau
az iot ops asset event remove

Entfernen eines Ereignisses in einer Ressource.

 Erweiterung Vorschau
az iot ops asset query

Abfragen des Ressourcendiagramms für Ressourcen.

 Erweiterung Vorschau
az iot ops asset show

Ein Objekt anzeigen.

 Erweiterung Vorschau
az iot ops asset update

Aktualisieren sie eine Ressource.

 Erweiterung Vorschau

az iot ops asset create

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen Sie ein Medienobjekt.

Entweder benutzerdefinierter Speicherort oder Clustername muss angegeben werden. Dieser Befehl sucht nach dem Vorhandensein des zugeordneten benutzerdefinierten Speicherorts und Clusters und stellt sicher, dass beide ordnungsgemäß mit der Erweiterung "microsoft.deviceregistry.assets" eingerichtet sind.

Mindestens ein Datenpunkt oder Ereignis muss während der Objekterstellung definiert werden.

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]

Beispiele

Erstellen Sie eine Ressource mithilfe des angegebenen benutzerdefinierten Speicherorts.

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

Erstellen Sie eine Ressource mithilfe des angegebenen benutzerdefinierten Speicherorts und der Ressourcengruppe für den benutzerdefinierten Speicherort. Die Ressourcengruppe muss einbezogen werden, wenn mehrere benutzerdefinierte Speicherorte mit demselben Namen innerhalb eines Abonnements vorhanden sind.

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}

Erstellen Sie eine Ressource mit dem angegebenen Clusternamen. Die Ressourcengruppe muss einbezogen werden, wenn mehrere Cluster mit demselben Namen innerhalb eines Abonnements vorhanden sind.

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}

Erstellen Sie eine Ressource mithilfe des angegebenen Clusternamens und des benutzerdefinierten Speicherorts.

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

Erstellen Sie eine Ressource mit benutzerdefinierten Datenpunkt- und Ereignisstandardeinstellungen.

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}

Erstellen Sie eine Ressource mit benutzerdefiniertem Objekttyp, Beschreibung, Dokumentations-URI, externe Objekt-ID, Hardwarerevision, Produktcode und Softwarerevision.

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}

Erstellen Sie eine Ressource mit zwei Ereignissen, Hersteller, Hersteller-URI, Modell, Seriennummer.

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}

Erstellen Sie eine deaktivierte Ressource mit zwei Datenpunkten.

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}

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

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

Erforderliche Parameter

--endpoint

Name des Objektendpunkts.

--name -n

Objektname.

--resource-group -g

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

Optionale Parameter

--asset-type --at

Objekttyp.

--cl --custom-location

Benutzerdefinierter Speicherort, der zum Zuordnen der Ressource zum Cluster verwendet wird.

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

Ressourcengruppe für benutzerdefinierte Position.

--cls --custom-location-subscription

Abonnement-ID für benutzerdefinierten Speicherort. Wenn nicht angegeben, wird die Objektabonnement-ID verwendet.

--cluster -c

Cluster, dem die Ressource zugeordnet werden soll.

--cluster-resource-group --crg

Ressourcengruppe für Cluster.

--cluster-subscription --cs

Abonnement-ID für Cluster. Wenn nicht angegeben, wird die Objektabonnement-ID verwendet.

--data

Leerzeichentrennte Schlüssel=Wertpaare, die eigenschaften des zu erstellenden Datenpunkts entsprechen. Die folgenden Schlüsselwerte werden unterstützt: capability_id, , ( data_source erforderlich), name, observability_mode (keine, Messgeräte, Zähler, Histogramm oder Protokoll), (int), queue_sizesampling_interval (int). --Daten können 1 oder mehr verwendet werden. Überprüfen Sie Die Hilfebeispiele für die vollständige Parameterverwendung.

--data-publish-int --dpi

Standardveröffentlichungsintervall für Datenpunkte.

Standardwert: 1000
--data-queue-size --dqs

Standardwarteschlangengröße für Datenpunkte.

Standardwert: 1
--data-sample-int --dsi

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

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.

--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: capability_id, , ( event_notifier erforderlich), name, observability_mode (keine, Messgeräte, Zähler, Histogramm oder Protokoll), (int), queue_sizesampling_interval (int). --event kann 1 oder mehr verwendet werden. Überprüfen Sie Die Hilfebeispiele für die vollständige Parameterverwendung.

--hardware-revision --hr

Hardwarerevision.

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

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

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

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 {asset_name} -g {resource_group}

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

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Abfragen des Ressourcendiagramms für Ressourcen.

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]

Beispiele

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

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

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

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

Optionale Parameter

--asset-type --at

Objekttyp.

--cl --custom-location

Benutzerdefinierter Speicherort, der zum Zuordnen der Ressource zum Cluster verwendet wird.

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

Name des Objektendpunkts.

--hardware-revision --hr

Hardwarerevision.

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

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

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

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

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 {asset_name} -g {resource_group}

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

Vorschau

Die Befehlsgruppe "iot ops" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Aktualisieren sie eine Ressource.

Um Datenpunkte und Ereignisse zu aktualisieren, verwenden Sie bitte die Befehlsgruppen az iot ops asset data-point bzw az iot ops asset events .

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]

Beispiele

Aktualisieren der Datenpunkt- und Ereignisstandardwerte einer Ressource.

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}

Aktualisieren Sie den Objekttyp, die Beschreibung, den Dokumentations-URI, die externe Objekt-ID, die Hardwarerevision, den Produktcode und die Softwarerevision.

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}

Aktualisieren Sie den Hersteller, den Hersteller URI, das Modell, die Seriennummer.

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

Deaktivieren Sie eine Ressource.

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

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

--asset-type --at

Objekttyp.

--data-publish-int --dpi

Standardveröffentlichungsintervall für Datenpunkte.

--data-queue-size --dqs

Standardwarteschlangengröße für Datenpunkte.

--data-sample-int --dsi

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

--description -d

Beschreibung:

--disable

Deaktivieren Sie eine Ressource.

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

Anzeigename.

--documentation-uri --du

Dokumentations-URI.

--eai --external-asset-id

Id der externen Ressource.

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

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.