az iot ops asset
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
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
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. Beispiele für Dateiformate finden Sie unter aka.ms/aziotops-assets.
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]
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 zusätzlichen benutzerdefinierten Attributen.
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}
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 mithilfe einer Datei mit Datenpunkten und einer anderen Datei, die Ereignisse enthält.
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
Erstellen Sie eine Ressource mit den angegebenen vorgefüllten Werten.
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
Erforderliche Parameter
Name des Objektendpunkts.
Objektname.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Objekttyp.
Durch Leerzeichen getrennte Schlüssel=Wertpaare, die zusätzlichen benutzerdefinierten Attributen für das Objekt entsprechen.
Ressourcengruppe für Cluster.
Benutzerdefinierter Speicherort, der zum Zuordnen der Ressource zum Cluster verwendet wird.
Ressourcengruppe für benutzerdefinierte Position.
Abonnement-ID für benutzerdefinierten Speicherort. Wenn nicht angegeben, wird die Objektabonnement-ID verwendet.
Cluster, dem die Ressource zugeordnet werden soll.
Abonnement-ID für Cluster. Wenn nicht angegeben, wird die Objektabonnement-ID verwendet.
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_size
sampling_interval
(int). --Daten können 1 oder mehr verwendet werden. Überprüfen Sie Die Hilfebeispiele für die vollständige Parameterverwendung.
Dateipfad für die Datei, die die Datenpunkte enthält. Die folgenden Dateitypen werden unterstützt: csv, json, portal-csv, yaml.
Standardveröffentlichungsintervall für Datenpunkte.
Standardwarteschlangengröße für Datenpunkte.
Standard-Samplingintervall (in Millisekunden) für Datenpunkte.
Beschreibung:
Deaktivieren Sie eine Ressource.
Anzeigename.
Dokumentations-URI.
Id der externen Ressource.
Dateipfad für die Datei, die die Ereignisse enthält. Die folgenden Dateitypen werden unterstützt: csv, json, portal-csv, yaml.
Standardveröffentlichungsintervall für Ereignisse.
Standardwarteschlangengröße für Ereignisse.
Standard-Samplingintervall (in Millisekunden) für Ereignisse.
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 oder Protokoll), (int), queue_size
sampling_interval
(int). --event kann 1 oder mehr verwendet werden. Überprüfen Sie Die Hilfebeispiele für die vollständige Parameterverwendung.
Hardwarerevision.
Standort. Werte aus: az account list-locations
. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location>
konfigurieren.
Hersteller.
Hersteller-URI.
Modell.
Produktcode.
Seriennummer
Softwarerevision.
Ressourcentags für Ressourcen. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az iot ops asset delete
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
Objektname.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az iot ops asset query
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
Objekttyp.
Benutzerdefinierter Speicherort, der zum Zuordnen der Ressource zum Cluster verwendet wird.
Beschreibung:
Status des Vermögens.
Anzeigename.
Dokumentations-URI.
Id der externen Ressource.
Name des Objektendpunkts.
Hardwarerevision.
Standort. Werte aus: az account list-locations
. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location>
konfigurieren.
Hersteller.
Hersteller-URI.
Modell.
Produktcode.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Seriennummer
Softwarerevision.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az iot ops asset show
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
Objektname.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az iot ops asset update
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]
[--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]
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 und das benutzerdefinierte Attribut.
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}
Deaktivieren Sie eine Ressource, und entfernen Sie ein benutzerdefiniertes Attribut namens "work_site".
az iot ops asset update --name {asset_name} -g {resource_group} --disable --custom-attribute work_site=""
Erforderliche Parameter
Objektname.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Objekttyp.
Durch Leerzeichen getrennte Schlüssel=Wertpaare, die zusätzlichen benutzerdefinierten Attributen für das Objekt entsprechen. Um ein benutzerdefiniertes Attribut zu entfernen, legen Sie den Wert des Attributs auf "" fest.
Standardveröffentlichungsintervall für Datenpunkte.
Standardwarteschlangengröße für Datenpunkte.
Standard-Samplingintervall (in Millisekunden) für Datenpunkte.
Beschreibung:
Deaktivieren Sie eine Ressource.
Anzeigename.
Dokumentations-URI.
Id der externen Ressource.
Standardveröffentlichungsintervall für Ereignisse.
Standardwarteschlangengröße für Ereignisse.
Standard-Samplingintervall (in Millisekunden) für Ereignisse.
Hardwarerevision.
Hersteller.
Hersteller-URI.
Modell.
Produktcode.
Seriennummer
Softwarerevision.
Ressourcentags für Ressourcen. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.