Automatizace instalace místního prostředí Integration Runtime pomocí místních skriptů PowerShellu

  • Článek

Pokud chcete automatizovat instalaci Integration Runtime v místním prostředí na místních počítačích (kromě virtuálních počítačů Azure, kde můžeme místo toho využít šablonu Resource Manager), můžete použít místní skripty PowerShellu. Tento článek představuje dva skripty, které můžete použít.

Požadavky

  • Spusťte PowerShell na místním počítači. Pokud chcete skripty spustit, musíte zvolit Spustit jako správce.
  • Stáhněte si software místního prostředí Integration Runtime. Zkopírujte cestu, kde je stažený soubor.
  • K registraci místního prostředí Integration Runtime potřebujete také ověřovací klíč .
  • Pro automatizaci ručních aktualizací musíte mít předem nakonfigurované místní prostředí Integration Runtime.

Úvod ke skriptům

Poznámka

Tyto skripty se vytvářejí pomocí zdokumentovaného nástroje příkazového řádku v místním prostředí Integration Runtime. V případě potřeby můžete tyto skripty odpovídajícím způsobem přizpůsobit tak, aby vyhovovaly jejich potřebám automatizace. Skripty je potřeba použít pro jednotlivé uzly, proto je nezapomeňte spustit na všech uzlech v případě nastavení vysoké dostupnosti (2 nebo více uzlů).

  • Pro automatizaci nastavení: Nainstalujte a zaregistrujte nový uzel místního prostředí Integration Runtime pomocí InstallGatewayOnLocalMachine.ps1 – Skript lze použít k instalaci uzlu místního prostředí Integration Runtime a jeho registraci pomocí ověřovacího klíče. Skript přijímá dva argumenty, první určuje umístění místního prostředí Integration Runtime na místním disku a druhý určuje ověřovací klíč (pro registraci uzlu místního prostředí IR).

  • Pro automatizaci ručních aktualizací: Aktualizujte uzel místního prostředí IR na konkrétní verzi nebo na nejnovější verzi script-update-gateway.ps1 – tato možnost se podporuje také v případě, že jste vypnuli automatickou aktualizaci nebo chcete mít větší kontrolu nad aktualizacemi. Skript lze použít k aktualizaci uzlu místního prostředí Integration Runtime na nejnovější verzi nebo na zadanou vyšší verzi (downgrade nefunguje). Přijímá argument pro zadání čísla verze (příklad: -version 3.13.6942.1). Pokud není zadaná žádná verze, vždy aktualizuje místní prostředí IR na nejnovější verzi, která se nachází ve stažených souborech.

    Poznámka

    Je možné zadat pouze poslední 3 verze. V ideálním případě se používá k aktualizaci existujícího uzlu na nejnovější verzi. PŘEDPOKLÁDÁ SE, ŽE MÁTE ZAREGISTROVANÉ MÍSTNÍ PROSTŘEDÍ IR.

Příklady použití

Pro automatizaci nastavení

  1. Stáhněte si místní prostředí IR.

  2. Zadejte cestu, kam se nachází výše stažené instalační soubor MSI ir. Pokud je například cesta C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msi, můžete pro tuto úlohu použít následující příklad příkazového řádku PowerShellu:

    PS C:\windows\system32> C:\Users\username\Desktop\InstallGatewayOnLocalMachine.ps1 -path "C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msi" -authKey "[key]"

    Poznámka

    Nahraďte [klíč] ověřovacím klíčem pro registraci prostředí IR. Nahraďte "username" svým uživatelským jménem. Při spuštění skriptu zadejte umístění souboru "InstallGatewayOnLocalMachine.ps1". V tomto příkladu jsme ho uložili na Desktop.

  3. Pokud je na vašem počítači předinstalované prostředí IR v místním prostředí, skript ho automaticky odinstaluje a pak nakonfiguruje nové prostředí IR. Zobrazí se následující okno: konfigurace prostředí Integration Runtime

  4. Po dokončení instalace a registrace klíče se v místním PowerShellu zobrazí informace o úspěšné instalaci brány a úspěšné registraci výsledků brány . Výsledek spuštění skriptu 1

Automatizace ručních aktualizací

Tento skript slouží k aktualizaci/instalaci a registraci nejnovějšího místního prostředí Integration Runtime. Spuštění skriptu provede následující kroky:

  1. Kontrola aktuální verze místního prostředí IR
  2. Získání nejnovější verze nebo zadané verze z argumentu
  3. Pokud existuje novější verze než aktuální verze:
    • stažení msi místního prostředí IR
    • upgradovat

Tento skript můžete použít podle následujícího příkladu příkazového řádku:

  • Stáhněte a nainstalujte nejnovější bránu:

    PS C:\windows\system32> C:\Users\username\Desktop\script-update-gateway.ps1

  • Stáhněte a nainstalujte bránu zadané verze:

    PS C:\windows\system32> C:\Users\username\Desktop\script-update-gateway.ps1 -version 3.13.6942.1

    Pokud už máte nejnovější verzi, zobrazí se následující výsledek, který naznačuje, že se nevyžaduje žádná aktualizace. [výsledek spuštění skriptu 2](media/self-hosted-integration-runtime-automation-scripts/script-2-run-result.png)