Azure VM-extensies inschakelen met behulp van de Azure CLI (Windows en Linux)

In dit artikel wordt uitgelegd hoe u extensies voor virtuele machines (VM's) kunt implementeren, upgraden, bijwerken en verwijderen op servers met Azure Arc met behulp van de Azure CLI (Windows en Linux).

Benodigdheden

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Aan de slag met Azure Cloud Shell voor meer informatie.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Zie Verifiëren bij Azure met behulp van Azure CLI voor andere aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Zie Extensies gebruiken en beheren met de Azure CLIvoor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

De extensie Verbonden machine installeren in de Azure CLI

De ConnectedMachine opdrachten worden niet verzonden als onderdeel van de Azure CLI. Voordat u de Azure CLI gebruikt om verbinding te maken met Azure en VM-extensies te beheren op uw hybride server die wordt beheerd door servers met Azure Arc, moet u de ConnectedMachine extensie laden.

U kunt deze beheerbewerkingen uitvoeren vanaf uw werkstation in plaats van op de server met Azure Arc.

Voer de volgende opdracht uit om de Azure CLI-extensie ConnectedMachine te installeren:

az extension add --name connectedmachine

Een extensie inschakelen

Om een VM-extensie in te schakelen op uw Azure Arc ingeschakelde server, gebruikt u az connectedmachine extension create met de parameters --machine-name, --extension-name, --location, --type, settings en --publisher.

In dit voorbeeld wordt de aangepaste scriptextensie ingeschakeld op een server met Azure Arc:

az connectedmachine extension create --machine-name "myMachineName" --name "CustomScriptExtension" --location "regionName" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -gt 10000 }\\\"\"}" --type-handler-version "1.10" --resource-group "myResourceGroup"

In dit voorbeeld wordt de Azure Key Vault-VM-extensie ingeschakeld op een server met Azure Arc:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.KeyVault" --type "KeyVaultForLinux or KeyVaultForWindows" --name "KeyVaultForLinux or KeyVaultForWindows" --settings '{"secretsManagementSettings": { "pollingIntervalInS": "60", "observedCertificates": ["observedCert1"] }, "authenticationSettings": { "msiEndpoint": "http://localhost:40342/metadata/identity" }}'

In dit voorbeeld wordt de Microsoft Antimalware-extensie ingeschakeld op een Windows-server met Azure Arc:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.Security" --type "IaaSAntimalware" --name "IaaSAntimalware" --settings '"{\"AntimalwareEnabled\": \"true\"}"'

In dit voorbeeld wordt de Datadog-extensie ingeschakeld op een Windows-server met Azure Arc:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Datadog.Agent" --type "DatadogWindowsAgent" --settings '{"site": "us3.datadoghq.com"}' --protected-settings '{"api_key": "YourDatadogAPIKey" }'

Toon geïnstalleerde extensies

Als u een lijst met VM-extensies op uw Azure Arc-ingeschakelde server wilt ophalen, gebruikt u az connectedmachine extension list met de parameters --machine-name en --resource-group.

az connectedmachine extension list --machine-name "myMachineName" --resource-group "myResourceGroup"

Standaard bevindt de uitvoer van Azure CLI-opdrachten zich in JSON (JavaScript Object Notation). Als u de standaarduitvoer wilt wijzigen in een lijst of tabel, gebruikt u bijvoorbeeld az config set core.output=table. U kunt ook aan elke opdracht toevoegen --output voor een eenmalige wijziging in de uitvoerindeling.

In het volgende voorbeeld ziet u de gedeeltelijke JSON-uitvoer van de az connectedmachine extension -list opdracht:

[
  {
    "autoUpgradingMinorVersion": "false",
    "forceUpdateTag": null,
    "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.HybridCompute/machines/SVR01/extensions/DependencyAgentWindows",
    "location": "regionName",
    "name": "DependencyAgentWindows",
    "namePropertiesInstanceViewName": "DependencyAgentWindows",

Een extensieconfiguratie bijwerken

Voor sommige VM-extensies zijn configuratie-instellingen vereist, zodat u deze kunt installeren op een server met Azure Arc (zoals de aangepaste scriptextensie). Als u de configuratie van een extensie wilt upgraden, gebruikt u az connectedmachine extension update.

In het volgende voorbeeld ziet u hoe u de aangepaste scriptextensie configureert:

az connectedmachine extension update --name "CustomScriptExtension" --type "CustomScriptExtension" --publisher "Microsoft.HybridCompute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version "1.10" --machine-name "myMachine" --resource-group "myResourceGroup"

Extensies upgraden

Wanneer een nieuwe versie van een ondersteunde VM-extensie wordt uitgebracht, kunt u deze upgraden naar die nieuwste versie. Als u een VM-extensie wilt upgraden, gebruikt u az connectedmachine upgrade-extension met de parameters --machine-name, --resource-group en --extension-targets.

Voor de --extension-targets parameter moet u de extensie en de meest recente versie opgeven die beschikbaar is. Als u wilt bepalen welke nieuwste versie beschikbaar is voor een extensie, gaat u naar de pagina Extensies voor de geselecteerde Azure Arc-server in Azure Portal of voert u az vm extension image list uit. U kunt meerdere extensies opgeven in één upgradeaanvraag door beide voorzieningen te specificeren:

• Een door komma's gescheiden lijst met extensies, gedefinieerd door de uitgever en het type (gescheiden door een punt)
• De doelversie voor elke extensie

U kunt de versie van geïnstalleerde VM-extensies op elk gewenst moment controleren door de opdracht az connectedmachine extension listuit te voeren. De typeHandlerVersion eigenschapswaarde vertegenwoordigt de versie van de extensie.

Extensies verwijderen

Als u een geïnstalleerde VM-extensie van uw Azure Arc-ingeschakelde server wilt verwijderen, gebruikt u az connectedmachine extension delete met de parameters --extension-name, --machine-name en --resource-group.

Gerelateerde inhoud

• VM-extensies implementeren, beheren en verwijderen met behulp van Azure PowerShell, Azure Portal of Azure Resource Manager-sjablonen.
• Zoek informatie over probleemoplossing in de handleiding voor het oplossen van problemen met VM-extensies.
• Raadpleeg het overzicht van de Azure CLI-VM-extensie voor meer informatie over de opdrachten.