Freigeben über

PowerShell-Funktionen für IoT Edge für Linux unter Windows

  • Artikel

Gilt für: Häkchen für IoT Edge 1.5 IoT Edge 1.5 IoT Edge 1.4 Häkchen IoT Edge 1.4

Wichtig

IoT Edge 1.5 LTS und IoT Edge 1.4 LTS sind unterstützte Releases. Das Ende der Lebensdauer von IoT Edge 1.4 LTS wird am 12. November 2024 erreicht. Wenn Sie ein früheres Release verwenden, finden Sie weitere Informationen unter Aktualisieren von IoT Edge.

Informieren Sie sich über die PowerShell-Funktionen, mit denen Sie Ihren virtuellen IoT Edge für Linux unter Windows (EFLOW)-Computer bereitstellen und seinen Status abrufen können.

Voraussetzungen

Die in diesem Artikel beschriebenen Befehle stammen aus der Datei AzureEFLOW.psm1, die Sie auf Ihrem System in Ihrem Verzeichnis WindowsPowerShell unter C:\Program Files\WindowsPowerShell\Modules\AzureEFLOW finden können.

Wenn Ihr PowerShell-Verzeichnis nicht den Ordner AzureEflow enthält, führen Sie die folgenden Schritte zum Herunterladen und Installieren von Azure IoT Edge für Linux unter Windows aus:

  1. Führen Sie in einer PowerShell-Sitzung mit erhöhten Rechten die folgenden Befehle nacheinander 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 angeben, indem Sie dem Installationsbefehl die Parameter INSTALLDIR="<FULLY_QUALIFIED_PATH>" und VHDXDIR="<FULLY_QUALIFIED_PATH>" hinzufügen.

  3. Legen Sie die Ausführungsrichtlinie auf dem Zielgerät auf mindestens AllSigned fest.

    Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force

Add-EflowNetwork

Mit dem Befehl Add-EflowNetwork wird dem virtuellen EFLOW-Computer ein neues Netzwerk hinzugefügt. Dieser Befehl nimmt zwei Parameter an.

Parameter Zulässige Werte Kommentare
vswitchName Name des virtuellen Netzwerks Name des virtuellen Switches, der dem virtuellen EFLOW-Computer zugewiesen wurde.
vswitchType Intern oder Extern Typ des virtuellen Switches, der dem virtuellen EFLOW-Computer zugewiesen wurde.

Er gibt ein Objekt mit vier Eigenschaften zurück:

  • Name
  • AllocationMethod
  • Cidr
  • type

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Add-EflowNetwork -full.

Add-EflowVmEndpoint

Mit dem Befehl Add-EflowVmEndpoint wird dem virtuellen EFLOW-Computer ein neuer Netzwerkendpunkt hinzugefügt. Verwenden Sie die optionalen Parameter zum Festlegen einer statischen IP-Adresse.

Parameter Zulässige Werte Kommentare
vswitchName Name des virtuellen Netzwerks Name des virtuellen Switches, der dem virtuellen EFLOW-Computer zugewiesen wurde.
vendpointName Name des virtuellen Endpunkts Name des virtuellen Endpunkts, der dem virtuellen EFLOW-Computer zugewiesen wurde.
ip4Address IPv4-Adresse im Bereich des DHCP-Serverbereichs Statische Ipv4-Adresse des virtuellen EFLOW-Computers.
ip4PrefixLength IPv4-Präfixlänge des Subnetzes Ipv4-Subnetzpräfixlänge; nur gültig, wenn eine statische Ipv4-Adresse angegeben wird.
ip4GatewayAddress IPv4-Adresse des Subnetzgateways Ipv4-Gatewayadresse; nur gültig, wenn eine statische Ipv4-Adresse angegeben wird.

Er gibt ein Objekt mit vier Eigenschaften zurück:

  • Name
  • MacAddress
  • HealthStatus
  • IPConfiguration

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Add-EflowVmEndpoint -full.

Add-EflowVmSharedFolder

Mithilfe des Befehls Add-EflowVmSharedFolder können Ordner des Windows-Hostbetriebssystems für den virtuellen EFLOW-Computer freigegeben werden.

Parameter Zulässige Werte Kommentare
sharedFoldersJsonPath String Pfad zur JSON-Konfigurationsdatei für freigegebene Ordner.

Die JSON-Konfigurationsdatei muss die folgende Struktur aufweisen:

  • sharedFOlderRoot: Pfad zum Windows-Stammordner, der alle Ordner enthält, die für den virtuellen EFLOW-Computer freigegeben werden sollen
  • hostFolderPath: Relativer Pfad (zum übergeordneten Stammordner) des Ordners, der für den virtuellen EFLOW-Computer freigegeben werden soll
  • readOnly: Legt fest, ob vom virtuellen EFLOW-Computer in den freigegebenen Ordner geschrieben werden kann oder ob der Ordner schreibgeschützt ist. Werte: false oder true
  • targetFolderOnGuest : Ordnerpfad innerhalb des virtuellen EFLOW-Computers, auf dem der Windows-Hostbetriebssystemordner bereitgestellt wird.
[
   {
      "sharedFolderRoot": "<shared-folder-root-windows-path>",
      "sharedFolders": [ 
        { "hostFolderPath": "<path-shared-folder>", 
            "readOnly": "<read-only>", 
            "targetFolderOnGuest": "<linux-mounting-point>" 
        }
      ]
   }
]

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Add-EflowVmSharedFolder -full.

Connect-EflowVm

Der Befehl Connect-EflowVm stellt mithilfe von SSH eine Verbindung mit dem virtuellen Computer her. Das einzige Konto, das zum Herstellen eines SSH mit dem virtuellen Computer zulässig ist, ist der Benutzer, der es erstellt.

Dieser Befehl funktioniert nur bei einer PowerShell-Sitzung, die auf dem Hostgerät ausgeführt wird. Er funktioniert nicht, wenn Windows Admin Center oder PowerShell ISE verwendet wird.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Connect-EflowVm -full.

Copy-EflowVmFile

Mit dem Befehl Copy-EflowVmFile wird die Datei mithilfe von SCP auf den bzw. vom virtuellen Computer kopiert. Verwenden Sie die optionalen Parameter zur Angabe der Quell- und Zieldateipfade sowie der Richtung für die Kopie.

Der Benutzer iotedge-user muss Leseberechtigung für alle Ursprungsverzeichnisse oder Schreibberechtigung für alle Zielverzeichnisse auf dem virtuellen Computer haben.

Parameter Zulässige Werte Kommentare
fromFile Zeichenfolge, die den Pfad zur Datei darstellt Definiert die Datei, aus der gelesen werden soll.
toFile Zeichenfolge, die den Pfad zur Datei darstellt Definiert die Datei, in die geschrieben werden soll.
pushFile Keine Dieses Flag gibt die Kopierrichtung an. Falls vorhanden, pusht der Befehl die Datei auf den virtuellen Computer. Falls vorhanden, pullt der Befehl die Datei vom virtuellen Computer.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Copy-EflowVMFile -full.

Deploy-Eflow

Der Befehl Deploy-Eflow ist die Hauptbereitstellungsmethode. Der Bereitstellungsbefehl erstellt den virtuellen Computer und stellt Dateien sowie das IoT Edge-Agentmodul bereit. Obwohl keiner der Parameter erforderlich ist, können sie verwendet werden, um Einstellungen für den virtuellen Computer während der Erstellung zu ändern.

Parameter Zulässige Werte Kommentare
acceptEula Ja oder Nein Eine Verknüpfung zum Akzeptieren/Verweigern des EULA (End User Licence Agreement, Endbenutzer-Lizenzvertrag) und Umgehen der EULA-Eingabeaufforderung.
acceptOptionalTelemetry Ja oder Nein Eine Verknüpfung zum Akzeptieren/Verweigern von optionaler Telemetrie und zum Umgehen der Telemetrieaufforderung.
cpuCount Ganzzahliger Wert zwischen 1 und den CPU-Kernen des Geräts Anzahl der CPU-Kerne für den virtuellen Computer.

Standardwert: 1 virtueller Kern.
memoryInMB Ganzzahliger, gerader Wert zwischen 1024 und der maximalen Menge an freiem Arbeitsspeicher des Geräts Der für den virtuellen Computer zugeordnete Arbeitsspeicher.

Standardwert: 1.024 MB.
vmDiskSize Zwischen 21 GB und 2 TB Maximale logische Datenträgergröße der dynamisch erweiterbaren virtuellen Festplatte

Standardwert: 29 GB

Hinweis: Es kann entweder vmDiskSize oder vmDataSize verwendet werden, aber nicht beide zusammen.
vmDataSize Zwischen 2 GB und 2 TB Maximale Größe der Datenpartition der resultierenden Festplatte in GB

Standardwert: 10 GB

Hinweis: Es kann entweder vmDiskSize oder vmDataSize verwendet werden, aber nicht beide zusammen.
vmLogSize Klein oder Groß Geben sie die Größe der Protokollpartition an. Klein = 1 GB, Groß = 6 GB

Standardwert: Klein
vswitchName Name des virtuellen Netzwerks Name des virtuellen Switches, der dem virtuellen EFLOW-Computer zugewiesen wurde.
vswitchType Intern oder Extern Typ des virtuellen Switches, der dem virtuellen EFLOW-Computer zugewiesen wurde.
ip4Address IPv4-Adresse im Bereich des DHCP-Serverbereichs Statische Ipv4-Adresse des virtuellen EFLOW-Computers.
ip4PrefixLength IPv4-Präfixlänge des Subnetzes Ipv4-Subnetzpräfixlänge; nur gültig, wenn eine statische Ipv4-Adresse angegeben wird.
ip4GatewayAddress IPv4-Adresse des Subnetzgateways Ipv4-Gatewayadresse; nur gültig, wenn eine statische Ipv4-Adresse angegeben wird.
gpuName GPU-Gerätename Name des GPU-Geräts, das für Passthrough verwendet werden soll.
gpuPassthroughType DirectDeviceAssignment, ParaVirtualization oder keine (nur CPU) GPU-Passthrough-Typ
gpuCount Ganzzahliger Wert zwischen 1 und der Anzahl der GPU-Kerne des Geräts Anzahl der GPU-Geräte für den virtuellen Computer.

Hinweis: Wenn Sie „ParaVirtualization“ verwenden, müssen Sie „gpuCount = 1“ festlegen.
customSsh Keine Gibt an, ob der Benutzer seine benutzerdefinierte OpenSSH.Client-Installation verwenden möchte. Falls vorhanden, muss ssh.exe für EFLOW PSM verfügbar sein.
sharedFoldersJsonPath String Pfad zur JSON-Konfigurationsdatei für freigegebene Ordner.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Deploy-Eflow -full.

Get-EflowHostConfiguration

Der Befehl Get-EflowHostConfiguration gibt die Hostkonfiguration zurück. Bei diesem Befehl werden keine Parameter verwendet. Er gibt ein Objekt mit vier Eigenschaften zurück:

  • FreePhysicalMemoryInMB
  • NumberOfLogicalProcessors
  • DiskInfo
  • GpuInfo

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Get-EflowHostConfiguration -full.

Get-EflowLogs

Der Befehl Get-EflowLogs sammelt und bündelt Protokolle aus der Bereitstellung und Installation von IoT Edge für Linux unter Windows. Die gebündelten Protokolle werden in Form eines .zip-Ordners ausgegeben.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Get-EflowLogs -full.

Get-EflowNetwork

Der Befehl Get-EflowNetwork gibt eine Liste der Netzwerke zurück, die dem virtuellen EFLOW-Computer zugewiesen sind. Verwenden Sie den optionalen Parameter, um ein bestimmtes Netzwerk abzurufen.

Parameter Zulässige Werte Kommentare
vswitchName Name des virtuellen Netzwerks Name des virtuellen Switches, der dem virtuellen EFLOW-Computer zugewiesen wurde.

Es wird eine Liste von Objekten zurückgegeben, die vier Eigenschaften enthält:

  • Name
  • AllocationMethod
  • Cidr
  • type

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Get-EflowNetwork -full.

Get-EflowVm

Der Befehl Get-EflowVm gibt die aktuelle Konfiguration des virtuellen Computers zurück. Bei diesem Befehl werden keine Parameter verwendet. Er gibt ein Objekt mit vier Eigenschaften zurück:

  • VmConfiguration
  • VmPowerState
  • EdgeRuntimeVersion
  • EdgeRuntimeStatus
  • SystemStatistics

Wenn Sie eine bestimmte Eigenschaft in einer lesbaren Liste anzeigen möchten, führen Sie den Befehl Get-EflowVM mit der erweiterten Eigenschaft aus. Zum Beispiel:

Get-EflowVM | Select -ExpandProperty VmConfiguration | Format-List

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Get-EflowVm -full.

Get-EflowVmAddr

Mit dem Befehl Get-EflowVmAddr wird die aktuelle IP- und MAC-Adresse des virtuellen Computers abgefragt. Mit diesem Befehl wird die Tatsache berücksichtigt, dass sich die IP- und MAC-Adresse im Laufe der Zeit ändern kann.

Wenn Sie zusätzliche Informationen benötigen, verwenden Sie den Befehl Get-Help Get-EflowVmAddr -full.

Get-EflowVmEndpoint

Der Befehl Get-EflowVmEndpoint gibt eine Liste der Netzwerkendpunkte zurück, die dem virtuellen EFLOW-Computer zugewiesen sind. Verwenden Sie den optionalen Parameter, um einen bestimmten Netzwerkendpunkt abzurufen.

Parameter Zulässige Werte Kommentare
vswitchName Name des virtuellen Netzwerks Name des virtuellen Switches, der dem virtuellen EFLOW-Computer zugewiesen wurde.

Es wird eine Liste von Objekten zurückgegeben, die vier Eigenschaften enthält:

  • Name
  • MacAddress
  • HealthStatus
  • IPConfiguration

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Get-EflowVmEndpoint -full.

Get-EflowVmFeature

Der Befehl Get-EflowVmFeature gibt den Status der Aktivierung von IoT Edge für Linux unter Windows-Features zurück.

Parameter Zulässige Werte Kommentare
feature DpsTpm Der abzufragende Featurename

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Get-EflowVmFeature -full.

Get-EflowVmName

Der Befehl Get-EflowVmName gibt den aktuellen Hostnamen des virtuellen Computers zurück. So wird die Tatsache berücksichtigt, dass sich der Windows-Hostname im Laufe der Zeit ändern kann.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Get-EflowVmName -full.

Get-EflowVmSharedFolder

Der Befehl Get-EflowVmSharedFolder gibt die Informationen zu Ordnern des Windows-Hostbetriebssystems zurück, die für den virtuellen EFLOW-Computer freigegeben wurden.

Parameter Zulässige Werte Kommentare
sharedfolderRoot String Pfad zum freigegebenen Stammordner des Windows-Hostbetriebssystems
hostFolderPath Zeichenfolge oder Liste Relative Pfade (zum Stammordner) der freigegebenen Ordner des Windows-Hostbetriebssystems.

Es wird eine Liste von Objekten zurückgegeben, die drei Eigenschaften enthält:

  • hostFolderPath: Relativer Pfad (zum übergeordneten Stammordner) des Ordners, der für den virtuellen EFLOW-Computer freigegeben wird
  • readOnly: Legt fest, ob vom virtuellen EFLOW-Computer in den freigegebenen Ordner geschrieben werden kann oder ob der Ordner schreibgeschützt ist. Werte: false oder true
  • targetFolderOnGuest: Ordnerpfad auf dem virtuellen EFLOW-Computer, in dem der Windows-Ordner bereitgestellt wird

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Get-EflowVmSharedFolder -full.

Get-EflowVmTelemetryOption

Der Befehl Get-EflowVmTelemetryOption zeigt den Status der Telemetrie (entweder Optional oder Erforderlich) im virtuellen Computer an.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Get-EflowVmTelemetryOption -full.

Get-EflowVmTpmProvisioningInfo

Der Befehl Get-EflowVmTpmProvisioningInfo gibt die TPM-Bereitstellungsinformationen zurück. Bei diesem Befehl werden keine Parameter verwendet. Er gibt ein Objekt mit zwei Eigenschaften zurück:

  • Endorsement Key
  • Registrierungs-ID

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Get-EflowVmTpmProvisioningInfo -full.

Invoke-EflowVmCommand

Der Befehl Invoke-EflowVMCommand führt einen Linux-Befehl im virtuellen Computer aus und gibt die Ausgabe zurück. Dieser Befehl funktioniert nur bei Linux-Befehlen, die eine finite Ausgabe zurückgeben. Er kann nicht bei Linux-Befehlen verwendet werden, die eine Benutzerinteraktion erfordern oder unbegrenzt ausgeführt werden.

Mit den folgenden optionalen Parametern kann der Befehl im Voraus angegeben werden.

Parameter Zulässige Werte Kommentare
Befehl String Befehl, der im virtuellen Computer ausgeführt werden soll.
ignoreError Keine Wenn dieses Flag vorhanden ist, ignorieren Sie Fehler aus dem Befehl.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Invoke-EflowVmCommand -full.

Provision-EflowVm

Der Befehl Provision-EflowVm fügt die Bereitstellungsinformationen für Ihr IoT Edge-Gerät der IoT Edge-Datei config.yaml des virtuellen Computers hinzu.

Parameter Zulässige Werte Kommentare
provisioningType ManualConnectionString, ManualX509, DpsTPM, DpsX509 oder DpsSymmetricKey Definiert den Bereitstellungstyp, den Sie für Ihr IoT Edge-Gerät verwenden möchten.
devConnString Die Geräteverbindungszeichenfolge eines vorhandenen IoT Edge-Geräts Geräteverbindungszeichenfolge zum manuellen Bereitstellen eines IoT Edge-Geräts (ManualConnectionString).
iotHubHostname Der Hostname eines vorhandenen IoT-Hubs Azure IoT-Hub-Hostname für die Bereitstellung eines IoT Edge-Geräts (ManualX509).
deviceId Die Geräte-ID eines vorhandenen IoT Edge-Geräts Geräte-ID für die Bereitstellung eines IoT Edge-Geräts (ManualX509).
scopeId Die Bereichs-ID für eine vorhandene DPS-Instanz. Bereichs-ID für die Bereitstellung eines IoT Edge-Geräts (DpsTPM, DpsX509 oder DpsSymmetricKey).
symmKey Der Primärschlüssel für eine vorhandene DPS-Registrierung oder der Primärschlüssel eines vorhandenen IoT Edge-Geräts, das mithilfe von symmetrischen Schlüsseln registriert wurde Symmetrischer Schlüssel für die Bereitstellung eines IoT Edge-Geräts (DpsSymmetricKey).
registrationId Die Registrierungs-ID eines vorhandenen IoT Edge-Geräts Registrierungs-ID für die Bereitstellung eines IoT Edge-Geräts (DpsSymmetricKey, DpsTPM).
identityCertPath Verzeichnispfad Absoluter Zielpfad des Identitätszertifikats auf Ihrem Windows-Hostcomputer (ManualX509, DpsX509).
identityPrivKeyPath Verzeichnispfad Absoluter Quellpfad des privaten Identitätsschlüssels auf Ihrem Windows-Hostcomputer (ManualX509, DpsX509).
globalEndpoint Geräteendpunkt-URL URL für den globalen Endpunkt, der für die DPS-Bereitstellung verwendet werden soll.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Provision-EflowVm -full.

Remove-EflowNetwork

Der Befehl Remove-EflowNetwork entfernt ein vorhandenes Netzwerk, das an den virtuellen EFLOW-Computer angeschlossen ist. Dieser Befehl akzeptiert einen Parameter.

Parameter Zulässige Werte Kommentare
vswitchName Name des virtuellen Netzwerks Name des virtuellen Switches, der dem virtuellen EFLOW-Computer zugewiesen wurde.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Remove-EflowNetwork -full.

Remove-EflowVmEndpoint

Der Befehl Remove-EflowVmEndpoint entfernt einen vorhandenen Netzwerkendpunkt, der an den virtuellen EFLOW-Computer angeschlossen ist. Dieser Befehl akzeptiert einen Parameter.

Parameter Zulässige Werte Kommentare
vendpointName Name des virtuellen Endpunkts Name des virtuellen Endpunkts, der dem virtuellen EFLOW-Computer zugewiesen wurde.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Remove-EflowVmEndpoint -full.

Remove-EflowVmSharedFolder

Der Befehl Remove-EflowVmSharedFolder beendet die Freigabe des Ordners des Windows-Hostbetriebssystems für den virtuellen EFLOW-Computer. Dieser Befehl nimmt zwei Parameter an.

Parameter Zulässige Werte Kommentare
sharedfolderRoot String Pfad zum freigegebenen Stammordner des Windows-Hostbetriebssystems
hostFolderPath Zeichenfolge oder Liste Relative Pfade (zum Stammordner) der freigegebenen Ordner des Windows-Hostbetriebssystems.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Remove-EflowVmSharedFolder -full.

Set-EflowVM

Der Befehl Set-EflowVM aktualisiert die Konfiguration des virtuellen Computers mit den angeforderten Eigenschaften. Verwenden Sie die optionalen Parameter zum Definieren einer bestimmten Konfiguration für den virtuellen Computer.

Parameter Zulässige Werte Kommentare
cpuCount Ganzzahliger Wert zwischen 1 und den CPU-Kernen des Geräts Anzahl der CPU-Kerne für den virtuellen Computer.
memoryInMB Ganzzahliger Wert zwischen 1.024 und der maximalen Menge an freiem Arbeitsspeicher des Geräts Der für den virtuellen Computer zugeordnete Arbeitsspeicher.
gpuName GPU-Gerätename Name des GPU-Geräts, das für Passthrough verwendet werden soll.
gpuPassthroughType DirectDeviceAssignment, ParaVirtualization oder keine (kein Passthrough) GPU-Passthrough-Typ
gpuCount Ganzzahliger Wert zwischen 1 und den GPU-Kernen des Geräts Anzahl der GPU-Geräte für den virtuellen Computer Hinweis: Nur gültig, wenn „DirectDeviceAssignment“ verwendet wird
headless Keine Wenn dieses Flag vorhanden ist, bestimmt es, ob der Benutzer eine ausgegebene Sicherheitswarnung bestätigen muss.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Set-EflowVM -full.

Set-EflowVmDNSServers

Mit dem Befehl Set-EflowVmDNSServers werden die DNS-Server für den virtuellen EFLOW-Computer konfiguriert.

Parameter Zulässige Werte Kommentare
vendpointName Zeichenfolgenwert des Namens des virtuellen Endpunkts Verwenden Sie Get-EflowVmEndpoint, um die virtuellen Schnittstellen zu erhalten, die dem virtuellen EFLOW-Computer zugewiesen sind. Beispiel: DESKTOP-CONTOSO-EflowInterface
dnsServers Liste mit IP-Adresse der DNS-Server für die Namensauflösung Beispiel: @("10.0.10.1")

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Set-EflowVmDNSServers -full.

Set-EflowVmFeature

Der Befehl Set-EflowVmFeature aktiviert oder deaktiviert den Status von IoT Edge für Linux unter Windows-Features.

Parameter Zulässige Werte Kommentare
feature DpsTpm, Defender Featurename zum Umschalten.
enable Keine Wenn dieses Flag vorhanden ist, aktiviert der Befehl das Feature.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Set-EflowVmFeature -full.

Set-EflowVmTelemetryOption

Der Befehl Set-EflowVmTelemetryOption aktiviert oder deaktiviert die optionale Telemetrie im virtuellen Computer.

Parameter Zulässige Werte Kommentare
optionalTelemetry True oder False Gibt an, ob optionale Telemetrie ausgewählt wurde.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Set-EflowVmTelemetryOption -full.

Start-EflowVm

Der Befehl Start-EflowVm startet den virtuellen Computer. Wenn der virtuelle Computer bereits gestartet wurde, wird keine Aktion ausgeführt.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Start-EflowVm -full.

Stop-EflowVm

Der Befehl Stop-EflowVm beendet den virtuellen Computer. Wenn der virtuelle Computer bereits beendet wurde, wird keine Aktion ausgeführt.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Stop-EflowVm -full.

Verify-EflowVm

Der Befehl Verify-EflowVm ist eine verfügbar gemachte Funktion, die überprüft, ob der virtuelle IoT Edge für Linux unter Windows-Computer erstellt wurde. Es verwendet nur allgemeine Parameter und gibt True zurück, wenn der virtuelle Computer erstellt wurde, und False , wenn dies nicht der Fall ist.

Weitere Informationen erhalten Sie mit dem Befehl Get-Help Verify-EflowVm -full.

Nächste Schritte

Im folgenden Artikel erfahren Sie, wie Sie diese Befehle zum Installieren und Bereitstellen von IoT Edge für Linux unter Windows verwenden können: