Megosztás a következőn keresztül:


Az IoT Edge PowerShell-függvények Windowson futtatott Linux rendszerhez

A következőkre vonatkozik: IoT Edge 1.5 pipa IoT Edge 1.5 IoT Edge 1.4 pipa IoT Edge 1.4

Fontos

Az IoT Edge 1.5 LTS és az IoT Edge 1.4 LTS támogatott kiadások. Az IoT Edge 1.4 LTS 2024. november 12-én megszűnik. Ha egy korábbi kiadáson dolgozik, olvassa el az IoT Edge frissítése című témakört.

Ismerje meg azokat a PowerShell-függvényeket, amelyek windowsos (EFLOW) rendszerű virtuális gépen telepítik, építik ki és kapják meg a Linuxhoz készült IoT Edge állapotát.

Előfeltételek

A cikkben ismertetett parancsok a AzureEFLOW.psm1 fájlból származnak, amely a könyvtárban WindowsPowerShell C:\Program Files\WindowsPowerShell\Modules\AzureEFLOWtalálható a rendszerben.

Ha nem rendelkezik az AzureEflow mappával a PowerShell-címtárban, a következő lépésekkel töltse le és telepítse a Linuxhoz készült Azure IoT Edge-et Windows rendszeren:

  1. Emelt szintű PowerShell-munkamenetben futtassa az alábbi parancsokat a Linuxhoz készült IoT Edge windowsos letöltéséhez.

    • 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. Telepítse az IoT Edge for Linuxot Windows rendszeren az eszközére.

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

    Egyéni telepítési és VHDX-könyvtárakat úgy adhat meg, hogy hozzáadja INSTALLDIR="<FULLY_QUALIFIED_PATH>" és VHDXDIR="<FULLY_QUALIFIED_PATH>" paramétereket a telepítési parancshoz.

  3. Állítsa be a végrehajtási szabályzatot a céleszközön legalább AllSigned.

    Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
    

Add-EflowNetwork

Az Add-EflowNetwork parancs új hálózatot ad hozzá az EFLOW virtuális géphez. Ez a parancs két paramétert használ.

Paraméter Elfogadott értékek Megjegyzések
vswitchName A virtuális kapcsoló neve Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.
vswitchType Belső vagy külső Az EFLOW virtuális géphez rendelt virtuális kapcsoló típusa.

Egy négy tulajdonságot tartalmazó objektumot ad vissza:

  • Név
  • AllocationMethod
  • Cidr
  • Típus

További információkért használja a parancsot Get-Help Add-EflowNetwork -full.

Add-EflowVmEndpoint

Az Add-EflowVmEndpoint parancs új hálózati végpontot ad hozzá az EFLOW virtuális géphez. Statikus IP-cím beállításához használja az opcionális paramétereket.

Paraméter Elfogadott értékek Megjegyzések
vswitchName A virtuális kapcsoló neve Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.
vendpointName A virtuális végpont neve Az EFLOW virtuális géphez hozzárendelt virtuális végpont neve.
ip4Address IPv4-cím a DCHP-kiszolgáló hatókörének tartományában Az EFLOW virtuális gép statikus Ipv4-címe.
ip4PrefixLength Az alhálózat IPv4-előtagjának hossza Az Ipv4-alhálózat előtag hossza csak statikus Ipv4-cím megadásakor érvényes.
ip4GatewayAddress Az alhálózati átjáró IPv4-címe Átjáró Ipv4-címe, csak akkor érvényes, ha statikus Ipv4-cím van megadva.

Egy négy tulajdonságot tartalmazó objektumot ad vissza:

  • Név
  • MacAddress
  • HealthStatus
  • IpConfiguration

További információkért használja a parancsot Get-Help Add-EflowVmEndpoint -full.

Add-EflowVmSharedFolder

Az Add-EflowVmSharedFolder parancs lehetővé teszi egy vagy több Windows gazdagép operációs rendszer mappájának megosztását az EFLOW virtuális géppel.

Paraméter Elfogadott értékek Megjegyzések
sharedFoldersJsonPath Sztring A megosztott mappák JSON-konfigurációs fájljának elérési útja.

A JSON-konfigurációs fájlnak a következő struktúrával kell rendelkeznie:

  • sharedFOlderRoot : Az EFLOW virtuális géppel megosztandó összes mappát tartalmazó Windows gyökérmappa elérési útja.
  • hostFolderPath: Az EFLOW virtuális géppel megosztani kívánt mappa relatív elérési útja (a szülő gyökérmappához).
  • readOnly: Meghatározza, hogy a megosztott mappa írható vagy írásvédett-e az EFLOW virtuális gépről – Értékek: hamis vagy igaz.
  • targetFolderOnGuest : Mappa elérési útja az EFLOW virtuális gépen belül, amelyen a Windows gazdagép operációs rendszer mappája csatlakoztatva van.
[
   {
      "sharedFolderRoot": "<shared-folder-root-windows-path>",
      "sharedFolders": [ 
        { "hostFolderPath": "<path-shared-folder>", 
            "readOnly": "<read-only>", 
            "targetFolderOnGuest": "<linux-mounting-point>" 
        }
      ]
   }
]

További információkért használja a parancsot Get-Help Add-EflowVmSharedFolder -full.

Connect-EflowVm

A Connect-EflowVm parancs SSH használatával csatlakozik a virtuális géphez. A virtuális gép számára az egyetlen SSH-fiók az, aki létrehozta.

Ez a parancs csak a gazdaeszközön futó PowerShell-munkameneteken működik. Nem fog működni a Windows Felügyeleti központ vagy a PowerShell ISE használatakor.

További információkért használja a parancsot Get-Help Connect-EflowVm -full.

Copy-EflowVmFile

A Copy-EflowVmFile parancs az SCP használatával másolja a fájlt a virtuális gépre vagy onnan. A választható paraméterekkel megadhatja a forrás- és célfájl elérési útját és a másolat irányát.

A felhasználó iotedge-felhasználónak olvasási engedéllyel kell rendelkeznie a forráskönyvtárakhoz, vagy írási engedéllyel kell rendelkeznie a virtuális gép bármely célkönyvtárához.

Paraméter Elfogadott értékek Megjegyzések
fromFile A fájl elérési útját képviselő karakterlánc Meghatározza a beolvasandó fájlt.
toFile A fájl elérési útját képviselő karakterlánc Meghatározza a beírandó fájlt.
pushFile Egyik sem Ez a jelző a másolás irányát jelzi. Ha van ilyen, a parancs leküldi a fájlt a virtuális gépre. Ha hiányzik, a parancs lekéri a fájlt a virtuális gépről.

További információkért használja a parancsot Get-Help Copy-EflowVMFile -full.

Deploy-Eflow

A központi telepítési módszer a Deploy-Eflow parancs. Az üzembe helyezési parancs létrehozza a virtuális gépet, kiépít fájlokat, és üzembe helyezi az IoT Edge-ügynökmodult. Bár egyik paraméter sem szükséges, a virtuális gép beállításainak módosítására használhatók a létrehozás során.

Paraméter Elfogadott értékek Megjegyzések
acceptEula Igen vagy Nem Az EULA elfogadására/elutasítására és az EULA-kérés megkerülésére vonatkozó parancsikon.
acceptOptionalTelemetry Igen vagy Nem Parancsikon az opcionális telemetriai adatok elfogadásához/elutasításához, valamint a telemetriai kérés megkerüléséhez.
cpuCount 1 és az eszköz processzormagjai közötti egész szám A virtuális gép processzormagjainak száma.

Alapértelmezett érték: 1 virtuális mag.
memoryInMB Páros egész szám 1024 és az eszköz szabad memóriájának maximális mennyisége között A virtuális gép számára lefoglalt memória.

Alapértelmezett érték: 1024 MB.
vmDiskSize 21 GB és 2 TB között A dinamikusan bővülő virtuális merevlemez maximális logikai lemezmérete.

Alapértelmezett érték: 29 GB.

Megjegyzés: A vmDiskSize vagy a vmDataSize használható, de nem egyszerre.
vmDataSize 2 GB és 2 TB között Az eredményként kapott merevlemez maximális adatpartíciós mérete GB-ban.

Alapértelmezett érték: 10 GB.

Megjegyzés: A vmDiskSize vagy a vmDataSize használható, de nem egyszerre.
vmLogSize Kicsi vagy Nagy Adja meg a naplópartíció méretét. Kicsi = 1 GB, Nagy = 6 GB.

Alapértelmezett érték: Kicsi.
vswitchName A virtuális kapcsoló neve Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.
vswitchType Belső vagy külső Az EFLOW virtuális géphez rendelt virtuális kapcsoló típusa.
ip4Address IPv4-cím a DCHP-kiszolgáló hatókörének tartományában Az EFLOW virtuális gép statikus Ipv4-címe.
ip4PrefixLength Az alhálózat IPv4-előtagjának hossza Az Ipv4-alhálózat előtag hossza csak statikus Ipv4-cím megadásakor érvényes.
ip4GatewayAddress Az alhálózati átjáró IPv4-címe Átjáró Ipv4-címe, csak akkor érvényes, ha statikus Ipv4-cím van megadva.
gpuName GPU-eszköz neve Az átengedéshez használandó GPU-eszköz neve.
gpuPassthroughType DirectDeviceAssignment, ParaVirtualization vagy none (csak CPU) GPU-átengedés típusa
gpuCount 1 és az eszköz GPU-magjainak száma közötti egész szám A virtuális gép GPU-eszközeinek száma.

Megjegyzés: ParaVirtualization használata esetén mindenképpen állítsa be a gpuCount = 1 értéket
customSsh Egyik sem Meghatározza, hogy a felhasználó szeretné-e használni az egyéni OpenSSH.Client-telepítést. Ha van ilyen, ssh.exe elérhetőnek kell lennie az EFLOW PSM számára
sharedFoldersJsonPath Sztring A megosztott mappák JSON-konfigurációs fájljának elérési útja.

További információkért használja a parancsot Get-Help Deploy-Eflow -full.

Get-EflowHostConfiguration

A Get-EflowHostConfiguration parancs visszaadja a gazdagép konfigurációját. Ez a parancs nem vesz fel paramétereket. Egy négy tulajdonságot tartalmazó objektumot ad vissza:

  • FreePhysicalMemoryInMB
  • NumberOfLogicalProcessors
  • DiskInfo
  • GpuInfo

További információkért használja a parancsot Get-Help Get-EflowHostConfiguration -full.

Get-EflowLogs

A Get-EflowLogs parancs összegyűjti és csomagolja a naplókat a Linuxhoz készült IoT Edge-ből Windows-telepítés és -telepítés esetén. A csomagban lévő naplókat mappa formájában .zip adja ki.

További információkért használja a parancsot Get-Help Get-EflowLogs -full.

Get-EflowNetwork

A Get-EflowNetwork parancs az EFLOW virtuális géphez rendelt hálózatok listáját adja vissza. Egy adott hálózat lekéréséhez használja az opcionális paramétert.

Paraméter Elfogadott értékek Megjegyzések
vswitchName A virtuális kapcsoló neve Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.

Négy tulajdonságot tartalmazó objektumlistát ad vissza:

  • Név
  • AllocationMethod
  • Cidr
  • Típus

További információkért használja a parancsot Get-Help Get-EflowNetwork -full.

Get-EflowVm

A Get-EflowVm parancs visszaadja a virtuális gép aktuális konfigurációját. Ez a parancs nem vesz fel paramétereket. Egy négy tulajdonságot tartalmazó objektumot ad vissza:

  • VmConfiguration
  • VmPowerState
  • EdgeRuntimeVersion
  • EdgeRuntimeStatus
  • SystemStatistics

Ha egy adott tulajdonságot egy olvasható listában szeretne megtekinteni, futtassa a Get-EflowVM parancsot a kibontott tulajdonsággal. Példa:

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

További információkért használja a parancsot Get-Help Get-EflowVm -full.

Get-EflowVmAddr

A Get-EflowVmAddr paranccsal lekérdezhető a virtuális gép aktuális IP- és MAC-címe. Ez a parancs azért létezik, hogy figyelembe vehesse azt a tényt, hogy az IP- és MAC-cím idővel változhat.

További információkért használja a parancsot Get-Help Get-EflowVmAddr -full.

Get-EflowVmEndpoint

A Get-EflowVmEndpoint parancs az EFLOW virtuális géphez rendelt hálózati végpontok listáját adja vissza. Az opcionális paraméterrel lekérhet egy adott hálózati végpontot.

Paraméter Elfogadott értékek Megjegyzések
vswitchName A virtuális kapcsoló neve Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.

Négy tulajdonságot tartalmazó objektumlistát ad vissza:

  • Név
  • MacAddress
  • HealthStatus
  • IpConfiguration

További információkért használja a parancsot Get-Help Get-EflowVmEndpoint -full.

Get-EflowVmFeature

A Get-EflowVmFeature parancs a Linuxhoz készült IoT Edge windowsos funkcióinak engedélyezésének állapotát adja vissza.

Paraméter Elfogadott értékek Megjegyzések
funkció DpsTpm A lekérdezéshez szükséges szolgáltatásnév.

További információkért használja a parancsot Get-Help Get-EflowVmFeature -full.

Get-EflowVmName

A Get-EflowVmName parancs a virtuális gép aktuális állomásnevét adja vissza. Ez a parancs azt a tényt szeretné figyelembe venni, hogy a Windows-állomásnév idővel változhat.

További információkért használja a parancsot Get-Help Get-EflowVmName -full.

Get-EflowVmSharedFolder

A Get-EflowVmSharedFolder parancs egy vagy több, az EFLOW virtuális géppel megosztott Windows-gazdagép operációsrendszer-mappájával kapcsolatos információt ad vissza.

Paraméter Elfogadott értékek Megjegyzések
sharedfolderRoot Sztring A Windows gazdagép operációs rendszer megosztott gyökérmappájának elérési útja.
hostFolderPath Sztring vagy lista A Windows gazdagép operációs rendszer megosztott mappájának/mappáinak relatív elérési útjai (a gyökérmappához).

Három tulajdonságot tartalmazó objektumlistát ad vissza:

  • hostFolderPath: Az EFLOW virtuális géppel megosztott mappa relatív elérési útja (a szülő gyökérmappához).
  • readOnly: Meghatározza, hogy a megosztott mappa írható vagy írásvédett-e az EFLOW virtuális gépről – Értékek: hamis vagy igaz.
  • targetFolderOnGuest: Mappa elérési útja az EFLOW virtuális gépen belül, amelyen a Windows mappa csatlakoztatva van.

További információkért használja a parancsot Get-Help Get-EflowVmSharedFolder -full.

Get-EflowVmTelemetryOption

A Get-EflowVmTelemetryOption parancs megjeleníti a telemetria állapotát (opcionális vagy kötelező) a virtuális gépen belül.

További információkért használja a parancsot Get-Help Get-EflowVmTelemetryOption -full.

Get-EflowVmTpmProvisioningInfo

A Get-EflowVmTpmProvisioningInfo parancs a TPM kiépítési adatait adja vissza. Ez a parancs nem vesz fel paramétereket. Két tulajdonságot tartalmazó objektumot ad vissza:

  • Ellenőrzőkulcs
  • Regisztráció azonosítója

További információkért használja a parancsot Get-Help Get-EflowVmTpmProvisioningInfo -full.

Invoke-EflowVmCommand

Az Invoke-EflowVMCommand parancs végrehajt egy Linux-parancsot a virtuális gépen belül, és visszaadja a kimenetet. Ez a parancs csak olyan Linux-parancsok esetén működik, amelyek véges kimenetet adnak vissza. Nem használható olyan Linux-parancsokhoz, amelyek felhasználói beavatkozást igényelnek, vagy határozatlan ideig futnak.

A parancs előre történő megadásához az alábbi választható paraméterek használhatók.

Paraméter Elfogadott értékek Megjegyzések
command Sztring A virtuális gépen végrehajtandó parancs.
ignoreError Egyik sem Ha ez a jelző jelen van, hagyja figyelmen kívül a parancs hibáit.

További információkért használja a parancsot Get-Help Invoke-EflowVmCommand -full.

Provision-EflowVm

A Provision-EflowVm parancs hozzáadja az IoT Edge-eszköz kiépítési adatait a virtuális gép IoT Edge-fájljához config.yaml .

Paraméter Elfogadott értékek Megjegyzések
provisioningType ManualConnectionString, ManualX509, DpsTPM, DpsX509 vagy DpsSymmetricKey Meghatározza az IoT Edge-eszközhöz használni kívánt kiépítés típusát.
devConnString Meglévő IoT Edge-eszköz kapcsolati sztring eszköz Eszköz kapcsolati sztring IoT Edge-eszköz manuális kiépítéséhez (ManualConnectionString).
iotHubHostname Meglévő IoT Hub gazdagépneve Az Azure IoT Hub gazdagépneve IoT Edge-eszköz (ManualX509) kiépítéséhez.
deviceId Meglévő IoT Edge-eszköz eszközazonosítója Eszközazonosító IoT Edge-eszköz kiépítéséhez (ManualX509).
scopeId Egy meglévő DPS-példány hatókörazonosítója. Hatókörazonosító IoT Edge-eszköz (DpsTPM, DpsX509 vagy DpsSymmetricKey) kiépítéséhez.
symmKey Egy meglévő DPS-regisztráció elsődleges kulcsa vagy egy szimmetrikus kulcsokkal regisztrált meglévő IoT Edge-eszköz elsődleges kulcsa Szimmetrikus kulcs egy IoT Edge-eszköz (DpsSymmetricKey) kiépítéséhez.
registrationId Meglévő IoT Edge-eszköz regisztrációs azonosítója Regisztrációs azonosító egy IoT Edge-eszköz kiépítéséhez (DpsSymmetricKey, DpsTPM).
identityCertPath Címtár útvonala Az identitástanúsítvány abszolút célútvonala a Windows-gazdagépen (ManualX509, DpsX509).
identityPrivKeyPath Címtár útvonala Az identitás titkos kulcsának abszolút forrásútvonala a Windows-gazdagépen (ManualX509, DpsX509).
globalEndpoint Eszközvégpont URL-címe A DPS kiépítéséhez használandó globális végpont URL-címe.

További információkért használja a parancsot Get-Help Provision-EflowVm -full.

Remove-EflowNetwork

A Remove-EflowNetwork parancs eltávolítja az EFLOW virtuális géphez csatlakoztatott meglévő hálózatot. Ez a parancs egy paramétert vesz igénybe.

Paraméter Elfogadott értékek Megjegyzések
vswitchName A virtuális kapcsoló neve Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.

További információkért használja a parancsot Get-Help Remove-EflowNetwork -full.

Remove-EflowVmEndpoint

A Remove-EflowVmEndpoint parancs eltávolítja az EFLOW virtuális géphez csatlakoztatott meglévő hálózati végpontot. Ez a parancs egy paramétert vesz igénybe.

Paraméter Elfogadott értékek Megjegyzések
vendpointName A virtuális végpont neve Az EFLOW virtuális géphez hozzárendelt virtuális végpont neve.

További információkért használja a parancsot Get-Help Remove-EflowVmEndpoint -full.

Remove-EflowVmSharedFolder

A Remove-EflowVmSharedFolder parancs leállítja a Windows gazdagép operációs rendszer mappájának megosztását az EFLOW virtuális gépen. Ez a parancs két paramétert használ.

Paraméter Elfogadott értékek Megjegyzések
sharedfolderRoot Sztring A Windows gazdagép operációs rendszer megosztott gyökérmappájának elérési útja.
hostFolderPath Sztring vagy lista A Windows gazdagép operációs rendszer megosztott mappájának/mappáinak relatív elérési útjai (a gyökérmappához).

További információkért használja a parancsot Get-Help Remove-EflowVmSharedFolder -full.

Set-EflowVM

A Set-EflowVM parancs frissíti a virtuális gép konfigurációját a kért tulajdonságokkal. Az opcionális paraméterekkel definiálhat egy adott konfigurációt a virtuális géphez.

Paraméter Elfogadott értékek Megjegyzések
cpuCount 1 és az eszköz processzormagjai közötti egész szám A virtuális gép processzormagjainak száma.
memoryInMB 1024 és az eszköz szabad memóriájának maximális mennyisége közötti egész szám A virtuális gép számára lefoglalt memória.
gpuName GPU-eszköz neve Az átengedéshez használandó GPU-eszköz neve.
gpuPassthroughType DirectDeviceAssignment, ParaVirtualization vagy none (nincs átengedés) GPU-átengedés típusa
gpuCount 1 és az eszköz GPU-magjai közötti egész szám A virtuális gép GPU-eszközeinek száma megjegyzés: Csak a DirectDeviceAssignment használatakor érvényes
fejetlen Egyik sem Ha ez a jelző jelen van, meghatározza, hogy a felhasználónak meg kell-e erősítenie, ha biztonsági figyelmeztetést adnak ki.

További információkért használja a parancsot Get-Help Set-EflowVM -full.

Set-EflowVmDNSServers

A Set-EflowVmDNSServers parancs konfigurálja az EFLOW virtuális gép DNS-kiszolgálóit.

Paraméter Elfogadott értékek Megjegyzések
vendpointName A virtuális végpont nevének sztringértéke A Get-EflowVmEndpoint használatával szerezze be az EFLOW virtuális géphez rendelt virtuális adaptereket. Pl. DESKTOP-CONTOSO-EflowInterface
dnsServers A névfeloldáshoz használandó DNS-kiszolgáló IPAddress listája Pl. @("10.0.10.1")

További információkért használja a parancsot Get-Help Set-EflowVmDNSServers -full.

Set-EflowVmFeature

A Set-EflowVmFeature parancs engedélyezi vagy letiltja a Linuxhoz készült IoT Edge állapotát Windows-funkciókon.

Paraméter Elfogadott értékek Megjegyzések
funkció DpsTpm, Defender A funkció neve váltógomb.
engedélyez Egyik sem Ha ez a jelző jelen van, a parancs engedélyezi a funkciót.

További információkért használja a parancsot Get-Help Set-EflowVmFeature -full.

Set-EflowVmTelemetryOption

A Set-EflowVmTelemetryOption parancs engedélyezi vagy letiltja az opcionális telemetriát a virtuális gépen belül.

Paraméter Elfogadott értékek Megjegyzések
optionalTelemetry Igaz vagy hamis A választható telemetria kiválasztása.

További információkért használja a parancsot Get-Help Set-EflowVmTelemetryOption -full.

Start-EflowVm

A Start-EflowVm parancs elindítja a virtuális gépet. Ha a virtuális gép már elindult, a rendszer nem hajt végre műveletet.

További információkért használja a parancsot Get-Help Start-EflowVm -full.

Stop-EflowVm

A Stop-EflowVm parancs leállítja a virtuális gépet. Ha a virtuális gép már le van állítva, a rendszer nem hajt végre műveletet.

További információkért használja a parancsot Get-Help Stop-EflowVm -full.

Verify-EflowVm

A Verify-EflowVm parancs egy közzétett függvény, amely ellenőrzi, hogy létrejött-e a Linuxhoz készült IoT Edge Windows rendszerű virtuális gépen. Csak a gyakori paramétereket veszi igénybe, és igaz értéket ad vissza, ha a virtuális gép létrejött, és hamis, ha nem.

További információkért használja a parancsot Get-Help Verify-EflowVm -full.

Következő lépések

Az alábbi cikkben megtudhatja, hogyan telepítheti és építheti ki a Linuxhoz készült IoT Edge-et Windows rendszeren az alábbi parancsokkal: