Instalace modulu runtime Azure IoT Edge ve WindowsInstall the Azure IoT Edge runtime on Windows

Modul runtime Azure IoT Edge je co se změní na zařízení do zařízení IoT Edge.The Azure IoT Edge runtime is what turns a device into an IoT Edge device. Modul runtime můžete nasadit na zařízení jako Raspberry Pi malé nebo velké průmyslové serveru.The runtime can be deployed on devices as small as a Raspberry Pi or as large as an industrial server. Jakmile je zařízení nakonfigurovaná s modulem runtime IoT Edge, můžete začít nasazovat obchodní logiky k němu z cloudu.Once a device is configured with the IoT Edge runtime, you can start deploying business logic to it from the cloud.

Další informace o modulu runtime IoT Edge najdete v tématu pochopení Azure IoT Edge runtime a jeho architektury.To learn more about the IoT Edge runtime, see Understand the Azure IoT Edge runtime and its architecture.

V tomto článku jsou uvedené kroky pro instalaci modulu runtime Azure IoT Edge v systému Windows x64 (AMD/Intel) pomocí kontejnerů Windows.This article lists the steps to install the Azure IoT Edge runtime on your Windows x64 (AMD/Intel) system using Windows containers.

Poznámka

Známý problém s operačním systémem Windows brání přechodu do režimu spánku a hibernace, když IoT Edge moduly (kontejnery Windows nano serveru izolované na procesu).A known Windows operating system issue prevents transition to sleep and hibernate power states when IoT Edge modules (process-isolated Windows Nano Server containers) are running. Tento problém má vliv na výdrž baterie zařízení.This issue impacts battery life on the device.

Alternativním řešením je pomocí příkazu Stop-Service iotedge zastavit všechny spuštěné IoT Edge moduly před použitím těchto stavů napájení.As a workaround, use the command Stop-Service iotedge to stop any running IoT Edge modules before using these power states.

Použití kontejnerů Linux v systémech Windows není doporučená nebo podporovaná konfigurace produkčního prostředí pro Azure IoT Edge.Using Linux containers on Windows systems is not a recommended or supported production configuration for Azure IoT Edge. To však lze použít pro účely vývoje a testování.However, it can be used for development and testing purposes. Další informace najdete v tématu použití IoT Edge ve Windows ke spouštění kontejnerů Linux.To learn more, see Use IoT Edge on Windows to run Linux containers.

Informace o tom, co je zahrnuto v nejnovější verzi IoT Edge, najdete v tématu Azure IoT Edge releases.For information about what's included in the latest version of IoT Edge, see Azure IoT Edge releases.

PožadavkyPrerequisites

Pomocí této části můžete zkontrolovat, jestli zařízení s Windows podporuje IoT Edge, a připravit ho pro modul kontejneru před instalací.Use this section to review whether your Windows device can support IoT Edge, and to prepare it for a container engine before installation.

Podporované verze WindowsSupported Windows versions

Pro vývojové a testovací scénáře lze Azure IoT Edge s kontejnery Windows nainstalovat do jakékoli verze systému Windows 10 nebo Windows Server 2019 (Build 17763), který podporuje funkci Containers.For development and test scenarios, Azure IoT Edge with Windows containers can be installed on any version of Windows 10 or Windows Server 2019 (build 17763) that supports the containers feature. Informace o tom, které operační systémy se aktuálně podporují pro produkční scénáře, najdete v tématu Azure IoT Edge podporovaných systémech.For information about which operating systems are currently supported for production scenarios, see Azure IoT Edge supported systems.

Zařízení se systémem IoT Core musí mít volitelnou funkci kontejnerů IoT Core-Windows, která podporuje modul runtime IoT Edge.IoT Core devices must include the IoT Core- Windows Containers optional feature to support the IoT Edge runtime. Pomocí následujícího příkazu ve vzdálené relaci PowerShellu ověřte, že jsou kontejnery Windows na vašem zařízení podporované:Use the following command in a remote PowerShell session to check that Windows containers are supported on your device:

Get-Service vmcompute

Pokud je služba k dispozici, měli byste získat úspěšnou odpověď se stavem služby uvedeným jako spuštěno.If the service is present, you should get a successful response with the service status listed as running. Pokud se nenalezne služba vmcompute, vaše zařízení nesplňuje požadavky na IoT Edge.If the vmcompute service is not found, then your device does not meet the requirements for IoT Edge. Zeptejte se svého poskytovatele hardwaru o podpoře této funkce.Contact your hardware provider to ask about support for this feature.

Příprava na modul kontejneruPrepare for a container engine

Azure IoT Edge spoléhá na modul kontejneru, který je kompatibilní s OCI .Azure IoT Edge relies on a OCI-compatible container engine. V produkčních scénářích použijte modul Moby, který je součástí instalačního skriptu, ke spuštění kontejnerů Windows na zařízení s Windows.For production scenarios, use the Moby engine included in the installation script to run Windows containers on your Windows device.

Instalace IoT Edge na nové zařízeníInstall IoT Edge on a new device

Poznámka

Azure IoT Edge softwarové balíčky jsou souladu s licenčními podmínkami umístěný v balíčcích (v adresáři licencí).Azure IoT Edge software packages are subject to the license terms located in the packages (in the LICENSE directory). Přečtěte si licenční podmínky před použitím balíčku.Please read the license terms prior to using the package. Instalace a použití balíčku se považuje za svůj souhlas s těmito podmínkami.Your installation and use of the package constitutes your acceptance of these terms. Pokud s licenčními podmínkami nesouhlasíte, nepoužívejte balíček.If you do not agree with the license terms, do not use the package.

PowerShellový skript stáhne a nainstaluje démona zabezpečení Azure IoT Edge.A PowerShell script downloads and installs the Azure IoT Edge security daemon. Démon zabezpečení potom spustí první ze dvou běhových modulů a Agent IoT Edge, který umožňuje vzdálené nasazení jiných modulů.The security daemon then starts the first of two runtime modules, the IoT Edge agent, which enables remote deployments of other modules.

Tip

Pro zařízení IoT Core doporučujeme spouštět instalační příkazy pomocí relace RemotePowerShell.For IoT Core devices, we recommend running the installation commands using a RemotePowerShell session. Další informace najdete v tématu použití PowerShellu pro Windows IoT.For more information, see Using PowerShell for Windows IoT.

Když na zařízení poprvé nainstalujete IoT Edge runtime, bude potřeba zřídit zařízení s identitou ze služby IoT Hub.When you install the IoT Edge runtime for the first time on a device, you need to provision the device with an identity from an IoT hub. Jedno zařízení IoT Edge lze zřídit ručně pomocí připojovacího řetězce zařízení, který poskytuje IoT Hub.A single IoT Edge device can be provisioned manually using a device connection string provided by IoT Hub. Nebo můžete použít službu Device Provisioning (DPS) k automatickému zřízení zařízení, což je užitečné v případě, že máte spoustu zařízení nastavených.Or, you can use the Device Provisioning Service (DPS) to automatically provision devices, which is helpful when you have many devices to set up. Podle svého výběru: zřizování zvolte příslušný instalační skript.Depending on your provisioning choice, choose the appropriate installation script.

Následující části popisují běžné případy použití a parametry IoT Edge instalačního skriptu na novém zařízení.The following sections describe the common use cases and parameters for the IoT Edge installation script on a new device.

Možnost 1: Instalace a zajištění ručněOption 1: Install and manually provision

V této první možnosti zadáte připojovací řetězec zařízení generovaný IoT Hub pro zřízení zařízení.In this first option, you provide a device connection string generated by IoT Hub to provision the device.

Tento příklad ukazuje ruční instalaci pomocí kontejnerů Windows:This example demonstrates a manual installation with Windows containers:

  1. Pokud jste to ještě neudělali, zaregistrujte nové zařízení IoT Edge a načtěte připojovací řetězec zařízení.If you haven't already, register a new IoT Edge device and retrieve the device connection string. Zkopírujte připojovací řetězec pro pozdější použití v této části.Copy the connection string to use later in this section. Tento krok můžete provést pomocí následujících nástrojů:You can complete this step using the following tools:

  2. Spusťte PowerShell jako správce.Run PowerShell as an administrator.

    Poznámka

    K instalaci IoT Edge, nikoli PowerShell (x86) použijte relaci AMD64 prostředí PowerShell.Use an AMD64 session of PowerShell to install IoT Edge, not PowerShell (x86). Pokud si nejste jistí, který typ relace používáte, spusťte následující příkaz:If you're not sure which session type you're using, run the following command:

    (Get-Process -Id $PID).StartInfo.EnvironmentVariables["PROCESSOR_ARCHITECTURE"]
    
  3. Příkaz Deploy-IoTEdge zkontroluje, jestli má počítač s Windows podporovanou verzi, zapne funkci Containers a pak stáhne modul runtime Moby a modul runtime IoT Edge.The Deploy-IoTEdge command checks that your Windows machine is on a supported version, turns on the containers feature, and then downloads the moby runtime and the IoT Edge runtime. Příkaz ve výchozím nastavení používá kontejnery Windows.The command defaults to using Windows containers.

    . {Invoke-WebRequest -useb https://aka.ms/iotedge-win} | Invoke-Expression; `
    Deploy-IoTEdge
    
  4. V tuto chvíli se zařízení IoT Core můžou restartovat automaticky.At this point, IoT Core devices may restart automatically. Jiná zařízení s Windows 10 nebo Windows Server vás můžou vyzvat k restartování.Other Windows 10 or Windows Server devices may prompt you to restart. Pokud ano, restartujte zařízení nyní.If so, restart your device now. Až bude zařízení připravené, spusťte PowerShell jako správce znovu.Once your device is ready, run PowerShell as an administrator again.

  5. Příkaz Initialize-IoTEdge nakonfiguruje IoT Edge modul runtime na vašem počítači.The Initialize-IoTEdge command configures the IoT Edge runtime on your machine. Příkaz je standardně nastaven na ruční zřizování pomocí kontejnerů Windows.The command defaults to manual provisioning with Windows containers.

    . {Invoke-WebRequest -useb https://aka.ms/iotedge-win} | Invoke-Expression; `
    Initialize-IoTEdge
    
  6. Po zobrazení výzvy zadejte připojovací řetězec zařízení, který jste získali v kroku 1.When prompted, provide the device connection string that you retrieved in step 1. Připojovací řetězec zařízení přidružuje fyzické zařízení k ID zařízení v IoT Hub.The device connection string associates the physical device with a device ID in IoT Hub.

    Připojovací řetězec zařízení má následující formát a nesmí obsahovat uvozovky: HostName={IoT hub name}.azure-devices.net;DeviceId={device name};SharedAccessKey={key}The device connection string takes the following format, and should not include quotation marks: HostName={IoT hub name}.azure-devices.net;DeviceId={device name};SharedAccessKey={key}

  7. Pomocí postupu v části ověření úspěšné instalace zkontrolujte stav IoT Edge na vašem zařízení.Use the steps in Verify successful installation to check the status of IoT Edge on your device.

Při ruční instalaci a zřízení zařízení můžete pomocí dalších parametrů upravit instalaci, včetně:When you install and provision a device manually, you can use additional parameters to modify the installation including:

  • Směrování provozu pomocí proxy serverDirect traffic to go through a proxy server
  • Nasměrování instalační služby na offline adresářPoint the installer to an offline directory
  • Deklarace konkrétní image kontejneru agenta a zadání přihlašovacích údajů, pokud je v privátním registruDeclare a specific agent container image, and provide credentials if it's in a private registry

Další informace o těchto možnostech instalace najdete v informacích o všech parametrech instalace.For more information about these installation options, skip ahead to learn about all installation parameters.

Možnost 2: Instalace a automaticky zřizovatOption 2: Install and automatically provision

V této druhé možnosti zřídíte zařízení pomocí IoT Hub Device Provisioning Service.In this second option, you provision the device using the IoT Hub Device Provisioning Service. Zadejte ID oboru z instance služby Device Provisioning spolu s dalšími informacemi, které jsou specifické pro váš preferovaný mechanismus ověřování:Provide the Scope ID from a Device Provisioning Service instance along with any other information specific to your preferred attestation mechanism:

Když instalujete a zřídíte zařízení automaticky, můžete pomocí dalších parametrů upravit instalaci, včetně:When you install and provision a device automatically, you can use additional parameters to modify the installation including:

  • Směrování provozu pomocí proxy serverDirect traffic to go through a proxy server
  • Nasměrování instalační služby na offline adresářPoint the installer to an offline directory
  • Deklarace konkrétní image kontejneru agenta a zadání přihlašovacích údajů, pokud je v privátním registruDeclare a specific agent container image, and provide credentials if it's in a private registry

Další informace o těchto možnostech instalace najdete v článku Přečtěte si tento článek nebo si přečtěte informace o všech parametrech instalace.For more information about these installation options, continue reading this article or skip to learn about All installation parameters.

Offline instalaceOffline installation

Během instalace se stáhnou dva soubory:During installation two files are downloaded:

  • Microsoft Azure IoT Edge soubor CAB obsahující rozhraní Moby (IoT Edge Security Daemon), modul Moby Container Engine a CLI.Microsoft Azure IoT Edge cab, which contains the IoT Edge security daemon (iotedged), Moby container engine, and Moby CLI.
  • Visual C++ Redistributable Package (VC Runtime) MSIVisual C++ redistributable package (VC runtime) msi

Jeden nebo oba tyto soubory si můžete před časem stáhnout do zařízení a pak instalační skript nasměrovat v adresáři, který obsahuje soubory.You can download one or both of these files ahead of time to the device, then point the installation script at the directory that contains the files. Instalační program nejprve zkontroluje adresář a pak stáhne pouze součásti, které nebyly nalezeny.The installer checks the directory first, and then only downloads components that aren't found. Pokud jsou všechny soubory k dispozici v režimu offline, můžete nainstalovat bez připojení k Internetu.If all the files are available offline, you can install with no internet connection. Tuto funkci můžete také použít k instalaci konkrétní verze součástí.You can also use this feature to install a specific version of the components.

Nejnovější instalační soubory IoT Edge spolu s předchozími verzemi najdete v tématu Azure IoT Edge releases.For the latest IoT Edge installation files along with previous versions, see Azure IoT Edge releases.

Chcete-li provést instalaci pomocí offline komponent, použijte parametr -OfflineInstallationPath jako součást příkazu Deploy-IoTEdge a zadejte absolutní cestu k adresáři souborů.To install with offline components, use the -OfflineInstallationPath parameter as part of the Deploy-IoTEdge command and provide the absolute path to the file directory. Například:For example,

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

Můžete také použít parametr cesty k instalaci offline s příkazem Update-IoTEdge, který jste zavedli později v tomto článku.You can also use the offline installation path parameter with the Update-IoTEdge command, introduced later in this article.

Ověření úspěšné instalaceVerify successful installation

Zkontrolujte stav služby IoT Edge.Check the status of the IoT Edge service. Měl by být uveden jako spuštěný.It should be listed as running.

Get-Service iotedge

Zkontrolujte protokoly služby z posledních 5 minut.Examine service logs from the last 5 minutes. Pokud jste právě dokončili instalaci IoT Edge runtime, může se zobrazit seznam chyb od času mezi spuštěním Deploy-IoTEdge a Initialize-IoTEdge.If you just finished installing the IoT Edge runtime, you may see a list of errors from the time between running Deploy-IoTEdge and Initialize-IoTEdge. Tyto chyby se očekávají, protože se služba pokouší spustit před tím, než se nakonfiguruje.These errors are expected, as the service is trying to start before being configured.

. {Invoke-WebRequest -useb https://aka.ms/iotedge-win} | Invoke-Expression; Get-IoTEdgeLog

Spusťte automatizovanou kontrolu nejběžnějších chyb konfigurace a sítě.Run an automated check for the most common configuration and networking errors.

iotedge check

Seznam s moduly.List running modules. Jediným modulem, který by měl být spuštěný, se po nové instalaci zobrazí edgeAgent.After a new installation, the only module you should see running is edgeAgent. Po prvním nasazení IoT Edge moduly se na zařízení spustí i druhý systémový modul edgeHub.After you deploy IoT Edge modules for the first time, the other system module, edgeHub, will start on the device too.

iotedge list

Správa kontejnerů modulůManage module containers

Služba IoT Edge vyžaduje, aby na vašem zařízení běžel kontejnerový modul.The IoT Edge service requires a container engine running on your device. Když nasadíte modul na zařízení, modul runtime IoT Edge používá modul kontejnerů k vyžádání image kontejneru z registru v cloudu.When you deploy a module to a device, the IoT Edge runtime uses the container engine to pull the container image from a registry in the cloud. Služba IoT Edge umožňuje interakci s moduly a načítání protokolů, někdy ale můžete chtít použít modul kontejnerů k interakci s kontejnerem.The IoT Edge service enables you to interact with your modules and retrieve logs, but sometimes you may want to use the container engine to interact with the container itself.

Další informace o konceptech modulů najdete v tématu principy Azure IoT Edgech modulů.For more information about module concepts, see Understand Azure IoT Edge modules.

Pokud na zařízení s Windows IoT Edge používáte kontejnery Windows, součástí instalace IoT Edge je modul kontejneru Moby.If you're running Windows containers on your Windows IoT Edge device, then the IoT Edge installation included the Moby container engine. Modul Moby byl založen na stejných standardech jako Docker a byl navržený tak, aby běžel paralelně na stejném počítači jako Docker Desktop.The Moby engine was based on the same standards as Docker, and was designed to run in parallel on the same machine as Docker Desktop. Z tohoto důvodu, pokud chcete cílit na kontejnery spravované modulem Moby, je třeba cílit na tento modul místo Docker.For that reason, if you want to target containers managed by the Moby engine, you have to specifically target that engine instead of Docker.

Pokud například chcete zobrazit seznam všech imagí Docker, použijte následující příkaz:For example, to list all Docker images, use the following command:

docker images

Pokud chcete zobrazit seznam všech imagí Moby, upravte stejný příkaz s ukazatelem na modul Moby:To list all Moby images, modify the same command with a pointer to the Moby engine:

docker -H npipe:////./pipe/iotedge_moby_engine images

Identifikátor URI modulu je uveden ve výstupu instalačního skriptu, nebo jej můžete najít v oddílu nastavení modulu runtime kontejneru pro soubor config. yaml.The engine URI is listed in the output of the installation script, or you can find it in the container runtime settings section for the config.yaml file.

moby_runtime identifikátor URI v souboru config. yaml

Další informace o příkazech, které můžete použít k interakci s kontejnery a obrázky běžícími na vašem zařízení, najdete v tématu rozhraní příkazového řádku Docker.For more information about commands you can use to interact with containers and images running on your device, see Docker command-line interfaces.

Aktualizovat existující instalaciUpdate an existing installation

Pokud jste už modul runtime IoT Edge na zařízení napřed a zřídili s identitou IoT Hub, můžete modul runtime aktualizovat, aniž byste museli znovu zadávat informace o zařízení.If you've already installed the IoT Edge runtime on a device before and provisioned it with an identity from IoT Hub, then you can update the runtime without having to reenter your device information.

Další informace najdete v tématu aktualizace démona zabezpečení IoT Edge a modulu runtime.For more information, see Update the IoT Edge security daemon and runtime.

Tento příklad ukazuje instalaci, která odkazuje na existující konfigurační soubor a používá kontejnery Windows:This example shows an installation that points to an existing configuration file, and uses Windows containers:

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

Když aktualizujete IoT Edge, můžete použít další parametry pro úpravu aktualizace, včetně:When you update IoT Edge, you can use additional parameters to modify the update, including:

  • Přímý provoz do provozu prostřednictvím proxy server, neboDirect traffic to go through a proxy server, or
  • Nasměrování instalační služby na offline adresářPoint the installer to an offline directory
  • Restartování bez výzvy, pokud je to nutnéRestarting without a prompt if necessary

Nemůžete deklarovat image kontejneru IoT Edge agenta pomocí parametrů skriptu, protože tyto informace jsou již nastaveny v konfiguračním souboru z předchozí instalace.You can't declare an IoT Edge agent container image with script parameters because that information is already set in the configuration file from the previous installation. Pokud chcete upravit image kontejneru agenta, udělejte to v souboru config. yaml.If you want to modify the agent container image, do so in the config.yaml file.

Další informace o těchto možnostech aktualizace získáte pomocí příkazu Get-Help Update-IoTEdge -full nebo se podívejte na všechny parametry instalace.For more information about these update options, use the command Get-Help Update-IoTEdge -full or refer to all installation parameters.

Odinstalace IoT EdgeUninstall IoT Edge

Pokud chcete odebrat instalaci IoT Edge ze zařízení s Windows, použijte následující příkaz z okna pro správu prostředí PowerShell.If you want to remove the IoT Edge installation from your Windows device, use the following command from an administrative PowerShell window. Tento příkaz odebere modul runtime IoT Edge společně se stávající konfigurací a daty modulu Moby.This command removes the IoT Edge runtime, along with your existing configuration and the Moby engine data.

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

Příkaz uninstall-IoTEdge nefunguje na Windows IoT Core.The Uninstall-IoTEdge command does not work on Windows IoT Core. Chcete-li odebrat IoT Edge ze zařízení s Windows IoT Core, je nutné znovu nasadit bitovou kopii Windows IoT Core.To remove IoT Edge from Windows IoT Core devices, you need to redeploy your Windows IoT Core image.

Další informace o možnostech odinstalace získáte pomocí příkazu Get-Help Uninstall-IoTEdge -full.For more information about uninstallation options, use the command Get-Help Uninstall-IoTEdge -full.

Všechny parametry instalaceAll installation parameters

Předchozí části představily běžné scénáře instalace s příklady použití parametrů pro úpravu instalačního skriptu.The previous sections introduced common installation scenarios with examples of how to use parameters to modify the installation script. V této části najdete referenční tabulky se společnými parametry, které se používají k instalaci, aktualizaci nebo odinstalaci IoT Edge.This section provides reference tables of the common parameters used to install, update, or uninstall IoT Edge.

Deploy-IoTEdgeDeploy-IoTEdge

Příkaz Deploy-IoTEdge stáhne a nasadí démona zabezpečení IoT Edge a jeho závislosti.The Deploy-IoTEdge command downloads and deploys the IoT Edge Security Daemon and its dependencies. Příkaz nasazení akceptuje tyto společné parametry, mimo jiné.The deployment command accepts these common parameters, among others. Pro úplný seznam použijte příkaz Get-Help Deploy-IoTEdge -full.For the full list, use the command Get-Help Deploy-IoTEdge -full.

ParametrParameter Přijaté hodnotyAccepted values KomentářeComments
ContainerOsContainerOs Windows nebo LinuxWindows or Linux Pokud není zadaný žádný operační systém kontejneru, výchozí hodnota je Windows.If no container operating system is specified, Windows is the default value.

V případě kontejnerů Windows používá IoT Edge modul kontejnerů Moby, který je součástí instalace.For Windows containers, IoT Edge uses the moby container engine included in the installation. V případě kontejnerů Linux je před zahájením instalace nutné nainstalovat kontejnerový modul.For Linux containers, you need to install a container engine before starting the installation.
SouboryProxy Adresa URL proxy serveruProxy URL Tento parametr uveďte, pokud vaše zařízení potřebuje k připojení k Internetu projít proxy server.Include this parameter if your device needs to go through a proxy server to reach the internet. Další informace najdete v tématu Konfigurace zařízení IoT Edge pro komunikaci prostřednictvím proxy server.For more information, see Configure an IoT Edge device to communicate through a proxy server.
OfflineInstallationPathOfflineInstallationPath Cesta k adresářiDirectory path Pokud je tento parametr zahrnutý, instalační program zkontroluje uvedený adresář pro soubory IoT Edge CAB a runtime VC, které jsou potřebné pro instalaci.If this parameter is included, the installer will check the listed directory for the IoT Edge cab and VC Runtime MSI files required for installation. Všechny soubory, které nebyly nalezeny v adresáři, se stáhnou.Any files not found in the directory are downloaded. Pokud jsou oba soubory v adresáři, můžete nainstalovat IoT Edge bez připojení k Internetu.If both files are in the directory, you can install IoT Edge without an internet connection. Tento parametr můžete použít také k použití konkrétní verze.You can also use this parameter to use a specific version.
InvokeWebRequestParametersInvokeWebRequestParameters Zatřiďovací tabulka parametrů a hodnotHashtable of parameters and values Během instalace se provedou několik webových požadavků.During installation, several web requests are made. Pomocí tohoto pole můžete nastavit parametry pro tyto webové požadavky.Use this field to set parameters for those web requests. Tento parametr je vhodný pro konfiguraci přihlašovacích údajů pro proxy servery.This parameter is useful to configure credentials for proxy servers. Další informace najdete v tématu Konfigurace zařízení IoT Edge pro komunikaci prostřednictvím proxy server.For more information, see Configure an IoT Edge device to communicate through a proxy server.
RestartIfNeededRestartIfNeeded Žádnánone Tento příznak umožňuje skriptu pro nasazení restartovat počítač bez výzvy, pokud je to nutné.This flag allows the deployment script to restart the machine without prompting, if necessary.

Inicializovat – IoTEdgeInitialize-IoTEdge

Příkaz Initialize-IoTEdge nakonfiguruje IoT Edge s připojovacím řetězcem zařízení a provozními podrobnostmi.The Initialize-IoTEdge command configures IoT Edge with your device connection string and operational details. Většinu informací generovaných tímto příkazem je pak Uloženo v souboru iotedge\config.yaml.Much of the information generated by this command is then stored in the iotedge\config.yaml file. Inicializační příkaz akceptuje tyto společné parametry, mimo jiné.The initialization command accepts these common parameters, among others. Pro úplný seznam použijte příkaz Get-Help Initialize-IoTEdge -full.For the full list, use the command Get-Help Initialize-IoTEdge -full.

ParametrParameter Přijaté hodnotyAccepted values KomentářeComments
ZásahManual ŽádnýNone Parametr SwitchSwitch parameter. Pokud není zadán žádný typ zřizování, je výchozí hodnota ruční.If no provisioning type is specified, manual is the default value.

Deklaruje, že budete zadat připojovací řetězec zařízení pro ruční zřízení zařízení.Declares that you will provide a device connection string to provision the device manually
DPSDps ŽádnýNone Parametr SwitchSwitch parameter. Pokud není zadán žádný typ zřizování, je výchozí hodnota ruční.If no provisioning type is specified, manual is the default value.

Deklarujete, že zadáte ID oboru služby Device Provisioning Service (DPS) a ID registrace vašeho zařízení, které se bude zřizovat prostřednictvím DPS.Declares that you will provide a Device Provisioning Service (DPS) scope ID and your device's Registration ID to provision through DPS.
DeviceConnectionStringDeviceConnectionString Připojovací řetězec ze zařízení IoT Edge zaregistrovaného v IoT Hub v jednoduchých uvozovkáchA connection string from an IoT Edge device registered in an IoT Hub, in single quotes Vyžaduje se pro ruční instalaci.Required for manual installation. Pokud v parametrech skriptu nezadáte připojovací řetězec, během instalace se zobrazí výzva k zadání.If you don't provide a connection string in the script parameters, you will be prompted for one during installation.
Objekt ScopeIdScopeId ID oboru z instance služby Device Provisioning přidružené k vašemu IoT Hub.A scope ID from an instance of Device Provisioning Service associated with your IoT Hub. Vyžaduje se pro instalaci DPS.Required for DPS installation. Pokud v parametrech skriptu nezadáte ID oboru, během instalace se zobrazí výzva k zadání.If you don't provide a scope ID in the script parameters, you will be prompted for one during installation.
RegistrationIdRegistrationId ID registrace generované vaším zařízenímA registration ID generated by your device Vyžaduje se pro instalaci DPS, pokud používáte ověřování pomocí čipu TPM nebo symetrického klíče.Required for DPS installation if using TPM or symmetric key attestation.
SymmetricKeySymmetricKey Symetrický klíč, který slouží k zřízení identity IoT Edge zařízení při použití DPSThe symmetric key used to provision the IoT Edge device identity when using DPS Vyžaduje se pro instalaci DPS, pokud používá ověření identity symetrického klíče.Required for DPS installation if using symmetric key attestation.
ContainerOsContainerOs Windows nebo LinuxWindows or Linux Pokud není zadaný žádný operační systém kontejneru, výchozí hodnota je Windows.If no container operating system is specified, Windows is the default value.

V případě kontejnerů Windows používá IoT Edge modul kontejnerů Moby, který je součástí instalace.For Windows containers, IoT Edge uses the moby container engine included in the installation. V případě kontejnerů Linux je před zahájením instalace nutné nainstalovat kontejnerový modul.For Linux containers, you need to install a container engine before starting the installation.
InvokeWebRequestParametersInvokeWebRequestParameters Zatřiďovací tabulka parametrů a hodnotHashtable of parameters and values Během instalace se provedou několik webových požadavků.During installation, several web requests are made. Pomocí tohoto pole můžete nastavit parametry pro tyto webové požadavky.Use this field to set parameters for those web requests. Tento parametr je vhodný pro konfiguraci přihlašovacích údajů pro proxy servery.This parameter is useful to configure credentials for proxy servers. Další informace najdete v tématu Konfigurace zařízení IoT Edge pro komunikaci prostřednictvím proxy server.For more information, see Configure an IoT Edge device to communicate through a proxy server.
AgentImageAgentImage Identifikátor URI image agenta IoT EdgeIoT Edge agent image URI Ve výchozím nastavení používá nová instalace IoT Edge nejnovější značku pro Image agenta IoT Edge.By default, a new IoT Edge installation uses the latest rolling tag for the IoT Edge agent image. Tento parametr použijte k nastavení konkrétní značky pro verzi obrázku nebo k poskytnutí vlastní image agenta.Use this parameter to set a specific tag for the image version, or to provide your own agent image. Další informace najdete v tématu Vysvětlení značek IoT Edge.For more information, see Understand IoT Edge tags.
Uživatelské jménoUsername Uživatelské jméno registru kontejneruContainer registry username Tento parametr použijte pouze v případě, že nastavíte parametr-AgentImage na kontejner v privátním registru.Use this parameter only if you set the -AgentImage parameter to a container in a private registry. Zadejte uživatelské jméno s přístupem k registru.Provide a username with access to the registry.
HesloPassword Řetězec zabezpečeného heslaSecure password string Tento parametr použijte pouze v případě, že nastavíte parametr-AgentImage na kontejner v privátním registru.Use this parameter only if you set the -AgentImage parameter to a container in a private registry. Zadejte heslo pro přístup do registru.Provide the password to access the registry.

Update – IoTEdgeUpdate-IoTEdge

ParametrParameter Přijaté hodnotyAccepted values KomentářeComments
ContainerOsContainerOs Windows nebo LinuxWindows or Linux Pokud není zadaný žádný kontejnerový operační systém, je Windows výchozí hodnota.If no container OS is specified, Windows is the default value. V případě kontejnerů Windows se v instalaci zahrne modul kontejnerů.For Windows containers, a container engine will be included in the installation. V případě kontejnerů Linux je před zahájením instalace nutné nainstalovat kontejnerový modul.For Linux containers, you need to install a container engine before starting the installation.
SouboryProxy Adresa URL proxy serveruProxy URL Tento parametr uveďte, pokud vaše zařízení potřebuje k připojení k Internetu projít proxy server.Include this parameter if your device needs to go through a proxy server to reach the internet. Další informace najdete v tématu Konfigurace zařízení IoT Edge pro komunikaci prostřednictvím proxy server.For more information, see Configure an IoT Edge device to communicate through a proxy server.
InvokeWebRequestParametersInvokeWebRequestParameters Zatřiďovací tabulka parametrů a hodnotHashtable of parameters and values Během instalace se provedou několik webových požadavků.During installation, several web requests are made. Pomocí tohoto pole můžete nastavit parametry pro tyto webové požadavky.Use this field to set parameters for those web requests. Tento parametr je vhodný pro konfiguraci přihlašovacích údajů pro proxy servery.This parameter is useful to configure credentials for proxy servers. Další informace najdete v tématu Konfigurace zařízení IoT Edge pro komunikaci prostřednictvím proxy server.For more information, see Configure an IoT Edge device to communicate through a proxy server.
OfflineInstallationPathOfflineInstallationPath Cesta k adresářiDirectory path Pokud je tento parametr zahrnutý, instalační program zkontroluje uvedený adresář pro soubory IoT Edge CAB a runtime VC, které jsou potřebné pro instalaci.If this parameter is included, the installer will check the listed directory for the IoT Edge cab and VC Runtime MSI files required for installation. Všechny soubory, které nebyly nalezeny v adresáři, se stáhnou.Any files not found in the directory are downloaded. Pokud jsou oba soubory v adresáři, můžete nainstalovat IoT Edge bez připojení k Internetu.If both files are in the directory, you can install IoT Edge without an internet connection. Tento parametr můžete použít také k použití konkrétní verze.You can also use this parameter to use a specific version.
RestartIfNeededRestartIfNeeded Žádnánone Tento příznak umožňuje skriptu pro nasazení restartovat počítač bez výzvy, pokud je to nutné.This flag allows the deployment script to restart the machine without prompting, if necessary.

Odinstalace – IoTEdgeUninstall-IoTEdge

ParametrParameter Přijaté hodnotyAccepted values KomentářeComments
OdeForce Žádnánone Tento příznak vynutí odinstalaci v případě neúspěchu předchozího pokusu o odinstalaci.This flag forces the uninstallation in case the previous attempt to uninstall was unsuccessful.
RestartIfNeededRestartIfNeeded Žádnánone Tento příznak umožňuje, aby skript pro odinstalaci restartoval počítač bez výzvy, pokud je to nutné.This flag allows the uninstall script to restart the machine without prompting, if necessary.

Další krokyNext steps

Teď, když máte nainstalovanou IoT Edge zařízení s nainstalovaným modulem runtime, můžete nasadit IoT Edge moduly.Now that you have an IoT Edge device provisioned with the runtime installed, you can deploy IoT Edge modules.

Pokud máte potíže s instalací IoT Edge správně, podívejte se na stránku Poradce při potížích .If you are having problems installing IoT Edge properly, check out the troubleshooting page.

Chcete-li aktualizovat existující instalaci na nejnovější verzi IoT Edge, přečtěte si téma aktualizace procesu démona zabezpečení IoT Edge a modulu runtime.To update an existing installation to the newest version of IoT Edge, see Update the IoT Edge security daemon and runtime.