Erstellen und Bereitstellen eines IoT Edge für Linux unter Windows-Geräts mithilfe von symmetrischen Schlüsseln

Gilt für: IoT Edge 1.4

Wichtig

Azure IoT Edge 1.5 LTS und IoT Edge 1.4 sind unterstützte Releases. IoT Edge 1.4 LTS erreicht das Dienstende am 12. November 2024. Wenn Sie ein früheres Release verwenden, finden Sie weitere Informationen unter Aktualisieren von IoT Edge.

Dieser Artikel enthält vollständige Anleitungen zum Registrieren und Bereitstellen eines IoT Edge für Linux unter Windows-Geräts.

Jedes Gerät, das eine Verbindung mit einem IoT-Hub herstellt, verfügt über eine Geräte-ID, die zum Nachverfolgen der Cloud-zu-Gerät- oder Gerät-zu-Cloud-Kommunikation verwendet wird. Sie konfigurieren ein Gerät mit den Verbindungsinformationen, einschließlich des IoT Hub-Hostnamens, der Geräte-ID und der Informationen, die das Gerät zum Authentifizieren bei IoT Hub verwendet.

Die Schritte in diesem Artikel führen Sie durch die sogenannte manuelle Bereitstellung, bei der Sie ein einzelnes Gerät mit dem entsprechenden IoT-Hub verbinden. Bei der manuellen Bereitstellung haben Sie zwei Optionen zum Authentifizieren von IoT Edge-Geräten:

• Symmetrische Schlüssel: Wenn Sie in IoT Hub eine neue Geräteidentität erstellen, erstellt der Dienst zwei Schlüssel. Ein Schlüssel befindet sich auf dem Gerät, den es bei der Authentifizierung in IoT Hub vorzeigt.

  Diese Authentifizierungsmethode kann schneller eingerichtet werden, ist dafür aber weniger sicher.

• selbstsignierte X.509: Sie erstellen zwei X.509-Identitätszertifikate und bewahren diese auf dem Gerät auf. Wenn Sie in IoT Hub eine neue Geräteidentität erstellen, geben Sie Fingerabdrücke aus beiden Zertifikaten an. Wenn sich das Gerät bei IoT Hub authentifiziert, übergibt es ein Zertifikat, und IoT Hub überprüft, ob das Zertifikat mit dem Fingerabdruck übereinstimmt.

  Diese Authentifizierungsmethode ist sicherer und wird für Produktionsszenarios empfohlen.

In diesem Artikel wird die Verwendung von symmetrischen Schlüsseln als Authentifizierungsmethode behandelt. Wenn Sie X.509-Zertifikate verwenden möchten, lesen Sie Erstellen und Bereitstellen eines IoT Edge für Linux unter Windows-Geräts mithilfe von X.509-Zertifikaten.

Hinweis

Wenn Sie viele Geräte einrichten müssen und sie nicht einzeln manuell bereitstellen möchten, informieren Sie sich in einem der folgenden Artikel, wie IoT Edge beim IoT Hub Device Provisioning Service (Gerätebereitstellungsdienst) funktioniert:

• Bedarfsgerechtes Erstellen und Bereitstellen von IoT Edge-Geräten mithilfe von X.509-Zertifikaten
• Bedarfsgerechtes Erstellen und Bereitstellen von IoT Edge-Geräten mit einem TPM
• Bedarfsgerechtes Erstellen und Bereitstellen von IoT Edge-Geräten mithilfe von symmetrischen Schlüsseln

Voraussetzungen

In diesem Artikel wird beschrieben, wie Sie Ihr IoT Edge-Gerät registrieren und IoT Edge für Linux unter Windows installieren. Bei diesen Aufgaben gibt es unterschiedliche Voraussetzungen und Hilfsprogramme zu deren Erledigung. Stellen Sie sicher, dass alle Voraussetzungen erfüllt sind, bevor Sie fortfahren.

Geräteverwaltungstools

Sie können die Schritte zum Registrieren Ihres Geräts über das Azure-Portal, mithilfe von Visual Studio Code oder über die Azure CLI ausführen. Jedes Dienstprogramm hat seine eigenen Voraussetzungen oder muss möglicherweise installiert werden:

Portal

Ein IoT-Hub in Ihrem Azure-Abonnement im Tarif „Free“ oder „Standard“.

Visual Studio Code

• Ein IoT-Hub in Ihrem Azure-Abonnement im Tarif „Free“ oder „Standard“
• Visual Studio Code
• Azure IoT Edge-Erweiterung. Die Erweiterung Azure IoT Edge-Tools für Visual Studio Code befindet sich im Wartungsmodus.
• Azure IoT Hub-Erweiterung

Azure-Befehlszeilenschnittstelle

• Ein IoT-Hub in Ihrem Azure-Abonnement im Tarif „Free“ oder „Standard“

• Azure CLI in Ihrer Umgebung

  Ihre Azure CLI-Version muss mindestens 2.0.70 oder höher lauten. Verwenden Sie az --version, um dies zu überprüfen. Diese Version unterstützt az-Erweiterungsbefehle und führt das Knack-Befehlsframework ein.

Geräteanforderungen

Ein Windows-Gerät mit den folgenden Mindestanforderungen:

• Systemanforderungen

  • Windows 10¹/11 (Pro, Enterprise, IoT Enterprise)
  • Windows Server 2019¹/2022
    _{¹ Windows 10 und Windows Server 2019 ab Build 17763 mit Installation aller aktuellen kumulativen Updates.}

• Hardwareanforderungen

  • Mindestens erforderlicher freier Arbeitsspeicher: 1 GB
  • Mindestens erforderlicher freier Speicherplatz: 10 GB

• Virtualisierungsunterstützung

  • Aktivieren Sie unter Windows 10 Hyper-V. Weitere Informationen finden Sie unter Installieren von Hyper-V unter Windows 10.
  • Installieren Sie unter Windows Server die Hyper-V-Rolle, und erstellen Sie einen standardmäßigen Netzwerkswitch. Weitere Informationen finden Sie unter Geschachtelte Virtualisierung für Azure IoT Edge für Linux unter Windows.
  • Konfigurieren Sie auf einer VM die geschachtelte Virtualisierung. Weitere Informationen finden Sie unter Geschachtelte Virtualisierung.

• Netzwerkunterstützung

  • Windows Server umfasst keinen Standardswitch. Bevor Sie EFLOW auf einem Windows Server-Gerät bereitstellen können, müssen Sie einen virtuellen Switch erstellen. Weitere Informationen finden Sie unter Erstellen eines virtuellen Switches.
  • Windows Desktop-Versionen umfassen einen Standardswitch, der für die EFLOW-Installation verwendet werden kann. Bei Bedarf können Sie einen benutzerdefinierten virtuellen Switch erstellen.

Tipp

Wenn Sie GPU-beschleunigte Linux-Module in Ihrer Azure IoT Edge für Linux unter Windows-Bereitstellung verwenden möchten, gibt es mehrere Konfigurationsoptionen zu berücksichtigen.

Abhängig von Ihrer GPU-Architektur müssen Sie die richtigen Treiber installieren, und Sie benötigen möglicherweise Zugriff auf einen Windows-Insider-Build. Informationen zum Ermitteln Ihrer Konfigurationsanforderungen und zum Erfüllen dieser Voraussetzungen finden Sie unter GPU-Beschleunigung für Azure IoT Edge für Linux unter Windows.

Nehmen Sie sich jetzt die Zeit, die Voraussetzungen für die GPU-Beschleunigung zu erfüllen. Sie müssen den Installationsvorgang neu starten, wenn Sie sich während der Installation für die Verwendung der GPU-Beschleunigung entscheiden.

Entwicklertools

Bereiten Sie Ihr Zielgerät für die Installation von Azure IoT Edge für Linux unter Windows und die Bereitstellung des virtuellen Linux-Computers vor:

1. Legen Sie die Ausführungsrichtlinie auf dem Zielgerät auf AllSigned fest. Sie können die aktuelle Ausführungsrichtlinie in einer PowerShell-Eingabeaufforderung mit erhöhten Rechten mit dem folgenden Befehl überprüfen:

   Get-ExecutionPolicy -List
   

   Wenn die Ausführungsrichtlinie von local machine nicht AllSigned ist, können Sie die Ausführungsrichtlinie wie folgt festlegen:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

Weitere Informationen zum PowerShell-Modul „Azure IoT Edge für Linux unter Windows“ finden Sie in der PowerShell-Funktionsreferenz.

Registrieren Ihres Geräts

Je nach Präferenz können Sie Ihr Gerät über das Azure-Portal, mithilfe von Visual Studio Code oder über die Azure CLI registrieren.

Portal

In Ihrem IoT-Hub im Azure-Portal werden IoT Edge-Geräte separat von IoT-Geräten erstellt und verwaltet, die nicht mit Edge verwendet werden können.

1. Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Ihrem IoT Hub.

2. Klicken Sie im linken Bereich auf Geräte, und klicken Sie dann auf Gerät hinzufügen.

3. Geben Sie auf der Seite Gerät erstellen die folgenden Informationen ein:

   • Erstellen Sie eine beschreibende Geräte-ID, z. B. my-edge-device-1 (nur Kleinbuchstaben). Kopieren Sie die Geräte-ID, da Sie sie später verwenden werden.
   • Aktivieren Sie das Kontrollkästchen IoT Edge-Gerät.
   • Wählen Sie als Authentifizierungstyp Symmetrischer Schlüssel aus.
   • Verwenden Sie die Standardeinstellungen, um automatisch Authentifizierungsschlüssel zu generieren, die das neue Gerät mit Ihrem Hub verbinden.

4. Wählen Sie Speichern.

Ihr neues Gerät sollte in Ihrem IoT-Hub aufgelistet sein.

Visual Studio Code

Anmelden bei Azure

Sie können die Azure IoT-Erweiterungen für Visual Studio Code verwenden, um Vorgänge mit Ihren IoT Hub auszuführen. Stellen Sie sicher, dass Sie die Voraussetzungen für die Azure IoT-Erweiterung installiert haben.

Sobald die Erweiterungen Azure IoT Edge und Azure IoT Hub installiert sind, sehen Sie, dass ein Azure-Symbol zum linken Symbolmenü hinzugefügt wurde. Sie können sich über Visual Studio Code bei Ihrem Azure-Konto anmelden, indem Sie das Azure-Symbol auswählen und dann Bei Azure anmelden wählen.

Registrieren eines neuen Geräts mit Visual Studio Code

Die Registrierung eines neuen Geräts ist vergleichbar mit der Erstellung eines IoT Edge-Geräts im Azure-Portal. Dieses virtuelle Gerät ist einer der Zwillinge, während das Gerät in der realen Welt der andere Zwilling ist. Visual Studio Code kann dies mit den folgenden Schritten für Sie einrichten.

1. Erweitern Sie im Menü Visual Studio Code-Explorer den Abschnitt Azure IoT Hub.
2. Wählen Sie ... in der Kopfzeile des Abschnitts Azure IoT Hub. Wenn Sie die Ellipse nicht sehen, wählen Sie den Header aus oder bewegen Sie den Mauszeiger darüber.
3. Wählen Sie Create IoT Edge Device (IoT Edge-Gerät erstellen) aus.
4. Geben Sie in dem sich öffnenden Textfeld eine ID für Ihr Gerät ein, zum Beispiel my-edge-device-1 (nur Kleinbuchstaben), und drücken Sie dann die Eingabetaste.

In der Ausgabekonsole von Visual Studio Code sehen Sie das Ergebnis des Befehls: einen JSON-Ausdruck. Die Geräteinformationen enthalten die deviceId, die Sie angegeben haben, und generieren eine connectionString, mit der Sie Ihr physisches Gerät mit Ihrem IoT-Hub verbinden können. Die Ausgabekonsole zeigt auch Ihre Schlüssel und andere Geräteidentifikationsdaten an.

Sie sehen Ihr Gerät nun im Abschnitt Azure IoT Hub>Geräte des Explorer-Menüs.

Hinweis

Wenn Ihr Gerät nicht aufgeführt ist, müssen Sie möglicherweise Ihren IoT Hub über den Link IoT Hub auswählen unter Azure IoT Hub finden und dann den Anweisungen folgen. Sie werden aufgefordert, zuerst Ihr Abonnement und dann Ihren IoT Hub auszuwählen. Dieser Vorgang informiert Visual Studio Code über Ihren IoT Hub (und alle darin enthaltenen Geräte). Wenn Sie Visual Studio Code aktualisieren, sollte Ihr Gerät angezeigt werden.

Azure-Befehlszeilenschnittstelle

Verwenden Sie den Befehl az iot hub device-identity create, um eine neue Geräteidentität in Ihrem IoT-Hub zu erstellen. Ersetzen Sie device_id_here durch Ihre eigene neue und eindeutige Geräte-ID, zum Beispiel my-edge-device-1 (nur Kleinbuchstaben). Ersetzen Sie hub_name_here durch Ihren vorhandenen IoT-Hub.

Dieser Befehl weist drei Parameter auf:

• --device-id oder -d: Geben Sie einen beschreibenden Namen an, der innerhalb Ihres IoT-Hubs eindeutig ist.

• --hub-name oder -n: Geben Sie den Namen Ihres IoT-Hub an.

• --edge-enabled oder --ee: Deklarieren Sie, dass das Gerät ein IoT Edge-Gerät ist.

  az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled
  

Wenn in Ihrer CLI angezeigt wird: Der Befehl erfordert die Erweiterung azure-iot. Möchten Sie sie jetzt installieren?, dann geben Sie Y ein und drücken Sie Enter, um den Download zum Erstellen Ihres Geräts zu initiieren.

Da Sie nun ein Gerät in IoT Hub registriert haben, können Sie im nächsten Schritt die Bereitstellungsinformationen abrufen, die für die Installation und Bereitstellung der IoT Edge-Runtime benötigt werden.

Anzeigen registrierter Geräte und Abrufen von Bereitstellungsinformationen

Für Geräte, die die Authentifizierung mit symmetrischen Schlüsseln verwenden, wird eine eigene Verbindungszeichenfolge benötigt, um die Installation und Bereitstellung der IoT Edge-Runtime abzuschließen. Die Verbindungszeichenfolge für Ihr IoT Edge-Gerät wird generiert, wenn Sie das Gerät erstellen. Bei Visual Studio Code und Azure CLI befindet sich die Verbindungszeichenfolge in der JSON-Ausgabe. Wenn Sie das Azure-Portal verwenden, um Ihr Gerät zu erstellen, können Sie die Verbindungszeichenfolge auf dem Gerät selbst finden. Wenn Sie Ihr Gerät in Ihrem IoT-Hub auswählen, wird es auf der Geräteseite als Primary connection string aufgeführt.

Portal

Die Edge-fähigen Geräte, die sich mit Ihrem IoT-Hub verbinden, werden auf der Seite Geräte Ihres IoT-Hubs aufgeführt. Wenn Sie mehrere Geräte haben, können Sie die Liste filtern, indem Sie den Typ IoT Edge-Geräte und dann Anwenden wählen.

Wenn Sie bereit für die Einrichtung Ihres Geräts sind, benötigen Sie die Verbindungszeichenfolge, die Ihr physisches Gerät mit seiner Identität in IoT Hub verknüpft. Sie können die Verbindungszeichenfolgen von Geräten, die sich mit symmetrischen Schlüsseln authentifizieren, im Portal kopieren. So finden Sie Ihre Verbindungszeichenfolge im Portal:

1. Wählen Sie auf der Seite Geräte die IoT Edge-Geräte-ID aus der Liste aus.
2. Kopieren Sie entweder den Wert der primären Verbindungszeichenfolge oder der sekundären Verbindungszeichenfolge. Beide Schlüssel funktionieren.

Visual Studio Code

Alle Geräte, die Verbindungen mit Ihrem IoT Hub herstellen, werden im Abschnitt Azure IoT Hub des Visual Studio Code-Explorers aufgeführt. Sie können IoT Edge-Geräte von Nicht-Edge-Geräten unterscheiden, weil sie jeweils ein anderes Symbol haben und für jedes IoT Edge-Gerät die Module $edgeAgent und $edgeHub bereitgestellt werden.

Wenn Sie bereit für die Einrichtung Ihres Geräts sind, benötigen Sie die Verbindungszeichenfolge, die Ihr physisches Gerät mit seiner Identität in IoT Hub verknüpft. So erhalten Sie Ihre Verbindungszeichenfolge aus Visual Studio Code.

1. Klicken Sie mit der rechten Maustaste auf die ID (den Namen) Ihres Geräts im Bereich Azure IoT Hub.

2. Wählen Sie Copy Device Connection String (Verbindungszeichenfolge des Geräts kopieren) aus.

   Die Verbindungszeichenfolge wird in die Zwischenablage kopiert.

Sie können auch im Kontextmenü Get Device Info (Geräteinformationen abrufen) auswählen, um alle Geräteinformationen einschließlich der Verbindungszeichenfolge im Ausgabefenster anzuzeigen.

Azure-Befehlszeilenschnittstelle

Um alle Geräte in Ihrem IoT-Hub anzuzeigen, verwenden Sie den Befehl az iot hub device-identity list. Ersetzen Sie hub_name_here durch den Namen Ihres eigenen IoT-Hubs.

az iot hub device-identity list --hub-name hub_name_here

Für jedes Gerät, das als IoT Edge-Gerät registriert ist, ist die Eigenschaft capabilities.iotEdge auf true gesetzt. Sie sehen auch eine Menge anderer Metadaten als JSON-Ausgabe, einschließlich Ihrer Geräte-IDs.

Wenn Sie bereit sind, Ihr Gerät einzurichten, benötigen Sie die Verbindungszeichenfolge, die Ihr physisches Gerät mit seiner Identität im IoT-Hub verbindet. Verwenden Sie den folgenden Befehl az iot hub device-identity connection-string show, um die Verbindungszeichenfolge für ein einzelnes Gerät anzuzeigen. Ersetzen Sie [device_id] und [hub_name] durch Ihre eigenen Werte. Beim Wert für den Parameter device-identity muss die Groß-/Kleinschreibung beachtet werden.

az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]

Sie sollten eine JSON-Ausgabe in der Konsole sehen, die der folgenden ähnelt:

{
  "connectionString": "HostName=[hub_name].azure-devices.net;DeviceId=[device_id];SharedAccessKey=[device_key]"
}

Tipp

Der Befehl connection-string show wurde in Version 0.9.8 der Azure IoT-Erweiterung eingeführt und ersetzt den veralteten Befehl show-connection-string. Wenn Sie beim Ausführen dieses Befehls einen Fehler erhalten, stellen Sie sicher, dass die Erweiterung mindestens auf Version 0.9.8 aktualisiert wurde. Weitere Informationen und die neuesten Updates finden Sie unter der Microsoft Azure IoT-Erweiterung für die Azure-Befehlszeilenschnittstelle.

Achten Sie darauf, beim Kopieren der Verbindungszeichenfolge für die Verwendung auf einem Gerät nicht die Anführungszeichen um die Verbindungszeichenfolge herum mit zu kopieren.

Installieren von IoT Edge

Stellen Sie Azure IoT Edge für Linux unter Windows auf Ihrem Zielgerät bereit.

Hinweis

Das folgende PowerShell-Verfahren beschreibt, wie Sie IoT Edge für Linux unter Windows auf dem lokalen Gerät bereitstellen. Für die Bereitstellung auf einem Remotezielgerät mithilfe von PowerShell können Sie über Remote PowerShell eine Verbindung mit einem Remotegerät herstellen und diese Befehle remote auf dem Gerät ausführen.

1. Führen Sie in einer erweiterten PowerShell-Sitzung je nach Architektur Ihres Zielgeräts einen der folgenden Befehle aus, um IoT Edge für Linux unter Windows herunterzuladen.

   • X64/AMD64

     $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
     $ProgressPreference = 'SilentlyContinue'
     Invoke-WebRequest "https://aka.ms/AzEFLOWMSI_1_4_LTS_X64" -OutFile $msiPath
     

   • ARM64

     $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
     $ProgressPreference = 'SilentlyContinue'
     Invoke-WebRequest "https://aka.ms/AzEFLOWMSI_1_4_LTS_ARM64" -OutFile $msiPath
     

2. Installieren Sie IoT Edge für Linux unter Windows auf Ihrem Gerät.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
   

   Sie können benutzerdefinierte Installations- und VHDX-Verzeichnisse für IoT Edge für Linux unter Windows angeben, indem Sie dem Installationsbefehl die Parameter INSTALLDIR="<FULLY_QUALIFIED_PATH>" und VHDXDIR="<FULLY_QUALIFIED_PATH>" hinzufügen. Wenn Sie beispielsweise den Ordner D:\EFLOW für die Installation und D:\EFLOW-VHDX für das VHDX-Verzeichnis verwenden möchten, können Sie dazu das folgende PowerShell-Cmdlet verwenden.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn","INSTALLDIR=D:\EFLOW", "VHDXDIR=D:\EFLOW-VHDX"
   

3. Legen Sie die Ausführungsrichtlinie auf dem Zielgerät auf AllSigned fest, wenn dies noch nicht so eingestellt ist. In den PowerShell-Voraussetzungen finden Sie die Befehle, mit denen Sie die aktuelle Ausführungsrichtlinie überprüfen und auf AllSigned festlegen können.

4. Erstellen Sie die Bereitstellung von IoT Edge für Linux unter Windows. Die Bereitstellung erstellt Ihren virtuellen Linux-Computer und installiert die IoT Edge Runtime automatisch.

   Deploy-Eflow
   

   Tipp

   Standardmäßig erstellt der Befehl Deploy-Eflow Ihren Linux-VM mit 1 GB RAM, 16 vCPU-Kern und 16 GB Speicherplatz. Die Ressourcen, die Ihr VM benötigt, sind jedoch stark von den Workloads abhängig, die Sie bereitstellen. Wenn Ihr VM nicht über genügend Arbeitsspeicher verfügt, um Ihre Workloads zu unterstützen, kann er nicht gestartet werden.

   Sie können die verfügbaren Ressourcen des VM mithilfe der optionalen Parameter des Befehls Deploy-Eflow anpassen. Dies ist erforderlich, um EFLOW auf einem Gerät mit den Mindesthardwareanforderungen bereitzustellen.

   Mit dem folgenden Befehl beispielsweise wird eine VM mit 1 vCPU-Kern, 1 GB RAM (angegeben in MB) und 2 GB Speicherplatz erstellt:

   Deploy-Eflow -cpuCount 1 -memoryInMB 1024 -vmDataSize 2
   

   Informationen zu allen verfügbaren optionalen Parametern finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.

   Warnung

   Standardmäßig hat der virtuelle EFLOW-Linux-Computer keine DNS-Konfiguration. Bei Bereitstellungen mit dem DHCP wird versucht, die vom DHCP-Server weitergegebene DNS-Konfiguration abzurufen. Überprüfen Sie Ihre DNS-Konfiguration, um die Internetkonnektivität sicherzustellen. Weitere Informationen finden Sie unter AzEFLOW-DNS.

   Sie können Ihrer Bereitstellung eine GPU zuweisen, um GPU-beschleunigte Linux-Module zu aktivieren. Um Zugriff auf diese Features zu erhalten, müssen Sie die erforderlichen Komponenten installieren, die unter GPU-Beschleunigung für Azure IoT Edge für Linux unter Windows aufgeführt werden.

   Wenn Sie GPU-Passthrough verwenden möchten, müssen Sie Ihrem Befehl Deploy-Eflow die Parameter gpuName, gpuPassthroughType und gpuCount hinzufügen. Informationen zu allen verfügbaren optionalen Parametern finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.

   Warnung

   Das Aktivieren von Hardwaregeräte-Passthrough kann zu einem erhöhten Sicherheitsrisiko führen. Microsoft empfiehlt zur Risikominderung die Installation eines Gerätetreibers, den Sie vom Anbieter Ihrer GPU erhalten. Weitere Informationen finden Sie unter Bereitstellen von Grafikgeräten mit Discrete Device Assignment.

5. Geben Sie „Y“ ein, um den Lizenzbedingungen zuzustimmen.

6. Durch die Eingabe von „O“ oder „R“ können Sie Optionale Diagnosedaten bei Bedarf ein- oder ausschalten.

7. Sobald die Bereitstellung abgeschlossen ist, meldet das PowerShell-Fenster Bereitstellung erfolgreich.

   

   Nach einer erfolgreichen Bereitstellung können Sie Ihr Gerät bereitstellen.

Bereitstellen des Geräts mit seiner Cloud-Identität

Sie können Ihr Gerät mit den zugehörigen Cloudidentitäts- und Authentifizierungsinformationen einrichten.

Um Ihr Gerät mithilfe von symmetrischen Schlüsseln bereitstellen zu können, benötigen Sie die Verbindungszeichenfolge Ihres Geräts.

Führen Sie den folgenden Befehl mit erhöhten Rechten in einer PowerShell-Sitzung auf Ihrem Zielgerät aus. Ersetzen Sie den Platzhaltertext durch Ihre eigenen Werte.

Provision-EflowVm -provisioningType ManualConnectionString -devConnString "PASTE_DEVICE_CONNECTION_STRING_HERE"

Weitere Informationen zum Befehl Provision-EflowVM finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.

Überprüfen der erfolgreichen Konfiguration

Vergewissern Sie sich, dass IoT Edge für Linux unter Windows erfolgreich auf Ihrem IoT Edge-Gerät installiert und konfiguriert wurde.

1. Melden Sie sich mithilfe des folgenden Befehls in Ihrer PowerShell-Sitzung bei Ihrem virtuellen IoT Edge für Linux-Computer unter Windows an:

   Connect-EflowVm
   

   Hinweis

   Das einzige Konto, das zum Herstellen eines SSH mit dem virtuellen Computer zulässig ist, ist der Benutzer, der es erstellt.

2. Sobald Sie angemeldet sind, können Sie die Liste der laufenden IoT Edge-Module mithilfe des folgenden Linux-Befehls überprüfen:

   sudo iotedge list
   

3. Wenn Sie eine Problembehandlung für den IoT Edge-Dienst durchführen müssen, verwenden Sie die folgenden Linux-Befehle.

   1. Rufen Sie die Dienstprotokolle ab.

      sudo iotedge system logs
      

   2. Verwenden Sie das Tool check, um die Konfiguration und den Verbindungsstatus des Geräts zu überprüfen.

      sudo iotedge check
      

   Hinweis

   Auf einem neu bereitgestellten Gerät wird möglicherweise ein Fehler im Zusammenhang mit dem IoT Edge-Hub angezeigt:

   × Produktionsbereitschaft: Das Speicherverzeichnis des Edge-Hubs wird im Hostdateisystem beibehalten – Fehler.

   Der aktuelle Zustand des edgeHub-Containers konnte nicht überprüft werden.

   Dieser Fehler wird auf einem neu bereitgestellten Gerät erwartet, da das IoT Edge-Hubmodul nicht ausgeführt wird. Um den Fehler zu beheben, legen Sie in IoT Hub die Module für das Gerät fest, und erstellen Sie eine Bereitstellung. Durch das Erstellen einer Bereitstellung für das Gerät werden die Module auf dem Gerät gestartet, einschließlich des IoT Edge-Hubmoduls.

Wenn Sie ein neues IoT Edge-Gerät erstellen, wird der Statuscode 417 -- The device's deployment configuration is not set im Azure-Portal angezeigt. Dieser Status ist normal und bedeutet, dass das Gerät bereit ist, eine Modulbereitstellung zu empfangen.

Deinstallieren von IoT Edge für Linux unter Windows

Wenn Sie die Installation von Azure IoT Edge für Linux unter Windows von Ihrem Gerät entfernen möchten, verwenden Sie die folgenden Befehle:

1. Öffnen Sie die Einstellungen unter Windows.
2. Wählen Sie „Programme hinzufügen oder entfernen“ aus.
3. Wählen Sie die App Azure IoT Edge aus.
4. Wählen Sie „Deinstallieren“ aus.

Nächste Schritte

• Sie können nun mit dem Artikel zum Bereitstellen von IoT Edge-Modulen fortfahren, um zu erfahren, wie Sie Module auf Ihrem Gerät bereitstellen.
• Erfahren Sie, wie Sie Zertifikate auf Ihrem IoT Edge für Linux auf einem virtuellen Windows-Computer verwalten und Dateien vom Host-Betriebssystem auf Ihren virtuellen Linux-Computer übertragen.
• Erfahren Sie, wie Sie Ihre IoT Edge-Geräte für die Kommunikation über einen Proxy-Server konfigurieren.