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

PowerShell-szkriptek az IoT Edge-hez Windows-tárolókkal

A következőkre vonatkozik:igen ikon IoT Edge 1.1

Fontos

Az IoT Edge 1.1 támogatási dátumának vége 2022. december 13.,. A termék, szolgáltatás, technológia vagy API támogatásáról a Microsoft-termékek életciklusa című leírásból tájékozódhat. További információ az IoT Edge legújabb verziójára való frissítésről: IoT Edge frissítése.

Megismerheti az IoT Edge-et Windows-eszközökön telepítő, frissítő vagy eltávolító PowerShell-szkripteket.

A cikkben ismertetett parancsok a IoTEdgeSecurityDaemon.ps1 fájlból származnak, amely minden IoT Edge kiadási. A szkript legújabb verziója mindig elérhető aka.ms/iotedge-win.

A parancsok bármelyikét futtathatja a Invoke-WebRequest parancsmaggal a legújabb szkriptverzió eléréséhez. Például:

. {Invoke-WebRequest -useb https://aka.ms/iotedge-win} | Invoke-Expression; `
Deploy-IoTEdge

A parancsok futtatásához letöltheti ezt a szkriptet vagy a szkript egy adott kiadásból származó verzióját is. Például:

. <path>\IoTEdgeSecurityDaemon.ps1
Deploy-IoTEdge

A megadott szkript a biztonság növelése érdekében van aláírva. Az aláírás ellenőrzéséhez töltse le a szkriptet az eszközére, majd futtassa a következő PowerShell-parancsot:

Get-AuthenticodeSignature "C:\<path>\IotEdgeSecurityDaemon.ps1"

A kimeneti állapot Érvényes az aláírás ellenőrzése esetén.

Deploy-IoTEdge

A Deploy-IoTEdge parancs letölti és telepíti az IoT Edge biztonsági démont és annak függőségeit. Az üzembe helyezési parancs többek között elfogadja ezeket a gyakori paramétereket. A teljes lista esetében használja a Get-Help Deploy-IoTEdge -fullparancsot.

Paraméter Elfogadott értékek Megjegyzések
ContainerOs Windows vagy Linux Ha nincs megadva tároló operációs rendszer, akkor a Windows az alapértelmezett érték.

Windows-tárolók esetén az IoT Edge a telepítésben szereplő Moby tárolómotort használja. Linux-tárolók esetén a telepítés megkezdése előtt telepítenie kell egy tárolómotort.
Helyettes Proxy URL-címe Adja meg ezt a paramétert, ha az eszköznek proxykiszolgálón kell áthaladnia az internet eléréséhez. További információ: IoT Edge-eszköz konfigurálása proxykiszolgálón keresztüli kommunikációhoz.
OfflineInstallationPath Címtár útvonala Ha ez a paraméter szerepel a listán, a telepítő ellenőrzi a telepítéshez szükséges IoT Edge-fülke és VC futtatókörnyezeti MSI-fájlok listázott könyvtárát. A címtárban nem található fájlok letöltve lesznek. Ha mindkét fájl szerepel a könyvtárban, internetkapcsolat nélkül is telepítheti az IoT Edge-et. Ezt a paramétert egy adott verzió használatára is használhatja.
InvokeWebRequestParameters Paraméterek és értékek kivonata A telepítés során több webes kérés is történik. Ezen a mezőn állíthatja be a webkérelmek paramétereit. Ez a paraméter a proxykiszolgálók hitelesítő adatainak konfigurálásához hasznos. További információ: IoT Edge-eszköz konfigurálása proxykiszolgálón keresztüli kommunikációhoz.
RestartIfNeeded Nincs Ez a jelző lehetővé teszi, hogy az üzembehelyezési szkript szükség esetén kérés nélkül újraindítsa a gépet.

Initialize-IoTEdge

A Initialize-IoTEdge parancs konfigurálja az IoT Edge-et az eszköz kapcsolati sztringjével és működési részleteivel. A parancs által létrehozott információk nagy része ezután az iotedge\config.yaml fájlban lesz tárolva. Az inicializálási parancs többek között elfogadja ezeket a gyakori paramétereket. A teljes lista esetében használja a Get-Help Initialize-IoTEdge -fullparancsot.

Paraméter Elfogadott értékek Megjegyzések
ManualConnectionString Egyik sem Kapcsoló paraméter. Alapértelmezett érték. Ha nincs megadva kiépítési típus, akkor a kapcsolati sztringgel történő manuális kiépítés az alapértelmezett érték.

Deklarálja, hogy egy eszközkapcsolati sztringet fog megadni az eszköz manuális kiépítéséhez.
ManualX509 Egyik sem Kapcsoló paraméter. Ha nincs megadva kiépítési típus, akkor a kapcsolati sztringgel történő manuális kiépítés az alapértelmezett érték.

Deklarálja, hogy egy identitástanúsítványt és egy titkos kulcsot fog megadni az eszköz manuális kiépítéséhez.
DpsTpm Egyik sem Kapcsoló paraméter. Ha nincs megadva kiépítési típus, akkor a kapcsolati sztringgel történő manuális kiépítés az alapértelmezett érték.

Deklarálja, hogy megadja a Device Provisioning Service (DPS) hatókör-azonosítóját és az eszköz regisztrációs azonosítóját a DPS-n keresztül történő üzembe helyezéshez.
DpsSymmetricKey Egyik sem Kapcsoló paraméter. Ha nincs megadva kiépítési típus, akkor a kapcsolati sztringgel történő manuális kiépítés az alapértelmezett érték.

Deklarálja, hogy meg fogja adni a Device Provisioning Service (DPS) hatókör-azonosítóját és az eszköz regisztrációs azonosítóját a DPS-en keresztül történő üzembe helyezéshez, valamint egy szimmetrikus kulcsot az igazoláshoz.
DpsX509 Egyik sem Kapcsoló paraméter. Ha nincs megadva kiépítési típus, akkor a kapcsolati sztringgel történő manuális kiépítés az alapértelmezett érték.

Deklarálja, hogy megadja az eszközkiépítési szolgáltatás (DPS) hatókör-azonosítóját és az eszköz regisztrációs azonosítóját a DPS-en keresztüli kiépítéshez, valamint egy X.509-identitástanúsítványt és egy titkos kulcsot az igazoláshoz.
DeviceConnectionString IoT Hubon regisztrált IoT Edge-eszköz kapcsolati sztringje egyetlen idézőjelben Kapcsolati sztringgel történő manuális kiépítéshez szükséges. Ha nem ad meg kapcsolati sztringet a szkript paramétereiben, a rendszer kérni fogja az egyiket.
IotHubHostName Annak az IoT Hubnak a gazdagépneve, amelyhez az eszköz csatlakozik. X.509-tanúsítványokkal történő manuális üzembe helyezéshez szükséges. A(z) {hub name}.azure-devices.net formátumot használja.
DeviceId Az IoT Hub regisztrált eszközidentitásából származó eszközazonosító. X.509-tanúsítványokkal történő manuális üzembe helyezéshez szükséges.
ScopeId Az IoT Hubhoz társított Device Provisioning Service-példány hatókör-azonosítója. DPS kiépítéséhez szükséges. Ha nem ad meg hatókör-azonosítót a szkriptparaméterekben, a rendszer kérni fogja az egyiket.
RegistrationId Az eszköz által létrehozott regisztrációs azonosító A DPS kiépítéséhez szükséges TPM vagy szimmetrikus kulcsigazolás használata esetén. X.509-tanúsítványigazolás használata esetén nem kötelező.
X509IdentityCertificate Az X.509-eszköz identitástanúsítványának URI-elérési útja az eszközön. Kötelező manuális vagy DPS-kiépítéshez X.509-tanúsítványigazolás használata esetén.
X509IdentityPrivateKey Az X.509-eszköz identitástanúsítványkulcsának URI-elérési útja az eszközön. Kötelező manuális vagy DPS-kiépítéshez X.509-tanúsítványigazolás használata esetén.
SymmetricKey Az IoT Edge-eszközidentitás DPS használatakor történő kiépítéséhez használt szimmetrikus kulcs A DPS kiépítéséhez szükséges, ha szimmetrikus kulcsigazolást használ.
ContainerOs Windows vagy Linux Ha nincs megadva tároló operációs rendszer, akkor a Windows az alapértelmezett érték.

Windows-tárolók esetén az IoT Edge a telepítésben szereplő Moby tárolómotort használja. Linux-tárolók esetén a telepítés megkezdése előtt telepítenie kell egy tárolómotort.
DeviceCACertificate Az X.509-es eszköz hitelesítésszolgáltatói tanúsítványának URI-elérési útja az eszközön. A C:\ProgramData\iotedge\config.yaml fájlban is konfigurálható. További információ: Tanúsítványok kezelése IoT Edge-eszközön.
DeviceCAPrivateKey Az X.509-es eszköz ca titkos kulcsának URI-elérési útja az eszközön. A C:\ProgramData\iotedge\config.yaml fájlban is konfigurálható. További információ: Tanúsítványok kezelése IoT Edge-eszközön.
InvokeWebRequestParameters Paraméterek és értékek kivonata A telepítés során több webes kérés is történik. Ezen a mezőn állíthatja be a webkérelmek paramétereit. Ez a paraméter a proxykiszolgálók hitelesítő adatainak konfigurálásához hasznos. További információ: IoT Edge-eszköz konfigurálása proxykiszolgálón keresztüli kommunikációhoz.
AgentImage IoT Edge-ügynök képének URI-ja Alapértelmezés szerint egy új IoT Edge-telepítés az IoT Edge-ügynök lemezképének legújabb gördülő címkéjét használja. Ezzel a paraméterrel beállíthat egy adott címkét a képverzióhoz, vagy saját ügynökképet adhat meg. További információ: Az IoT Edge-címkék ismertetése.
felhasználónév Tárolóregisztrációs adatbázis felhasználóneve Ezt a paramétert csak akkor használja, ha a -AgentImage paramétert egy privát beállításjegyzékben lévő tárolóra állítja be. Adjon meg egy felhasználónevet a beállításjegyzékhez való hozzáféréssel.
Jelszó Biztonságos jelszósztring Ezt a paramétert csak akkor használja, ha a -AgentImage paramétert egy privát beállításjegyzékben lévő tárolóra állítja be. Adja meg a beállításjegyzék eléréséhez szükséges jelszót.

Update-IoTEdge

Paraméter Elfogadott értékek Megjegyzések
ContainerOs Windows vagy Linux Ha nincs megadva tároló operációs rendszer, akkor a Windows az alapértelmezett érték. Windows-tárolók esetén a telepítés egy tárolómotort fog tartalmazni. Linux-tárolók esetén a telepítés megkezdése előtt telepítenie kell egy tárolómotort.
Helyettes Proxy URL-címe Adja meg ezt a paramétert, ha az eszköznek proxykiszolgálón kell áthaladnia az internet eléréséhez. További információ: IoT Edge-eszköz konfigurálása proxykiszolgálón keresztüli kommunikációhoz.
InvokeWebRequestParameters Paraméterek és értékek kivonata A telepítés során több webes kérés is történik. Ezen a mezőn állíthatja be a webkérelmek paramétereit. Ez a paraméter a proxykiszolgálók hitelesítő adatainak konfigurálásához hasznos. További információ: IoT Edge-eszköz konfigurálása proxykiszolgálón keresztüli kommunikációhoz.
OfflineInstallationPath Címtár útvonala Ha ez a paraméter szerepel a listán, a telepítő ellenőrzi a telepítéshez szükséges IoT Edge-fülke és VC futtatókörnyezeti MSI-fájlok listázott könyvtárát. A címtárban nem található fájlok letöltve lesznek. Ha mindkét fájl szerepel a könyvtárban, internetkapcsolat nélkül is telepítheti az IoT Edge-et. Ezt a paramétert egy adott verzió használatára is használhatja.
RestartIfNeeded Nincs Ez a jelző lehetővé teszi, hogy az üzembehelyezési szkript szükség esetén kérés nélkül újraindítsa a gépet.

Uninstall-IoTEdge

Paraméter Elfogadott értékek Megjegyzések
Kényszerítse Nincs Ez a jelző arra az esetre kényszeríti az eltávolítást, ha az előző eltávolítási kísérlet sikertelen volt.
RestartIfNeeded Nincs Ez a jelző lehetővé teszi, hogy az eltávolítási szkript szükség esetén kérés nélkül újraindítsa a gépet.

Következő lépések

Ebből a cikkből megtudhatja, hogyan használhatja ezeket a parancsokat:

  • Last updated on