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

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

Fontos

Az IoT Edge 1.5 LTS és az IoT Edge 1.4 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 WindowsPowerShellC:\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 lesz-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 lesz.
[
   {
      "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.

Csatlakozás-EflowVm

Az Csatlakozás-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. Windows Rendszergazda Center vagy PowerShell I használata esetén nem működik Standard kiadás.

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 Manuális Csatlakozás ionString, 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 (Manuális Csatlakozás ionString).
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élyezi 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: