Zelf-hostende integratieruntime-installatie automatiseren met behulp van lokale PowerShell-scripts

  • Artikel

Als u de installatie van zelf-hostende Integration Runtime op lokale machines wilt automatiseren (met uitzondering van azure-VM's waar we in plaats daarvan de sjabloon Resource Manager kunnen gebruiken), kunt u lokale PowerShell-scripts gebruiken. In dit artikel worden twee scripts geïntroduceerd die u kunt gebruiken.

Vereisten

  • Start PowerShell op uw lokale computer. Als u de scripts wilt uitvoeren, moet u Als administrator uitvoeren kiezen.
  • Download de zelf-hostende Integration Runtime-software. Kopieer het pad waar het gedownloade bestand zich bevindt.
  • U hebt ook een verificatiesleutel nodig om de zelf-hostende Integration Runtime te registreren.
  • Voor het automatiseren van handmatige updates hebt u een vooraf geconfigureerde zelf-hostende Integration Runtime nodig.

Inleiding tot scripts

Notitie

Deze scripts worden gemaakt met behulp van het gedocumenteerde opdrachtregelprogramma in de zelf-hostende Integration Runtime. Indien nodig kan men deze scripts dienovereenkomstig aanpassen om tegemoet te komen aan hun automatiseringsbehoeften. De scripts moeten per knooppunt worden toegepast, dus zorg ervoor dat u deze uitvoert op alle knooppunten in het geval van installatie met hoge beschikbaarheid (2 of meer knooppunten).

  • Voor het automatiseren van de installatie: installeer en registreer een nieuw zelf-hostend Integration Runtime-knooppunt met behulp vanInstallGatewayOnLocalMachine.ps1 : het script kan worden gebruikt om het zelf-hostende Integration Runtime-knooppunt te installeren en te registreren met een verificatiesleutel. Het script accepteert twee argumenten: eerst de locatie van de zelf-hostende Integration Runtime op een lokale schijf opgeven en vervolgens de verificatiesleutel opgeven (voor het registreren van zelf-hostend IR-knooppunt).

  • Voor het automatiseren van handmatige updates: werk het zelf-hostende IR-knooppunt bij met een specifieke versie of naar de nieuwste versie script-update-gateway.ps1 : dit wordt ook ondersteund als u de automatische update hebt uitgeschakeld of meer controle wilt hebben over updates. Het script kan worden gebruikt om het zelf-hostende Integration Runtime-knooppunt bij te werken naar de nieuwste versie of naar een opgegeven hogere versie (downgrade werkt niet). Het accepteert een argument voor het opgeven van het versienummer (bijvoorbeeld: -versie 3.13.6942.1). Wanneer er geen versie is opgegeven, wordt de zelf-hostende IR altijd bijgewerkt naar de meest recente versie in de downloads.

    Notitie

    Alleen de laatste 3 versies kunnen worden opgegeven. Idealiter wordt dit gebruikt om een bestaand knooppunt bij te werken naar de nieuwste versie. ER WORDT VAN UITGEGAAN DAT U EEN GEREGISTREERDE ZELF-HOSTENDE IR HEBT.

Gebruiksvoorbeelden

Voor het automatiseren van de installatie

  1. Download de zelf-hostende IR.

  2. Geef het pad op waar de hierboven gedownloade SHIR MSI (installatiebestand) zich bevindt. Als het pad bijvoorbeeld C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msiis, kunt u het volgende PowerShell-opdrachtregelvoorbeeld voor deze taak gebruiken:

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

    Notitie

    Vervang [key] door de verificatiesleutel om uw IR te registreren. Vervang 'gebruikersnaam' door uw gebruikersnaam. Geef de locatie op van het bestand 'InstallGatewayOnLocalMachine.ps1' bij het uitvoeren van het script. In dit voorbeeld hebben we deze opgeslagen op Desktop.

  3. Als er één vooraf geïnstalleerde zelf-hostende IR op uw computer is, wordt deze automatisch door het script verwijderd en wordt er vervolgens een nieuwe geconfigureerd. Het volgende venster wordt weergegeven: Integration Runtime configureren

  4. Wanneer de installatie en sleutelregistratie zijn voltooid, ziet u Geslaagd om gateway te installeren en Geslaagd om gatewayresultaten te registreren in uw lokale PowerShell. script 1 uitvoeringsresultaat

Voor het automatiseren van handmatige updates

Dit script wordt gebruikt voor het bijwerken/installeren en registreren van de meest recente zelf-hostende Integration Runtime. De scriptuitvoering voert de volgende stappen uit:

  1. Huidige zelf-hostende IR-versie controleren
  2. De meest recente versie of opgegeven versie ophalen van het argument
  3. Als er een nieuwere versie is dan de huidige versie:
    • zelf-hostende IR msi downloaden
    • upgraden

U kunt het onderstaande opdrachtregelvoorbeeld volgen om dit script te gebruiken:

  • De nieuwste gateway downloaden en installeren:

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

  • Download en installeer de gateway van de opgegeven versie:

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

    Als uw huidige versie al de meest recente is, ziet u het volgende resultaat, wat suggereert dat er geen update vereist is. [script 2 run result](media/self-hosted-integration-runtime-automation-scripts/script-2-run-result.png)