PowerShell-skript för IoT Edge med Windows-containrar
Gäller för: 
IoT Edge 1.1
Viktigt!
IoT Edge 1.1 slutdatum för support 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 IoTEdgeSecurityDaemon.ps1 här artikeln kommer från filen 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.
Distribuera 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. |
| Proxy | 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. |
Initiera IoTEdge
Kommandot Initialize-IoTEdge konfigurerar IoT Edge med enhetens niska veze 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 | Växla parameter. Standardvärde. Om ingen etableringstyp har angetts är manuell etablering med en niska veze standardvärdet. Deklarerar att du anger en enhet niska veze för att etablera enheten manuellt. |
| ManualX509 | Ingen | Växla parameter. Om ingen etableringstyp har angetts är manuell etablering med en niska veze standardvärdet. Deklarerar att du ska ange ett identitetscertifikat och en privat nyckel för att etablera enheten manuellt. |
| DpsTpm | Ingen | Växla parameter. Om ingen etableringstyp har angetts är manuell etablering med en niska veze 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 | Växla parameter. Om ingen etableringstyp har angetts är manuell etablering med en niska veze 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 | Växla parameter. Om ingen etableringstyp har angetts är manuell etablering med en niska veze 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 niska veze från en IoT Edge-enhet som registrerats i en IoT Hub med enkla citattecken | Krävs för manuell etablering med en niska veze. Om du inte anger en niska veze 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 {hub name}.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 | Krävs för DPS-etablering om du använder TPM eller symmetrisk nyckelattestering. Valfritt 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 C:\ProgramData\iotedge\config.yaml filen. 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 C:\ProgramData\iotedge\config.yaml filen. 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. |
Uppdatera 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. |
| Proxy | 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. |
Avinstallera IoTEdge
| Parameter | Godkända värden | Kommentarer |
|---|---|---|
| Kraft | 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: