Remoteverwaltung von Ressourcenkonfigurationen

Um sich bei der Einsatz-Benutzeroberfläche anzumelden, wechseln Sie in Ihrem Browser zur Einsatz-Benutzeroberfläche, und melden Sie sich mit Ihren Microsoft Entra ID-Anmeldeinformationen an.

Auswählen Ihrer Site

Nachdem der Anmeldung zeigt die Betriebsoberfläche eine Liste von Standorten an. Jede Website ist eine Sammlung von Azure IoT Einsatz-Instanzen, in denen Sie Ihre Ressourcen konfigurieren und verwalten können. Eine Website stellt in der Regel einen physischen Standort dar, an dem physische Ressourcen bereitgestellt werden. Websites erleichtern ihnen das Auffinden und Verwalten von Ressourcen. Ihr IT-Administrator ist für das Gruppieren von Instanzen in Websites verantwortlich. Azure IoT Einsatz-Instanzen, die nicht Teil einer Website sind, werden im Knoten Nicht zugewiesene Instanzen angezeigt. Wählen Sie die Site aus, die Sie verwenden möchten:

Wenn keine Sites angezeigt werden, befinden Sie sich möglicherweise nicht im richtigen Azure Active Directory-Mandanten. Sie können den Mandanten über das Menü rechts oben auf der Einsatz-Benutzeroberfläche ändern. Wenn immer noch keine Sites angezeigt werden, bedeutet das, dass Sie noch zu keinem hinzugefügt wurden. Wenden Sie sich an Ihren IT-Administrator, um Zugriff anzufordern.

Auswählen Ihrer Instanz

Nachdem Sie eine Website ausgewählt haben, wird auf der Einsatz-Benutzeroberfläche eine Liste der Azure IoT Einsatz-Instanzen angezeigt, die Teil der Website sind. Wählen Sie die Instanz aus, die Sie verwenden möchten:

Nachdem Sie Ihre Instanz ausgewählt haben, zeigt die Betriebsoberfläche die Seite Übersicht für die Instanz an. Auf der Seite Übersicht wird der Status der Instanz und der Ressourcen angezeigt, z. B. Ressourcen, die damit verknüpft sind:

Bevor Sie die az iot ops asset Befehle verwenden, melden Sie sich beim Abonnement an, das Ihre Azure IoT Operations-Bereitstellung enthält:

az login

1. Wählen Sie Ressourcenendpunkte und dann Ressourcenendpunkt erstellen aus:

   

   Tipp

   Sie können das Filterfeld verwenden, um nach Objektendpunkten zu suchen.

2. Geben Sie die folgenden Informationen für den Endpunkt ein:

   Feld	Wert
   Name	opc-ua-connector-0
   URL des Anschlusses für OPC UA	opc.tcp://opcplc-000000:50000
   Benutzerauthentifizierung	Anonymous

3. Wählen Sie Erstellen aus, um die Definition zu speichern.

Führen Sie den folgenden Befehl aus:

az iot ops asset endpoint opcua create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --instance {your instance name} 

Weitere Informationen finden Sie unter az iot ops Asset Endpoint.

1. Führen Sie die Schritte unter Konfigurieren der OPC UA-Benutzerauthentifizierung mit Benutzername und Kennwort aus, um geheime Schlüssel für Benutzername und Kennwort in Azure Key Vault hinzuzufügen und sie in Kubernetes-Cluster zu projizieren.
2. Wählen Sie auf der Einsatz-Benutzeroberfläche für das Feld Benutzerauthentifizierung Benutzername/Kennwort aus, um den Objektendpunkt so zu konfigurieren, dass diese Geheimnisse verwendet werden. Geben Sie dann die folgenden Werte für die Felder Verweis auf Benutzername und Verweis auf Kennwort ein:

1. Führen Sie die Schritte unter Konfigurieren der OPC UA-Benutzerauthentifizierung mit Benutzername und Kennwort aus, um geheime Schlüssel für Benutzername und Kennwort in Azure Key Vault hinzuzufügen und sie in Kubernetes-Cluster zu projizieren.

2. Verwenden Sie einen Befehl wie das folgende Beispiel, um Ihren Objektendpunkt zu erstellen:

   az iot ops asset endpoint opcua create --name opc-ua-connector-0 --target-address opc.tcp://opcplc-000000:50000 -g {your resource group name} --instance {your instance name} --username-ref "aio-opc-ua-broker-user-authentication/username" --password-ref "aio-opc-ua-broker-user-authentication/password"
   

So fügen Sie auf der Einsatz-Benutzeroberfläche eine Ressource hinzu:

1. Wählen Sie die Registerkarte Objekte aus. Bevor Sie Objekte erstellen, wird der folgende Bildschirm angezeigt:

   

   Tipp

   Sie können das Filterfeld verwenden, um nach Ressourcen zu suchen.

2. Wählen Sie Ressource erstellen aus.

3. Geben Sie auf dem Bildschirm „Ressourcendetails“ die folgenden Ressourceninformationen ein:

   • Ressourcenendpunkt. Wählen Sie Ihren Ressourcenendpunkt aus der Liste aus.
   • Name der Anlage
   • Beschreibung

4. Konfigurieren Sie den Satz von Eigenschaften, die Sie dem Objekt zuordnen möchten. Sie können die Standardliste der Eigenschaften akzeptieren oder Eigene hinzufügen. Die folgenden Eigenschaften sind standardmäßig verfügbar:

   • Hersteller
   • Hersteller-URI
   • Modell
   • Produktcode
   • Hardware version
   • Softwareversion
   • Seriennummer
   • Dokumentations-URI

   

5. Wählen Sie Weiter aus, um zur Seite Tags hinzufügen zu wechseln.

Hinzufügen einzelner Tags zu einer Ressource

Jetzt können Sie die Tags definieren, die der Ressource zugeordnet sind. So fügen Sie OPC UA-Tags hinzu:

1. Wählen Sie "Tag hinzufügen" oder "CSV-Tag > hinzufügen" aus.

2. Geben Sie Ihre Tagdetails ein:

   • Knoten-ID. Dieser Wert entspricht der Knoten-ID vom OPC UA-Server.
   • Tagname (optional). Dieser Wert ist der Anzeigename, den Sie für das Tag verwenden möchten. Wenn Sie keinen Tagnamen angeben, wird die Knoten-ID als Tagname verwendet.
   • Einblickmodus (optional) mit folgenden Optionen:
     • None
     • Maßstab
     • Leistungsindikator
     • Histogramm
     • Protokoll
   • Samplingintervall (Millisekunden). Sie können den Standardwert für dieses Tag überschreiben.
   • Warteschlangengröße. Sie können den Standardwert für dieses Tag überschreiben.

   

   In der folgenden Tabelle sind einige Beispieltagwerte aufgeführt, die Sie mit dem integrierten OPC PLC-Simulator verwenden können:

   Knoten-ID	Tagname	Einblickmodus
   ns=3;s=FastUInt10	Temperatur	Keine
   ns=3;s=FastUInt100	Feuchtigkeit	Keine

3. Wählen Sie Standardeinstellungen verwalten aus, um die Standard-Telemetrieeinstellungen für die Ressource zu konfigurieren. Diese Einstellungen gelten für alle OPC UA-Tags, die zu dieser Ressource gehören. Sie können diese Einstellungen für jedes von Ihnen hinzugefügte Tag überschreiben. Zu den Standard-Telemetrieeinstellungen gehören:

   • Samplingintervall (Millisekunden): Das Samplingintervall gibt die schnellste Rate an, mit der der OPC UA-Server Stichproben von seiner zugrunde liegenden Quelle abrufen soll, um diese auf Datenänderungen zu überprüfen.
   • Veröffentlichungsintervall (Millisekunden): Die Rate, mit der der OPC UA-Server Daten veröffentlichen soll
   • Warteschlangengröße: Die Größe der Warteschlange zum Speichern der Samplingdaten, bevor sie veröffentlicht werden.

Massenhinzufügen von Tags zu einer Ressource

Sie können bis zu 1.000 OPC UA-Tags gleichzeitig aus einer CSV-Datei importieren:

1. Erstellen Sie eine CSV-Datei, die wie das folgende Beispiel aussieht:

   Knoten-ID (NodeID)	TagName	QueueSize	ObservabilityMode	Samplingintervall – Millisekunden
   ns=3;s=FastUInt1000	Tag 1000	5	Keine	1.000
   ns=3;s=FastUInt1001	Tag 1001	5	Keine	1.000
   ns=3;s=FastUInt1002	Tag 1002	10	Keine	5.000

2. Wählen Sie "Tag- oder CSV-Import > CSV-Datei(.csv)" aus. Wählen Sie die CSV-Datei, die Sie erstellt haben, und anschließend Öffnen aus. Die in der CSV-Datei definierten Tags werden importiert:

   

   Wenn Sie eine CSV-Datei importieren, die Tags enthält, die Duplikate vorhandener Tags sind, wird auf der Einsatz-Benutzeroberfläche die folgende Meldung angezeigt:

   

   Sie können die doppelten Tags entweder ersetzen und neue Tags aus der Importdatei hinzufügen oder den Import abbrechen.

3. Wenn Sie alle Tags aus einer Ressource in eine CSV-Datei exportieren möchten, wählen Sie Alle exportieren und einen Speicherort für die Datei aus:

   

4. Wählen Sie auf der Seite Tags die Option Weiter aus, um zur Seite Ereignisse hinzufügen zu wechseln.

Verwenden Sie den folgenden Befehl, um mithilfe der Azure-Befehlszeilenschnittstelle eine Thermostatressource hinzuzufügen. Die Befehle fügen der Ressource mithilfe des Befehls point add zwei Tags/Datenpunkte hinzu:

# Create the asset
az iot ops asset create --name thermostat -g {your resource group name} --instance {your instance name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset'

# Add the datapoints
az iot ops asset dataset point add --asset thermostat -g {your resource group name} --dataset default --data-source 'ns=3;s=FastUInt10' --name temperature
az iot ops asset dataset point add --asset thermostat -g {your resource group name} --dataset default --data-source 'ns=3;s=FastUInt100' --name 'Tag 10'

# Show the datapoints
az iot ops asset dataset show --asset thermostat -n default -g {your resource group name}

Wenn Sie eine Ressource mithilfe der Azure CLI erstellen, können Sie Folgendes definieren:

• Mehrere Datenpunkte/Tags fügen Sie hinzu, indem Sie den Befehl point add mehrmals ausführen.
• Mehrere Ereignisse mithilfe des --event Parameters mehrmals.
• Optionale Informationen für das Objekt, z. B.:
  • Hersteller
  • Hersteller-URI
  • Modell
  • Produktcode
  • Hardware version
  • Softwareversion
  • Seriennummer
  • Dokumentations-URI
• Standardwerte für Samplingintervall, Veröffentlichungsintervall und Warteschlangengröße.
• Markieren Sie bestimmte Werte für Samplingintervalle, Veröffentlichungsintervalle und Warteschlangengröße als Datenpunkte.
• Ereignisspezifische Werte für das Veröffentlichungsintervall für das Sampling und die Warteschlangengröße.
• Der Observability-Modus für jedes Tag und jedes Ereignis

Jetzt können Sie die Ereignisse definieren, die der Ressource zugeordnet sind. So fügen Sie OPC UA-Ereignisse hinzu:

1. Wählen Sie Ereignis hinzufügen oder CSV>Ereignis hinzufügen aus.

2. Geben Sie die Ereignisdetails ein:

   • Ereignisbenachrichtigung. Dieser Wert entspricht der Ereignisbenachrichtigung vom OPC UA-Server.
   • Ereignisname (optional). Dieser Wert ist der Anzeigename, den Sie für das Ereignis verwenden möchten. Wenn Sie keinen Ereignisnamen angeben, wird die Ereignisbenachrichtigung als Ereignisname verwendet.
   • Einblickmodus (optional) mit folgenden Optionen:
     • Keine
     • Protokoll
   • Warteschlangengröße. Sie können den Standardwert für dieses Tag überschreiben.

   

3. Wählen Sie Standardeinstellungen verwalten aus, um die Standardereigniseinstellungen für die Ressource zu konfigurieren. Diese Einstellungen gelten für alle OPC UA-Ereignisse, die zu dieser Ressource gehören. Sie können diese Einstellungen für jedes von Ihnen hinzugefügte Ereignis überschreiben. Diese Standardereigniseinstellungen umfassen Folgendes:

   • Veröffentlichungsintervall (Millisekunden): Die Rate, mit der der OPC UA-Server Daten veröffentlichen soll
   • Warteschlangengröße: Die Größe der Warteschlange zum Speichern der Samplingdaten, bevor sie veröffentlicht werden.

Massenhinzufügen von Ereignissen zu einer Ressource

Sie können bis zu 1.000 OPC UA-Ereignisse gleichzeitig aus einer CSV-Datei importieren.

Wenn Sie alle Ereignisse aus einer Ressource in eine CSV-Datei exportieren möchten, wählen Sie Alle exportieren und einen Speicherort für die Datei aus.

Wählen Sie auf der Seite Ereignisse die Option Weiter aus, um zur Seite Überprüfen zu wechseln.

Änderungen überprüfen

Überprüfen Sie Ihre Angaben zur Ressource, OPC UA-Tag- und Ereignisdetails, und nehmen Sie alle ggf. gewünschten Anpassungen vor:

Wenn Sie eine Ressource mithilfe der Azure-Befehlszeilenschnittstelle erstellen, können Sie durch mehrmalige Angabe des --event-Parameters mehrere Ereignisse definieren:

az iot ops asset create --name thermostat -g {your resource group name} --cluster {your cluster name} --endpoint opc-ua-connector-0 --description 'A simulated thermostat asset' --event event_notifier='ns=3;s=FastUInt12', name=warning

Für jedes von Ihnen definierte Ereignis können Sie Folgendes angeben:

• Ereignisbenachrichtigung. Dieser Wert entspricht der Ereignisbenachrichtigung vom OPC UA-Server.
• Ereignisname. Dieser Wert ist der Anzeigename, den Sie für das Ereignis verwenden möchten. Wenn Sie keinen Ereignisnamen angeben, wird die Ereignisbenachrichtigung als Ereignisname verwendet.
• Einblickmodus.
• Warteschlangengröße.

Sie können auch die Befehle az iot ops asset event verwenden, um in Ressourcen Ereignisse hinzuzufügen und daraus zu entfernen.

Wählen Sie die zuvor erstellten Ressource aus. Verwenden Sie die Registerkarten Objektdetails, Tags und Ereignisse, um Änderungen vorzunehmen:

Auf der Registerkarte Tags können Sie Tags hinzufügen, vorhandene Tags aktualisieren oder Tags entfernen.

Um ein Tag zu aktualisieren, wählen Sie ein vorhandenes Tag aus, und aktualisieren Sie die Taginformationen. Wählen Sie dann Aktualisieren aus:

Um Tags zu entfernen, wählen Sie ein oder mehrere Tags aus, und wählen Sie dann Tags entfernen aus:

Sie können auf die gleiche Weise auch Ereignisse und Eigenschaften hinzufügen, aktualisieren und löschen.

Wenn Sie mit der Bearbeitung fertig sind, wählen Sie Speichern aus, um Ihre Änderungen zu speichern.

Verwenden Sie den folgenden Befehl, um Ihre Ressourcen auflisten zu können:

az iot ops asset query -g {your resource group name}

Verwenden Sie den folgenden Befehl, um die Details des Thermometers anzuzeigen:

az iot ops asset show --name thermostat -g {your resource group}

Verwenden Sie den az iot ops asset update Befehl, um eine Ressource zu aktualisieren. Wenn Sie beispielsweise die Beschreibung der Ressource aktualisieren möchten, verwenden Sie einen Befehl wie das folgende Beispiel:

az iot ops asset update --name thermostat --description 'A simulated thermostat asset' -g {your resource group}

Um die Tags des Thermometers auflisten zu können, verwenden Sie den folgenden Befehl:

az iot ops asset dataset show --asset thermostat --name default -g {your resource group}

Verwenden Sie den folgenden Befehl, um die Ereignisse des Thermometers auflisten zu können:

az iot ops asset event list --asset thermostat -g {your resource group}

Verwenden Sie einen Befehl wie das folgende Beispiel, um dem Enumerationsobjekt ein neues Tag hinzuzufügen:

az iot ops asset dataset point add --asset thermostat -g {your resource group name} --dataset default --data-source 'ns=3;s=FastUInt1002' --name 'humidity'

Verwenden Sie den az iot ops asset dataset point remove Befehl, um ein Tag zu löschen.

Sie können die Ereignisse eines Objekts mithilfe der az iot ops asset event Befehle verwalten.

Um eine Ressource zu löschen, wählen Sie die Ressource aus, das Sie löschen möchten. Wählen Sie auf der Detailseite der Ressource die Option Löschen aus. Bestätigen Sie Ihre Änderungen, um die Ressource zu löschen:

Um eine Ressource zu löschen, verwenden Sie einen Befehl, der wie im folgenden Beispiel aussieht:

az iot ops asset delete --name thermostat -g {your resource group name}