Zelf-hostende integration runtime-installatie automatiseren met behulp van lokale PowerShell-scripts

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

Vereiste voorwaarden

• Start PowerShell op uw lokale computer. Als u de scripts wilt uitvoeren, moet u Uitvoeren als administrator kiezen.
• Download de zelfgehoste 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 moet u beschikken over een vooraf geconfigureerde zelf-hostende Integration Runtime.

Inleiding van scripts

Opmerking

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 te voldoen 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 zelf-hostend Integration Runtime-knooppunt te installeren en te registreren met een verificatiesleutel. Het script accepteert twee argumenten, waarbij eerst de locatie van de zelf-hostende Integration Runtime op een lokale schijf wordt opgegeven, en vervolgens de verificatiesleutel wordt opgegeven (voor het registreren van een 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 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 versienummer (bijvoorbeeld: -version 3.13.6942.1). Wanneer er geen versie is opgegeven, wordt de zelf-hostende IR altijd bijgewerkt naar de nieuwste versie die in de downloads is gevonden.

  Opmerking

  Alleen laatste 3 versies kunnen worden opgegeven. In het ideale voorbeeld wordt dit gebruikt om een bestaand knooppunt bij te werken naar de nieuwste versie. DIT GAAT ERVAN UIT DAT U EEN GEREGISTREERDE ZELFGEHOSTE IR HEBT.

Voorbeelden van gebruik

Voor het automatiseren van de installatie

1. Download de zelfgehoste IR.

2. Geef het pad op waar het bovenstaande 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]"
   

   Opmerking

   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 een vooraf geïnstalleerde zelf-gehoste IR op uw machine is, verwijdert het script het automatisch en configureert vervolgens een nieuwe. Het volgende venster wordt weergegeven:

4. Wanneer de installatie en sleutelregistratie is voltooid, ziet u dat Installatie van gateway geslaagd en Registratie van gateway geslaagd in uw lokale PowerShell verschijnen.

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-gehoste IR-versie controleren
2. Meest recente versie of opgegeven versie ophalen via een parameter
3. Als er een nieuwere versie is dan de huidige versie:
   • zelf-gehoste IR msi downloaden
   • het upgraden

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

• Download en installeer de nieuwste gateway:

  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 versie is, ziet u het volgende resultaat, wat aangeeft dat er geen update vereist is. [