Dela via

PowerShell-skript för IoT Edge med Windows-containrar

gäller för:ja-ikonen IoT Edge 1.1

Viktigt!

IoT Edge 1.1 supportdatumet upphör var den 13 december 2022. I informationen om Microsoft-produktens livscykel hittar du fler uppgifter om vilken support som gäller för denna produkt, tjänst, teknik eller detta API. Mer information om hur du uppdaterar till den senaste versionen av IoT Edge finns i Uppdatera IoT Edge-.

Förstå PowerShell-skript som installerar, uppdaterar eller avinstallerar IoT Edge på Windows-enheter.

Kommandona som beskrivs i den här artikeln kommer från den IoTEdgeSecurityDaemon.ps1 fil som släpps med varje IoT Edge-version. Den senaste versionen av skriptet är alltid tillgänglig på aka.ms/iotedge-win.

Du kan köra något av kommandona med hjälp av cmdleten Invoke-WebRequest för att få åtkomst till den senaste skriptversionen. Till exempel:

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

Du kan också ladda ned det här skriptet, eller en version av skriptet från en specifik version, för att köra kommandona. Till exempel:

. <path>\IoTEdgeSecurityDaemon.ps1
Deploy-IoTEdge

Det angivna skriptet är signerat för att öka säkerheten. Du kan verifiera signaturen genom att ladda ned skriptet till enheten och sedan köra följande PowerShell-kommando:

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

Utdatastatusen är Giltig om signaturen har verifierats.

Deploy-IoTEdge

Kommandot Deploy-IoTEdge laddar ned och distribuerar IoT Edge Security Daemon och dess beroenden. Distributionskommandot accepterar bland annat dessa vanliga parametrar. I den fullständiga listan använder du kommandot Get-Help Deploy-IoTEdge -full.

Parameter Godkända värden Kommentarer
ContainerOs Windows eller Linux Om inget containeroperativsystem har angetts är Windows standardvärdet.

För Windows-containrar använder IoT Edge moby-containermotorn som ingår i installationen. För Linux-containrar måste du installera en containermotor innan du startar installationen.
Proxyserver Proxy-URL Inkludera den här parametern om enheten behöver gå via en proxyserver för att nå Internet. Mer information finns i Konfigurera en IoT Edge-enhet för kommunikation via en proxyserver.
OfflineInstallationPath Katalogsökväg Om den här parametern ingår kontrollerar installationsprogrammet katalogen för IoT Edge-cab- och VC Runtime MSI-filer som krävs för installationen. Alla filer som inte hittades i katalogen laddas ned. Om båda filerna finns i katalogen kan du installera IoT Edge utan internetanslutning. Du kan också använda den här parametern för att använda en specifik version.
InvokeWebRequestParameters Hashtable med parametrar och värden Under installationen görs flera webbbegäranden. Använd det här fältet för att ange parametrar för dessa webbbegäranden. Den här parametern är användbar för att konfigurera autentiseringsuppgifter för proxyservrar. Mer information finns i Konfigurera en IoT Edge-enhet för kommunikation via en proxyserver.
RestartIfNeeded inget Med den här flaggan kan distributionsskriptet starta om datorn utan att fråga om det behövs.

Initialize-IoTEdge

Kommandot Initialize-IoTEdge konfigurerar IoT Edge med enhetens anslutningssträng och driftinformation. Mycket av den information som genereras av det här kommandot lagras sedan i filen iotedge\config.yaml. Initieringskommandot accepterar bland annat dessa vanliga parametrar. I den fullständiga listan använder du kommandot Get-Help Initialize-IoTEdge -full.

Parameter Godkända värden Kommentarer
ManualConnectionString Ingen Switch-parametern. Standardvärde. Om ingen etableringstyp har angetts är manuell etablering med en anslutningssträng standardvärdet.

Deklarerar att du ska ange en enhetsanslutningssträng för att etablera enheten manuellt.
ManualX509 Ingen Switch-parametern. Om ingen etableringstyp har angetts är manuell etablering med en anslutningssträng standardvärdet.

Deklarerar att du ska ange ett identitetscertifikat och en privat nyckel för att etablera enheten manuellt.
DpsTpm Ingen Switch-parametern. Om ingen etableringstyp har angetts är manuell etablering med en anslutningssträng standardvärdet.

Deklarerar att du anger ett DPS-omfångs-ID (Device Provisioning Service) och enhetens registrerings-ID som ska etableras via DPS.
DpsSymmetricKey Ingen Switch-parametern. Om ingen etableringstyp har angetts är manuell etablering med en anslutningssträng standardvärdet.

Deklarerar att du ska ange ett DPS-omfångs-ID (Device Provisioning Service) och enhetens registrerings-ID som ska etableras via DPS, tillsammans med en symmetrisk nyckel för attestering.
DpsX509 Ingen Switch-parametern. Om ingen etableringstyp har angetts är manuell etablering med en anslutningssträng standardvärdet.

Deklarerar att du ska ange ett DPS-omfångs-ID (Device Provisioning Service) och enhetens registrerings-ID som ska etableras via DPS, tillsammans med ett X.509-identitetscertifikat och en privat nyckel för attestering.
DeviceConnectionString En anslutningssträng från en IoT Edge-enhet som registrerats i en IoT Hub med enkla citattecken Krävs för manuell etablering med en anslutningssträng. Om du inte anger någon anslutningssträng i skriptparametrarna uppmanas du att ange en.
IotHubHostName Värdnamnet för den IoT-hubb som en enhet ansluter till. Krävs för manuell etablering med X.509-certifikat. Tar formatet {hubbnamn}.azure-devices.net.
DeviceId Enhets-ID:t från en registrerad enhetsidentitet i IoT Hub. Krävs för manuell etablering med X.509-certifikat.
ScopeId Ett omfångs-ID från en instans av Device Provisioning Service som är associerad med din IoT Hub. Krävs för DPS-etablering. Om du inte anger något omfångs-ID i skriptparametrarna uppmanas du att ange ett.
RegistrationId Ett registrerings-ID som genereras av enheten Obligatorisk för DPS-etablering om du använder TPM eller symmetrisk nyckelattestering. Valfri om du använder X.509-certifikatattestering.
X509IdentityCertificate URI-sökvägen till X.509-enhetsidentitetscertifikatet på enheten. Krävs för antingen manuell etablering eller DPS-etablering om du använder X.509-certifikatattestering.
X509IdentityPrivateKey URI-sökvägen till X.509-enhetens identitetscertifikatnyckel på enheten. Krävs för antingen manuell etablering eller DPS-etablering om du använder X.509-certifikatattestering.
SymmetricKey Den symmetriska nyckel som används för att etablera IoT Edge-enhetsidentiteten när du använder DPS Krävs för DPS-etablering om du använder symmetrisk nyckelattestering.
ContainerOs Windows eller Linux Om inget containeroperativsystem har angetts är Windows standardvärdet.

För Windows-containrar använder IoT Edge moby-containermotorn som ingår i installationen. För Linux-containrar måste du installera en containermotor innan du startar installationen.
DeviceCACertificate URI-sökvägen till X.509-enhetens CA-certifikat på enheten. Kan också konfigureras i filen C:\ProgramData\iotedge\config.yaml. Mer information finns i Hantera certifikat på en IoT Edge-enhet.
DeviceCAPrivateKey URI-sökvägen till den privata nyckeln för X.509-enhets-CA:n på enheten. Kan också konfigureras i filen C:\ProgramData\iotedge\config.yaml. Mer information finns i Hantera certifikat på en IoT Edge-enhet.
InvokeWebRequestParameters Hashtable med parametrar och värden Under installationen görs flera webbbegäranden. Använd det här fältet för att ange parametrar för dessa webbbegäranden. Den här parametern är användbar för att konfigurera autentiseringsuppgifter för proxyservrar. Mer information finns i Konfigurera en IoT Edge-enhet för kommunikation via en proxyserver.
AgentImage URI för IoT Edge-agentbild Som standard använder en ny IoT Edge-installation den senaste rullande taggen för IoT Edge-agentens avbildning. Använd den här parametern för att ange en specifik tagg för avbildningsversionen eller för att ange en egen agentbild. Mer information finns i Förstå IoT Edge-taggar.
användarnamn Användarnamn för containerregister Använd endast den här parametern om du anger parametern -AgentImage till en container i ett privat register. Ange ett användarnamn med åtkomst till registret.
Lösenord Skydda lösenordssträng Använd endast den här parametern om du anger parametern -AgentImage till en container i ett privat register. Ange lösenordet för att komma åt registret.

Update-IoTEdge

Parameter Godkända värden Kommentarer
ContainerOs Windows eller Linux Om inget containeroperativsystem har angetts är Windows standardvärdet. För Windows-containrar ingår en containermotor i installationen. För Linux-containrar måste du installera en containermotor innan du startar installationen.
Proxyserver Proxy-URL Inkludera den här parametern om enheten behöver gå via en proxyserver för att nå Internet. Mer information finns i Konfigurera en IoT Edge-enhet för kommunikation via en proxyserver.
InvokeWebRequestParameters Hashtable med parametrar och värden Under installationen görs flera webbbegäranden. Använd det här fältet för att ange parametrar för dessa webbbegäranden. Den här parametern är användbar för att konfigurera autentiseringsuppgifter för proxyservrar. Mer information finns i Konfigurera en IoT Edge-enhet för kommunikation via en proxyserver.
OfflineInstallationPath Katalogsökväg Om den här parametern ingår kontrollerar installationsprogrammet katalogen för IoT Edge-cab- och VC Runtime MSI-filer som krävs för installationen. Alla filer som inte hittades i katalogen laddas ned. Om båda filerna finns i katalogen kan du installera IoT Edge utan internetanslutning. Du kan också använda den här parametern för att använda en specifik version.
RestartIfNeeded inget Med den här flaggan kan distributionsskriptet starta om datorn utan att fråga om det behövs.

Uninstall-IoTEdge

Parameter Godkända värden Kommentarer
Framtvinga inget Den här flaggan tvingar avinstallationen om det tidigare avinstallationsförsöket misslyckades.
RestartIfNeeded inget Med den här flaggan kan avinstallationsskriptet starta om datorn utan att fråga om det behövs.

Nästa steg

Lär dig hur du använder dessa kommandon i följande artikel: