Häufige Probleme und Lösungen für Azure IoT Edge für Linux unter Windows

2025-06-03

Gilt für: IoT Edge 1.5

Wichtig

IoT Edge 1.5 LTS ist das unterstützte Release. IoT Edge 1.4 LTS wurde am 12. November 2024 eingestellt. Wenn Sie ein früheres Release verwenden, finden Sie weitere Informationen unter Aktualisieren von IoT Edge.

Verwenden Sie diesen Artikel, um häufige Probleme zu beheben, die auftreten können, wenn Sie IoT Edge für Linux unter Windows-Lösungen bereitstellen.

Installation und Bereitstellung

Der folgende Abschnitt behandelt die häufigsten Fehler bei der Installation von EFLOW MSI und der Bereitstellung des virtuellen EFLOW-Computers. Stellen Sie sicher, dass Sie die folgenden EFLOW-Konzepte verstehen:

Fehler	Fehlerbeschreibung	Lösung
HNS-API Version X entspricht nicht der Mindestversion	EFLOW verwendet HCS/HNS, um den virtuellen Computer auf Client-SKUs zu erstellen. Die Mindestversion von HNS ist 9.2.	Wenn Sie eine Windows-Version 20H1 oder höher verwenden, sollte die HCS/HNS-API diese Anforderung erfüllen. Wenn Sie Windows-Client RS5 (17763) verwenden, stellen Sie sicher, dass Sie über das neueste Windows-Update verfügen.
WSSDAGENT-Dienst kann nicht gefunden werden! WSSDAgent ist nicht erreichbar, das Update ist fehlgeschlagen.	Der WSSDAgent ist die EFLOW-Komponente, die den Lebenszyklus der VM erstellt und verwaltet. WSSDAgent führt einen Dienst auf dem Windows-Hostbetriebssystem aus. Wenn der Dienst nicht ausgeführt wird, tritt bei der VM-Kommunikation und dem Lebenszyklus ein Fehler auf.	Überprüfen Sie, ob der WSSDAgent-Dienst auf dem Windows-Hostbetriebssystem ausgeführt wird, indem Sie eine PowerShell-Sitzung mit erhöhten Rechten öffnen und den Befehl `Get-Service -Name wssdagent` ausführen. Wenn WSSDAgent nicht ausgeführt wird, versuchen Sie, den Dienst manuell zu starten, indem Sie das folgende Cmdlet verwenden: `Start-Service -name WSSDAgent`. Wenn es nicht startet, geben Sie den Inhalt unter C:\ProgramData\wssdagent frei.
Erwartetes Image „$vhdPathBackup“ fehlt	Bei der Installation der aktuellen EFLOW-Version (Current Release, CR) kann der Benutzer die Größe der Datenpartition mithilfe der Option vmDataSize bereitstellen. Falls angegeben, ändert EFLOW die Größe der VHDX. Der Fehler tritt auf, wenn die VHDX-Datei bei der Größenänderung nicht gefunden wird.	Stellen Sie sicher, dass die VHDX-Datei nicht gelöscht oder vom ursprünglichen Speicherort verschoben wurde.
Fehler bei der Installation von Hyper-V, Hyper-V Management PowerShell oder OpenSSH. Führen Sie die Installation manuell durch, und starten Sie die Bereitstellung neu. Vorgang wird abgebrochen...	Die EFLOW-Installation verfügt über die erforderlichen Voraussetzungen für die Bereitstellung des virtuellen Computers. Wenn eine der Voraussetzungen nicht erfüllt ist, schlägt das Cmdlet `Deploy-Eflow` fehl.	Stellen Sie sicher, dass alle erforderlichen Voraussetzungen erfüllt sind. PowerShell: Schließen Sie die PowerShell-Sitzung und öffnen Sie eine neue. Wenn Sie mehrere Installationen haben, stellen Sie sicher, dass Sie das richtige Modul importiert haben. Versuchen Sie eine andere Version von PowerShell. Hyper-V: Weitere Informationen zur EFLOW-Hyper-V-Unterstützung finden Sie unter Azure IoT Edge für Linux unter Windows: Geschachtelte Virtualisierung. OpenSSH: Wenn Sie Ihre eigene benutzerdefinierte Installation verwenden, überprüfen Sie den Parameter `customSsh` während der Bereitstellung.
$feature ist in dieser Windows-Edition nicht verfügbar. $featureversion konnte nicht aktiviert werden. Fügen Sie das optionale Feature „$featureversion“ in den Einstellungen hinzu, und starten Sie die Bereitstellung neu.	Wenn bei der Bereitstellung von EFLOW eine der Voraussetzungen nicht erfüllt ist, versucht das Installationsprogramm, es zu installieren. Wenn dieses Feature nicht verfügbar ist oder bei der Installation des Features ein Fehler auftritt, schlägt die Bereitstellung von EFLOW fehl.	Stellen Sie sicher, dass alle erforderlichen Voraussetzungen erfüllt sind. PowerShell: Schließen Sie die PowerShell-Sitzung und öffnen Sie eine neue. Wenn Sie mehrere Installationen haben, stellen Sie sicher, dass Sie das richtige Modul importiert haben. Versuchen Sie eine andere Version von PowerShell. Hyper-V: Weitere Informationen zur EFLOW-Hyper-V-Unterstützung finden Sie unter Azure IoT Edge für Linux unter Windows: Geschachtelte Virtualisierung. OpenSSH: Wenn Sie Ihre eigene benutzerdefinierte Installation verwenden, überprüfen Sie den Parameter `customSsh` während der Bereitstellung.
Hyper-V-Eigenschaften zeigen an, dass die Hyper-V-Komponente nicht funktionsfähig ist (Eigenschaft HyperVRequirementVirtualizationFirmwareEnabled ist „false“). Hyper-V-Eigenschaften zeigen an, dass die Hyper-V-Komponente nicht funktionsfähig ist (Eigenschaft HyperVisorPresent ist „false“). Hyper-V-Kerndienste werden nicht ausgeführt (vmms, vmcompute, hvhost). Stellen Sie sicher, dass Hyper-V ordnungsgemäß konfiguriert und in der Lage ist, virtuelle Computer zu starten.	Diese Fehler stehen im Zusammenhang mit dem Hyper-V-Virtualisierungstechnologiestapel und zugehörigen Diensten. Der virtuelle EFLOW-Computer benötigt mehrere Hyper-V-Dienste, um den virtuellen Computer erstellen und ausführen zu können. Wenn einer dieser Dienste nicht verfügbar ist, tritt bei der Installation ein Fehler auf.	Weitere Informationen zur EFLOW-Hyper-V-Unterstützung finden Sie unter Azure IoT Edge für Linux unter Windows: Geschachtelte Virtualisierung.
WSSDAGENT nicht erreichbar, versuchen Sie es erneut...	Der WSSDAgent ist die EFLOW-Komponente, die den Lebenszyklus der VM erstellt und verwaltet. WSSDAgent führt einen Dienst auf dem Windows-Hostbetriebssystem aus.	Überprüfen Sie, ob der WSSDAgent-Dienst auf dem Windows-Hostbetriebssystem ausgeführt wird, indem Sie eine PowerShell-Sitzung mit erhöhten Rechten öffnen und den Befehl `Get-Service -Name wssdagent` ausführen. Wenn WSSDAgent nicht ausgeführt wird, versuchen Sie, den Dienst manuell zu starten, indem Sie das folgende Cmdlet verwenden: `Start-Service -name WSSDAgent`. Wenn es nicht startet, geben Sie den Inhalt unter C:\ProgramData\wssdagent frei.
Die Konfiguration des virtuellen Computers konnte nicht von wssdagent abgerufen werden.	Suchen Sie die EFLOW-Konfigurationsdateien unter dem EFLOW-Stamminstallationsordner. Wenn z. B. das Standardinstallationsverzeichnis verwendet wurde, sollten sich die Konfigurationsdateien im Verzeichnis C:\Programme\Azure IoT Edge\yaml befinden.	Überprüfen Sie, ob das Verzeichnis gelöscht oder verschoben wurde. Wenn das Verzeichnis nicht verfügbar ist, kann die VM nicht erstellt werden. Eine Neuinstallation von EFLOW ist erforderlich.
Ein vorhandener virtueller Computer wurde erkannt. Um den virtuellen Computer neu bereitzustellen, deinstallieren Sie $eflowProductName und installieren es dann erneut. Der virtuelle Computer „$name“ ist bereits vorhanden. Sie müssen zuerst den virtuellen Computer „$name“ entfernen.	Während der EFLOW-Bereitstellung prüft das Installationsprogramm, ob eine EFLOW-VM aus früheren Installationen erstellt wurde. In einigen Fällen, wenn die Installation bei den letzten Schritten fehlschlägt, wurde die VM erstellt und wird immer noch im Windows-Hostbetriebssystem ausgeführt.	Stellen Sie sicher, dass Sie EFLOW vollständig deinstallieren, bevor Sie eine neue Installation starten. 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 in Windows die Option Einstellungen. 2. Wählen Sie Programme hinzufügen oder entfernen aus. 3. Wählen Sie die App Azure IoT Edge LTS aus. 4. Wählen Sie Deinstallieren aus.
Fehler beim Erstellen von Speicher-VHD (Datei: $($config["imageNameEflowVm"]))	Fehler beim Erstellen oder Ändern der Größe der VHDX des virtuellen EFLOW-Computers.	Weitere Informationen finden Sie in den EFLOW-Installationsprotokollen in C:\Programme\Azure IoT Edge und in den WSSDAgent-Protokollen in C:\ProgramData\wssdagent.
Fehler: Fehler beim Erstellen des virtuellen Computer. Fehler beim Abrufen des Namens des virtuellen Computers.	Fehler bei der Erstellung eines virtuellen Computers durch WSSDAgent. Das Installationsprogramm wird versuchen, die VM zu entfernen und die Installation als fehlerhaft markieren.	Überprüfen Sie, ob der WSSDAgent-Dienst auf dem Windows-Hostbetriebssystem ausgeführt wird, indem Sie eine PowerShell-Sitzung mit erhöhten Rechten öffnen und den Befehl `Get-Service -Name wssdagent` ausführen. Wenn WSSDAgent nicht ausgeführt wird, versuchen Sie, den Dienst manuell zu starten, indem Sie das folgende Cmdlet verwenden: `Start-Service -name WSSDAgent`. Wenn es nicht startet, geben Sie den Inhalt unter C:\ProgramData\wssdagent frei.
Dieses Windows-Gerät erfüllt nicht die Mindestanforderungen für Azure EFLOW. Die Systemanforderungen finden Sie unter https://aka.ms/AzEFLOW-Requirements.	Während der Bereitstellung von EFLOW überprüft das PowerShell-Cmdlet Deploy-EFlow, ob alle Voraussetzungen erfüllt sind. Insbesondere werden die Windows-SKUs überprüft (Windows Server 2019, 2022, Windows Client Professional oder Client Enterprise) und die Windows-Version ist mindestens 17763.	Stellen Sie sicher, dass Sie eine unterstützte Windows-SKU und -Version verwenden. Wenn Sie die Windows-Version 17763 verwenden, stellen Sie sicher, dass Sie alle Updates installiert haben.
Es ist nicht genug Arbeitsspeicher verfügbar.	Es ist nicht ausreichend RAM-Speicher verfügbar, um die EFLOW-VM mit dem zugeordneten VM-Speicher zu erstellen. Standardmäßig sind dem virtuellen Computer 1024 MB zugewiesen. Auf dem Windows-Hostbetriebssystem müssen mindestens X MB frei sein, um diesen Arbeitsspeicher der VM zuzuweisen.	Überprüfen Sie den verfügbaren Speicher des Windows-Hostbetriebssystems, und verwenden Sie den Parameter memoryInMb für `Deploy-Eflow` für die benutzerdefinierte Speicherzuweisung. Weitere Informationen zum PowerShell-Cmdlet `Deploy-EFlow` finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.
Nicht genügend CPU-Kerne verfügbar.	Es sind nicht genügend CPU-Kerne verfügbar, um die EFLOW-VM mit den zugeordneten Kernen zu erstellen. Standardmäßig wird dem virtuellen Computer ein Kern zugewiesen. Das Windows-Hostbetriebssystem muss über mindestens einen Kern verfügen, damit dieser Kern der EFLOW-VM zugewiesen werden kann.	Überprüfen Sie die verfügbaren CPU-Kerne des Windows-Hostbetriebssystems, und verwenden Sie den Parameter cpuCore für `Deploy-Eflow` für die benutzerdefinierte Speicherzuweisung. Weitere Informationen zum PowerShell-Cmdlet `Deploy-EFlow` finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.
Auf dem Laufwerk „$drive“ ist nicht genügend Speicherplatz verfügbar.	Es ist nicht genügend Speicherplatz verfügbar, um die EFLOW-VM mit der zugeordneten Speichergröße zu erstellen. Standardmäßig verwendet die VM ~18 GB Speicherplatz. Das Windows-Hostbetriebssystem muss über mindestens 18 GB freien Speicherplatz verfügen, um diesen Speicherplatz zur VHDX der EFLOW-VM zuzuweisen.	Überprüfen Sie den verfügbaren freien Speicherplatz des Windows-Hosts, und verwenden Sie den Parameter vmDiskSize für `Deploy-Eflow` für die benutzerdefinierte Speichergröße. Weitere Informationen zum PowerShell-Cmdlet `Deploy-EFlow` finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.
Die Signatur ist ungültig (Datei: $filePath, Signaturstatus: ${signature.Status}) Die Signatur fehlt (Datei: $filePath)! Die Signatur des Microsoft-Stammzertifikats konnte nicht nachverfolgt werden.	Die Signatur der Datei kann nicht gefunden werden oder sie ist ungültig. EFLOW-PSM und EFLOW-Updates werden alle mithilfe von Microsoft-Zertifikaten signiert. Wenn der Microsoft-Code oder die Zertifikate der Microsoft-Zertifizierungsstelle im Windows-Hostbetriebssystem nicht verfügbar sind, tritt ein Fehler bei der Validierung auf.	Vergewissern Sie sich, dass alle Inhalte von den offiziellen Microsoft-Seiten heruntergeladen wurden. Wenn die erforderlichen Zertifikate nicht Teil des Windows-Hosts sind, überprüfen Sie Installieren der für EFLOW erforderlichen Zertifikate.

Bereitstellung und IoT Edge-Runtime

In diesem Abschnitt werden häufige Fehler beim Einrichten des virtuellen EFLOW-Computers und die Interaktion mit der IoT Edge-Laufzeit behandelt. Stellen Sie sicher, dass Sie die folgenden EFLOW-Konzepte verstehen:

Fehler	Fehlerbeschreibung	Lösung
Aktion vom Benutzer abgebrochen	Für einige der EFLOW-PowerShell-Cmdlets ist eine Interaktion und Bestätigung durch den Benutzer erforderlich.	-
Fehler, Geräteverbindungszeichenfolge nicht angegeben. Es darf nur die Geräteverbindungszeichenfolge für die ManualConnectionString-Bereitstellung angegeben werden.	Falsche Parameter bei der ManualConnectionString-Gerätebereitstellung verwendet.	Weitere Informationen zum PowerShell-Cmdlet `Provision-EflowVm` finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.
IoT Hub-Hostname, Geräte-ID und/oder Identitätszertifikat/pk-Parameter für ManualX509-Bereitstellung nicht angegeben. Geräteverbindungszeichenfolge, Bereichs-ID, Registrierungs-ID und symmetrischer Schlüssel dürfen für die DpsX509-Bereitstellung nicht angegeben werden. Zertifikat und private Schlüsseldatei für ManualX509-Bereitstellung nicht gefunden (erwartet bei $identityCertPath und $identityPrivKeyPath).	Falsche Parameter für die ManualX509-Gerätebereitstellung verwendet.	Weitere Informationen zum PowerShell-Cmdlet `Provision-EflowVm` finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.
Bereichs-ID für die DpsTpm-Bereitstellung nicht angegeben. Es können nur die Bereichs-ID und die Registrierungs-ID (optional) für die DpsTpm-Bereitstellung angegeben werden.	Falsche Parameter für die DpsTpm-Gerätebereitstellung verwendet.	Weitere Informationen zum PowerShell-Cmdlet `Provision-EflowVm` finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.
Bereichs-ID, Registrierungs-ID oder symmetrischer Schlüssel fehlt für DpsSymmetricKey-Bereitstellung. globalEndpoint nicht angegeben. Nur Bereichs-ID, Registrierungs-ID oder symmetrischer Schlüssel dürfen für DpsSymmetricKey-Bereitstellung angegeben werden.	Falsche Parameter für die DpsSymmetricKey-Gerätebereitstellung verwendet.	Weitere Informationen zum PowerShell-Cmdlet `Provision-EflowVm` finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.
Der virtuelle Computer ist nicht vorhanden, stellen Sie ihn zunächst bereit.	Das EFLOW-MSI wurde installiert, aber der virtuelle Computer wurde nie bereitgestellt.	Verwenden Sie für die Bereitstellung der EFLOW-VM das PowerShell-Cmdlet `Deploy-Eflow`.
Abbruch, iotedge wurde zuvor bereitgestellt (Headless-Modus)!	Die EFLOW-VM wurde zuvor bereitgestellt und der Headless-Modus wird bei der erneuten Bereitstellung nicht unterstützt.	Das Problem wurde behoben und jetzt wird der -headless-Modus mit der erneuten Bereitstellung unterstützt.
Bereitstellung durch Benutzer abgebrochen.	Die EFLOW-VM wurde zuvor bereitgestellt und der Benutzer muss bestätigen, dass er sie erneut bereitstellen möchte.	Der Benutzer muss die erneute Bereitstellung akzeptieren, um mit der Bereitstellung fortzufahren.
Fehler beim Bereitstellen. Fehler beim Bereitstellen von config.toml. Führen Sie die Bereitstellung manuell durch. Der iotedge-Dienst wird nach der Bereitstellung nicht ausgeführt, führen Sie eine manuelle Untersuchung durch.	Die EFLOW-Bereitstellungsinformationen wurden innerhalb der EFLOW-VM ordnungsgemäß konfiguriert, aber der IoT Edge-Daemon konnte das Gerät nicht mit dem Cloudbereitstellungsdienst bereitstellen.	Überprüfen Sie die Protokolle der Azure IoT Edge-Runtime. Stellen Sie zunächst eine Verbindung mit dem virtuellen EFLOW-Computer her, indem Sie das PowerShell-Cmdlet `Connect-EflowVm` verwenden und dann die Problembehandlung Ihres IoT Edge-Geräts befolgen, um die IoT Edge-Protokolle abzurufen.
Unerwartete Rückgabe von „sudo iotedge list“. Abrufen der Ausgabe der iotedge-Prüfung von: „$vmName“.	Die Ausführung des Befehls `sudo iotedge list` innerhalb der EFLOW-VM hat unerwartete Nutzdaten zurückgegeben. Im Allgemeinen hängt dies damit zusammen, dass der IoT Edge-Dienst innerhalb der EFLOW-VM nicht ordnungsgemäß ausgeführt wird.	Überprüfen Sie die Protokolle der Azure IoT Edge-Runtime. Stellen Sie zunächst eine Verbindung mit dem virtuellen EFLOW-Computer her, indem Sie das PowerShell-Cmdlet `Connect-EflowVm` verwenden und dann die Problembehandlung Ihres IoT Edge-Geräts befolgen, um die IoT Edge-Protokolle abzurufen.
TPM 2.0 ist erforderlich, um DpsTpm zu aktivieren.	TPM-Passthrough funktioniert nur mit TPM 2.0 kompatibler Hardware. Dies könnte durch ein physisches TPM verursacht werden oder wenn die EFLOW-VM geschachtelte Virtualisierung mithilfe von vTPM auf dem Windows-Hostbetriebssystem ausführt.	Stellen Sie sicher, dass das Windows-Hostbetriebssystem über ein gültiges TPM 2.0 verfügt. Überprüfen Sie hierzu Aktivieren von TMP 2.0 auf Ihrem PC.
TPM-Bereitstellungsinformationen nicht verfügbar!	Die TPM-Passthrough-Binärdatei innerhalb der EFLOW-VM konnte die TPM-Informationen nicht vom Windows-Hostbetriebssystem abrufen. Dieser Fehler hängt wahrscheinlich mit einem Kommunikationsfehler mit dem EFLOW-Proxy zusammen.	Stellen Sie sicher, dass der EFLOW-Proxydienst mithilfe des PowerShell-Cmdlets `Get-Service -name "EFLOW Proxy Service"` ausgeführt wird. Wenn er nicht ausgeführt wird, überprüfen Sie die Ereignisprotokolle. Öffnen Sie Ereignisanzeige>Anwendungs- und Dienstprotokolle ->Azure IoT Edge für Linux unter Windows.

Interaktion mit der VM

In diesem Abschnitt werden häufige Fehler behandelt, die auftreten können, wenn Sie mit der virtuellen EFLOW-Maschine interagieren und EFLOW-Geräte-Pass-Through-Optionen einrichten. Stellen Sie sicher, dass Sie die folgenden EFLOW-Konzepte verstehen:

Fehler	Fehlerbeschreibung	Lösung
Anforderung kann nicht bearbeitet werden, EFLOW-VM ist AUS!	Wenn Sie versuchen, eine Konfiguration auf den virtuellen EFLOW-Computer anzuwenden, muss die VM eingeschaltet sein. Wenn die EFLOW-VM ausgeschaltet ist, schlägt der SSH-Kanal fehl, und es ist keine Kommunikation mit der VM möglich.	Starten Sie die EFLOW-VM mithilfe des PowerShell-Cmdlets Start-EflowVm. Weitere Informationen zum Cmdlet Start-EflowVm finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.
Der Name des virtuellen Computers konnte nicht von wssdagent abgerufen werden. Fehler: Mehr als ein virtueller Computer gefunden.	Der WSSDAgent-Dienst konnte den virtuellen EFLOW-Computer nicht finden.	Vergewissern Sie sich, dass die EFLOW-VM gestartet ist und ausgeführt wird, indem Sie das PowerShell-Cmdlet `Start-EflowVm` verwenden. Wenn Sie eine Client-SKU verwenden, verwenden Sie das Cmdlet `hcsdiag list`, und suchen Sie die Zeile mit wssdagent hinter der GUID der VM, und überprüfen Sie dann den Zustand. Wenn Sie eine Server-SKU verwenden, wechseln Sie zum Hyper-V-Manager und überprüfen Sie, ob eine VM mit dem Namen Windows-Hostname-EFLOW vorhanden ist, und überprüfen Sie dann den Zustand.
Verbindung mit virtuellem Computer kann mit SSH nicht hergestellt werden. Vorgang wird abgebrochen...	Das Windows-Hostbetriebssystem konnte keine SSH-Verbindung mit der EFLOW-VM herstellen, um die erforderlichen Befehle auszuführen oder Dateien zu kopieren. Im Allgemeinen hängt dieses Problem mit einem Netzwerkproblem zwischen Windows und dem virtuellen Computer zusammen.	Versuchen Sie das PowerShell-Cmdlet `Get-EflowVmAddr` und überprüfen Sie, ob die der VM zugewiesene IP4-Adresse korrekt ist. Weitere Informationen zu Netzwerkkonfigurationen finden Sie unter Azure IoT Edge für Linux unter Windows-Netzwerken.
Unerwartete Rückgabestatistiken vom virtuellen Computer	Die Ausführung des PowerShell-Cmdlets `Get-EflowVm` überprüft den Status des virtuellen Computers. Wenn die Kommunikation mit dem virtuellen Computer Fehler aufweist oder einige der Linux-Bash-Befehle innerhalb der VM fehlschlagen, ist das Cmdlet nicht erfolgreich.	Überprüfen Sie die Verbindung der EFLOW-VM mithilfe des PowerShell-Cmdlets `Connect-EflowVm` und versuchen Sie, die Bash-Befehle für VM-Statistiken innerhalb der VM manuell auszuführen.
Die TPM-Bereitstellung wurde nicht aktiviert!	Um die TPM-Bereitstellungsinformationen für das TPM abzurufen, muss der EFLOW-TPM-Passthrough aktiviert sein. Wenn TPM-Passthrough nicht aktiviert ist, tritt bei dem Cmdlet ein Fehler auf.	Aktivieren Sie TPM-Passthrough, bevor Sie die TPM-Informationen abrufen. Verwenden Sie das PowerShell-Cmdlet `Set-EflowVmFeature`, um TPM-Passthrough zu aktivieren. Weitere Informationen zum PowerShell-Cmdlet `Set-EflowVmFeature` finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.
Unbekanntes Feature „$feature“ wird bereitgestellt.	Das Cmdlet Set-EflowVmFeature unterstützt DpsTpm und Defender als die beiden Features, die aktiviert oder deaktiviert werden können.	Weitere Informationen zum PowerShell-Cmdlet `Set-EflowVmFeature` finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.
Nicht unterstützter DDA-Typ: $gpuName.	Derzeit wird GPU DDA nur für NVIDIA Tesla T4 und NVIDIA A2 unterstützt. Wenn der Benutzer einen anderen GPU-Namen angibt, tritt beim GPU-Passthrough ein Fehler auf.	Stellen Sie sicher, dass alle GPU-Voraussetzungen erfüllt sind. Weitere Informationen über die EFLOW-GPU-Unterstützung finden Sie unter Azure IoT Edge für Linux unter Windows: GPU-Passthrough.
Ungültige GPU-Konfiguration angefordert. Passthrough aktiviert, aber angeforderte gpuCount == $gpuCount GPU PassthroughType „$gpuPassthroughType“ nicht unterstützt von '$script:WssdProviderVmms' WssdProvider Die angeforderte GPU-Konfiguration kann vom Host nicht unterstützt werden. GPU „$gpuName“ nicht verfügbar. Die angeforderte GPU-Konfiguration kann vom Host nicht unterstützt werden. Nicht genügend GPUs verfügbar – Requested($gpuCount), Available($($selectedGpuDevice.Count)). Die angeforderte GPU-Konfiguration kann vom Host nicht unterstützt werden. GPU PassthroughType „$gpuPassthroughType“ wird nicht unterstützt. Ungültige GPU-Konfiguration angefordert, Passthrough deaktiviert, aber gpuCount > 0.	Diese Fehler hängen in der Regel damit zusammen, dass eine oder mehrere der GPU-Abhängigkeiten nicht erfüllt sind.	Stellen Sie sicher, dass alle GPU-Voraussetzungen erfüllt sind. Weitere Informationen über die EFLOW-GPU-Unterstützung finden Sie unter Azure IoT Edge für Linux unter Windows: GPU-Passthrough.
Fehler beim Herstellen einer Verbindung mit EFLOW-VM	Beim Versuch, mithilfe des PowerShell-Cmdlets Connect-EflowVm PowerShell eine Verbindung mit der EFLOW-VM herzustellen, schlägt die Verbindung mit einem Fehler "Authentifizierungs-Handshake fehlgeschlagen" fehl.	Die Ursache ist, dass das WSSDAgent-Zertifikat abgelaufen ist. Das WSSDAgent-Zertifikat läuft ein Jahr nach einer neuen Installation von EFLOW ab. Führen Sie updateWssdCert.ps1 aus, um den Gültigkeitszeitraum des Zertifikats zu verlängern. Beachten Sie, dass das Aktualisieren von EFLOW den Gültigkeitszeitraum des WSSDAgent-Zertifikats nicht verlängert, überprüfen Sie updateWssdCert.ps1.

Netzwerk

Der folgende Abschnitt befasst sich mit den häufigsten Fehlern im Zusammenhang mit dem EFLOW-Netzwerk und der Kommunikation zwischen dem virtuellen EFLOW-Computer und dem Windows-Hostbetriebssystem. Vergewissern Sie sich, dass Sie mit den folgenden EFLOW-Konzepten vertraut sind:

Fehler	Fehlerbeschreibung	Lösung
Fehler bei der Installation des virtuellen Switches Der virtuelle Switch „$switchName“ vom Typ „$switchType“ wurde nicht gefunden.	Beim Erstellen der EFLOW-VM wird überprüft, ob der bereitgestellte virtuelle Switch existiert und den richtigen Typ aufweist. Wenn Sie keinen Parameter verwenden, verwendet die Installation den vom Windows-Client bereitgestellten Standardswitch.	Überprüfen Sie, ob der verwendete virtuelle Switch Teil des Windows-Hostbetriebssystems ist. Sie können die virtuellen Switches mit dem PowerShell-Cmdlet `Get-VmSwitch` überprüfen. Weitere Informationen zu Netzwerkkonfigurationen finden Sie unter Azure IoT Edge für Linux unter Windows-Netzwerken.
Der virtuelle Switch „$switchName“ vom Typ „$switchType“ wird vom aktuellen Hostbetriebssystem nicht unterstützt.	Verwenden Sie Windows-Client-SKUs, werden externe/standardmäßige Switches unterstützt. Wenn Sie jedoch Windows Server-SKUs verwenden, werden externe/interne Switches unterstützt.	Weitere Informationen zu Netzwerkkonfigurationen finden Sie unter Azure IoT Edge für Linux unter Windows-Netzwerken.
Statische IP-Adresse kann auf dem virtuellen Switch mit dem ICS-Typ (Standardswitch) nicht festgelegt werden.	Der Standardswitch ist ein virtueller Switch, der in den Windows Client-SKUs nach der Installation von Hyper-V bereitgestellt wird. Dieser Switch verfügt bereits über einen DHCP-Server für die Zuweisung von IP4-Adressen und unterstützt aus Sicherheitsgründen keine statische IP-Adresse.	Wenn Sie den Standardschalter verwenden, können Sie entweder das Cmdlet `Get-EflowVmAddr` oder den Hostnamen der EFLOW-VM verwenden, um die IP4-Adresse der VM abzurufen. Wenn Sie den Hostnamen verwenden, versuchen Sie es mit Windows-Hostname-EFLOW.mshome.net. Weitere Informationen zu Netzwerkkonfigurationen finden Sie unter Azure IoT Edge für Linux unter Windows-Netzwerken.
$dnsServer ist keine gültige IP4-Adresse.	Das Cmdlet Set-EflowVmDnsServers erwartet eine Liste mit gültigen IP4-Adressen.	Vergewissern Sie sich, dass Sie eine gültige Liste von Adressen angegeben haben. Sie können die DNS-Server des Windows-Hostbetriebssystems mithilfe des PowerShell-Cmdlets `ipconfig /all` überprüfen und dann nach dem Eintrag DNS-Server suchen. Wenn Sie z. B. zwei DNS-Server mit den IP-Adressen 10.0.1.2 und 10.0.1.3 festlegen möchten, verwenden Sie das Cmdlet `Set-EflowVmDnsServers -dnsServers @("10.0.1.2", "10.0.1.3")`.
Die IP-Adresse des virtuellen Computers konnte nicht abgerufen werden. Der Name des virtuellen Computers konnte nicht abgerufen werden, die IP/MAC-Adresse konnte nicht ermittelt werden. Fehler beim Abrufen der MAC-Adresse für den virtuellen Computer. Fehler beim Abrufen der IP-Adresse für den virtuellen Computer. Das Hostrouting konnte nicht abgerufen werden. Fehler beim Konnektivitätstest mit $computerName. Der WSSDAGENT-Dienst hat die erwartete VNet-Ressource nicht bereitgestellt. Fehlende EFLOW-VM-Gastschnittstelle für ($vnicName).	Verursacht durch Verbindungsprobleme mit dem virtuellen EFLOW-Computer. Die Fehler stehen in der Regel im Zusammenhang mit einer Änderung der IP-Adresse (wenn Sie eine statische IP-Adresse verwenden) oder der fehlenden Zuweisung einer IP-Adresse, wenn Sie einen DHCP-Server verwenden.	Stellen Sie sicher, dass Sie die richtige Netzwerkkonfiguration verwenden. Wenn es einen gültigen DHCP-Server gibt, können Sie die DHCP-Zuweisung verwenden. Wenn Sie eine statische IP-Adresse verwenden, stellen Sie sicher, dass die IP-Konfiguration korrekt ist (alle drei Parameter: ip4Address, ip4GatewayAddress und ip4PrefixLength) und die Adresse nicht von einem anderen Gerät im Netzwerk verwendet wird. Weitere Informationen zu Netzwerkkonfigurationen finden Sie unter Azure IoT Edge für Linux unter Windows-Netzwerken.
Es wurden keine Adapter gefunden, die mit dem Switch „$vnetName“ verbunden sind. Es wurden keine Adapter gefunden, die der Geräte-ID „$adapterGuid“ zugeordnet sind. Es wurden keine dem Adapternamen „$name“ zugeordneten Adapter gefunden. Netzwerk „$vswitchName“ ist nicht vorhanden.	Ursache ist ein Fehler in der Netzwerkkommunikation zwischen dem Windows-Hostbetriebssystem und dem virtuellen EFLOW-Computer.	Stellen Sie sicher, dass Sie die EFLOW-VM erreichen und einen SSH-Kanal einrichten können. Verwenden Sie das PowerShell-Cmdlet `Connect-EflowVm`, um eine Verbindung mit dem virtuellen Computer herzustellen. Wenn bei der Konnektivität ein Fehler auftritt, starten Sie die EFLOW-VM neu und überprüfen sie erneut.
ip4Address und ip4PrefixLength sind für StaticIP erforderlich!	Während der Bereitstellung der EFLOW-VM oder beim Hinzufügen mehrerer NICs, wenn sie statische IP-Adressen verwenden, werden die drei statischen IP-Parameter benötigt: ip4Address, ip4GatewayAddress, ip4PrefixLength.	Weitere Informationen zum PowerShell-Cmdlet `Deploy-EFlow` finden Sie unter PowerShell-Funktionen für IoT Edge für Linux unter Windows.
Mehrere VMMS-Switches gefunden mit dem Namen „$switchName“ vom Typ „$switchType“.	Es gibt zwei oder mehr virtuelle Switches mit demselben Namen und Typ. Diese Umgebung steht im Konflikt mit der EFLOW-VM-Installation und dem Lebenszyklus der VM.	Verwenden Sie PowerShell-Cmdlet `Get-VmSwitch`, um die auf dem Windows-Host verfügbaren virtuellen Switches zu überprüfen und sicherzustellen, dass jede {name,type}-Instanz eindeutig ist.

Nächste Schritte

Haben Sie möglicherweise einen Fehler in IoT Edge für Linux unter Windows gefunden? Melden Sie ein Problem, damit wir die Plattform weiter verbessern können.

Wenn Sie weitere Fragen haben, erstellen Sie eine Supportanfrage, um Hilfe zu erhalten.

Freigeben über