Hybride machines verbinden met Azure met behulp van een implementatiescript

U kunt servers met Azure Arc inschakelen voor een of meer Windows- of Linux-machines in uw omgeving door handmatig een set stappen uit te voeren. U kunt ook een geautomatiseerde methode gebruiken door een sjabloonscript uit te voeren dat we aan u geven. Met dit script wordt het downloaden en installeren van beide agents geautomatiseerd.

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Automatische verbinding voor SQL Server

Wanneer u een Windows- of Linux-server verbindt met Azure Arc waarop ook Microsoft SQL Server is geïnstalleerd, worden de SQL Server-exemplaren ook automatisch verbonden met Azure Arc. SQL Server ingeschakeld door Azure Arc biedt een gedetailleerde inventarisatie en aanvullende beheermogelijkheden voor uw SQL Server-exemplaren en -databases. Als onderdeel van het verbindingsproces wordt een extensie geïmplementeerd op uw Server met Azure Arc en worden nieuwe rollen toegepast op uw SQL Server en databases. Als u uw SQL-servers niet automatisch wilt verbinden met Azure Arc, kunt u zich afmelden door een tag toe te voegen aan de Windows- of Linux-server met de naam ArcSQLServerExtensionDeployment en waarde Disabled bij het verbinden met Azure Arc.

Zie Automatische verbinding beheren voor SQL Server ingeschakeld door Azure Arc voor meer informatie.

Vereiste voorwaarden

Voor deze methode moet u beheerdersrechten hebben om de agent te installeren en te configureren op de machine. Gebruik in Linux het hoofdaccount en in Windows moet u lid zijn van de groep Lokale beheerders.
Voordat u aan de slag gaat, controleert u de vereisten voor de Connected Machine-agent en controleert u of uw abonnement en resources aan de vereisten voldoen. Zie ondersteunde Azure-regio's voor informatie over ondersteunde regio's en andere gerelateerde overwegingen.

Note

Volg de aanbevolen beveiligingsprocedures en vermijd het gebruik van een Azure-account met eigenaarstoegang tot onboardservers. Gebruik in plaats daarvan een account dat alleen de roltoewijzing Azure Connected Machine Onboarding of Azure Connected Machine Resource Administrator heeft. Voor meer informatie, zie best practices voor beveiliging van Azure Identity Management en toegangsbeheer.

Het installatiescript genereren vanuit Azure Portal

Gebruik Azure Portal om een script te maken waarmee het downloaden en installeren van de agent wordt geautomatiseerd en de verbinding met Azure Arc tot stand wordt gebracht. Voer de volgende stappen uit om het proces te voltooien:

Zoek en selecteer Azure Arc boven aan Azure Portal.
In het servicemenu, vouw Infrastructuur uit en selecteer Machines.
Kies Invoegen/Maken en kies vervolgens Bestaande machines invoegen.
Geef op de pagina Basisinformatie het volgende op:
1. Selecteer het abonnement en de resourcegroep voor de machines.
2. Selecteer onder Regio de Azure-regio om de metagegevens van de servers op te slaan.
3. Selecteer onder Besturingssysteem het besturingssysteem waarop het script is geconfigureerd voor uitvoering.
4. Onder Connectiviteitsmethode:
  1. Selecteer een openbaar eindpunt of een privé-eindpunt. Als u een privé-eindpunt selecteert, kunt u een bestaand privékoppelingsbereik selecteren of een nieuw privékoppelingsbereik maken.
  2. Als u een PROXYserver-URL wilt gebruiken, voert u het IP-adres van de proxyserver of de naam en het poortnummer in die de computer in de indeling http://<proxyURL>:<proxyport>gebruikt.
  3. Als u openbaar eindpunt hebt geselecteerd en u Azure Arc Gateway wilt gebruiken, selecteert u een bestaande gatewayresource of maakt u een nieuwe.
5. Selecteer onder Verificatie de optie Machines handmatig verifiëren en selecteer vervolgens Volgende.
Controleer onder Tags de standaardtags voor fysieke locatie die worden voorgesteld en voer een waarde in of geef een of meer aangepaste tags op ter ondersteuning van uw standaarden.
Kies Volgende.
Controleer onder Script downloaden en uitvoeren de samenvattingsgegevens. Als u wijzigingen wilt aanbrengen, selecteert u Vorige en voert u de benodigde wijzigingen aan.
Selecteer Download en selecteer daarna sluiten.

Voor Windows wordt u gevraagd om op te slaan OnboardingScript.ps1en voor Linux OnboardingScript.sh op uw computer.

U kunt de Connected Machine-agent handmatig installeren door het Windows Installer-pakket uit te voeren AzureConnectedMachineAgent.msi. U kunt de nieuwste versie van het Windows Installer-pakket van de Windows-agent downloaden via het Microsoft Downloadcentrum.

Note

Als u de agent wilt installeren of verwijderen, moet u beheerdersmachtigingen hebben.
U moet eerst het installatiepakket downloaden en kopiëren naar een map op de doelserver of vanuit een gedeelde netwerkmap. Als u het installatiepakket zonder opties uitvoert, wordt er een installatiewizard gestart die u kunt volgen om de agent interactief te installeren.

Als de computer via een proxyserver moet communiceren met de service, moet u na de installatie van de agent een opdracht uitvoeren die in de volgende stappen wordt beschreven. Met deze opdracht stelt u de omgevingsvariabele https_proxyvan het proxyserversysteem in. Wanneer deze configuratie wordt gebruikt, communiceert de agent via de proxyserver met behulp van het HTTP-protocol.

Als u niet bekend bent met de opdrachtregelopties voor Windows Installer-pakketten, bekijkt u de standaard opdrachtregelopties van Msiexec en msiexec-opdrachtregelopties.

Voer bijvoorbeeld het installatieprogramma uit met de /? parameter om de help- en snelzoekoptie te bekijken.

msiexec.exe /i AzureConnectedMachineAgent.msi /?

Als u de agent op de achtergrond wilt installeren en een installatielogboekbestand in de C:\Support\Logs map wilt maken, voert u de volgende opdracht uit.
```
msiexec.exe /i AzureConnectedMachineAgent.msi /qn /l*v "C:\Support\Logs\Azcmagentsetup.log"
```
Als de agent niet kan worden gestart nadat de installatie is voltooid, controleert u de logboeken op gedetailleerde foutinformatie. De logboekmap is %ProgramData%\AzureConnectedMachineAgent\log.
Als de computer moet communiceren via een proxyserver, stelt u de omgevingsvariabele van de proxyserver in door de volgende opdracht uit te voeren. Vervang {proxy-url} door het adres van uw proxyserver (bijvoorbeeld proxy.example.com) en {proxy-port} door het poortnummer (bijvoorbeeld 8080).
```
[Environment]::SetEnvironmentVariable("https_proxy", "http://{proxy-url}:{proxy-port}", "Machine")
$env:https_proxy = [System.Environment]::GetEnvironmentVariable("https_proxy","Machine")
# For the changes to take effect, the agent service needs to be restarted after the proxy environment variable is set.
Restart-Service -Name HIMDS
```
Note

De agent biedt geen ondersteuning voor het instellen van proxyverificatie.

Zie Agentspecifieke proxyconfiguratie voor meer informatie.
Nadat u de agent hebt geïnstalleerd, configureert u deze om te communiceren met de Azure Arc-service.

Parameters
- --resource-group (tekenreeks, voorbeeld: myResourceGroup)
- --tenant-id (tekenreeks, voorbeeld: aaaabbbb-0000-cccc-1111-dddd2222eeee)
- --subscription-id (tekenreeks, voorbeeld: aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e)
- --location (tekenreeks, voorbeeld: eastus)
- --cloud (tekenreeks, voorbeeld: AzureCloud)
- --proxy (tekenreeks, voorbeeld: http://proxy.example.com:8080)
```
& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" connect `
  --resource-group "myResourceGroup" `
  --tenant-id "aaaabbbb-0000-cccc-1111-dddd2222eeee" `
  --location "eastus" `
  --subscription-id "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
```

Meld u aan bij de server.
Open een PowerShell-opdrachtprompt met verhoogde bevoegdheid.

Note

Het script ondersteunt alleen uitvoering vanuit een 64-bits versie van Windows PowerShell.
Ga met de cd opdracht naar de map of het deel waarnaar u het script hebt gekopieerd en voer het uit op de server door het script met de .\OnboardingScript.ps1 opdracht uit te voeren. Voorbeeld:
```
cd $env:USERPROFILE\Downloads
.\OnboardingScript.ps1
```

Als de agent niet kan worden gestart nadat de installatie is voltooid, controleert u de logboeken op gedetailleerde foutinformatie. De logboekmap is %ProgramData%\AzureConnectedMachineAgent\log.

De agent installeren in Linux

Handmatige installatie
Scriptinstallatie

De Connected Machine-agent voor Linux wordt geleverd in de gewenste pakketindeling voor de distributie (.RPM of .DEB) die wordt gehost in de Microsoft-pakketopslagplaats. De shellscriptbundel Install_linux_azcmagent.sh voert de volgende acties uit:

Hiermee configureert u de hostcomputer om het agentpakket te downloaden van packages.microsoft.com.
Hiermee wordt het pakket Hybrid Resource Provider geïnstalleerd.

U kunt de agent desgewenst configureren met uw proxygegevens door de --proxy "{proxy-url}:{proxy-port}" parameter op te geven. Wanneer deze configuratie wordt gebruikt, communiceert de agent via de proxyserver met behulp van het HTTP-protocol.

Het script bevat ook logica om de ondersteunde en niet-ondersteunde distributies te identificeren en controleert de machtigingen die nodig zijn om de installatie uit te voeren.

Voer de volgende opdrachten uit om de agent te downloaden en te installeren:

# Download the installation package.
wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh

# Install the Azure Connected Machine agent.
bash ~/Install_linux_azcmagent.sh

Als uw computer moet communiceren via een proxyserver om verbinding te maken met internet, neemt u de --proxy parameter op, bijvoorbeeld:

# Download the installation package.
wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh

# Install the Azure Connected Machine agent.
bash ~/Install_linux_azcmagent.sh --proxy "proxy.contoso.com:8080"

Nadat u de agent hebt geïnstalleerd, configureert u deze om te communiceren met de Azure Arc-service:

Parameters
- --resource-group (tekenreeks, voorbeeld: myResourceGroup)
- --tenant-id (tekenreeks, voorbeeld: aaaabbbb-0000-cccc-1111-dddd2222eeee)
- --subscription-id (tekenreeks, voorbeeld: aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e)
- --location (tekenreeks, voorbeeld: eastus)
- --cloud (tekenreeks, voorbeeld: AzureCloud)
- --proxy (tekenreeks, voorbeeld: http://proxy.example.com:8080)
```
azcmagent connect \
  --resource-group "myResourceGroup" \
  --tenant-id "aaaabbbb-0000-cccc-1111-dddd2222eeee" \
  --location "eastus" \
  --subscription-id "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" \
  --cloud "AzureCloud"
```

Meld u aan bij de server met een account met hoofdtoegang.
Ga naar de map of share waarnaar u het script hebt gekopieerd en voer dit uit op de server door het script ./OnboardingScript.sh uit te voeren.
```
cd ~/Downloads
./OnboardingScript.sh
```
Als u de foutmelding 'Machtiging geweigerd' krijgt, controleert u of het script uitvoerbaar is gemaakt:
```
chmod +x ~/Downloads/OnboardingScript.sh
./OnboardingScript.sh
```

Als de agent niet kan worden gestart nadat de installatie is voltooid, controleert u de logboeken op gedetailleerde foutinformatie. De logboekmap is /var/opt/azcmagent/log.

De verbinding met Azure Arc controleren

Nadat u de agent hebt geïnstalleerd en geconfigureerd om verbinding te maken met servers met Azure Arc, gaat u naar Azure Portal om te controleren of de server is verbonden.

Schermopname van een geslaagde computerverbinding in Azure Portal.

Volgende stappen

Informatie over het oplossen van problemen vindt u in de handleiding Problemen met de connected machine-agent oplossen.
Raadpleeg de plannings- en implementatiehandleiding voor het plannen van de implementatie van servers met Azure Arc op elke schaal en implementeer gecentraliseerd beheer en bewaking.
U kunt uw machines beheren met behulp van Azure Policy voor taken zoals de gastconfiguratie van een virtuele machine (VM). Azure Policy helpt ook te controleren of machines rapporteren aan de verwachte Log Analytics-werkruimte. U kunt uw machines ook bewaken met VM-inzichten en andere bewakingshulpprogramma's.

Feedback

Is deze pagina nuttig?

Last updated on 2026-01-29