Dela via

Aktivera Azure VM-tillägg med hjälp av Azure CLI (Windows och Linux)

Den här artikeln beskriver hur du distribuerar, uppgraderar, uppdaterar och avinstallerar vm-tillägg (VM) på Azure Arc-aktiverade servrar med hjälp av Azure CLI (Windows och Linux).

Förutsättningar

Installera tillägget Ansluten dator i Azure CLI

Kommandona ConnectedMachine levereras inte som en del av Azure CLI. Innan du använder Azure CLI för att ansluta till Azure och hantera VM-tillägg på din hybridserver som hanteras av Azure Arc-aktiverade servrar måste du läsa in ConnectedMachine tillägget.

Du kan utföra dessa hanteringsåtgärder från din arbetsstation i stället för på den Azure Arc-aktiverade servern.

Kör följande kommando för att installera Azure CLI-tillägget ConnectedMachine :

az extension add --name connectedmachine

Aktivera ett tillägg

Om du vill aktivera ett VM-tillägg på din Azure Arc-aktiverade server använder du az connectedmachine extension create med parametrarna --machine-name, --extension-name, --location, --type, settings och --publisher.

Det här exemplet aktiverar tillägget för anpassat skript på en Azure Arc-aktiverad server:

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"

Det här exemplet aktiverar azure Key Vault VM-tillägget på en Azure Arc-aktiverad server:

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" }}'

Det här exemplet aktiverar Microsoft Antimalware-tillägget på en Azure Arc-aktiverad Windows-server:

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

Det här exemplet aktiverar Datadog-tillägget på en Azure Arc-aktiverad Windows-server:

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" }'

Tips/Råd

Många andra tillägg stöds på Arc-aktiverade servrar. Mer information finns i Tilläggshantering för virtuella datorer med Azure Arc-aktiverade servrar.

Listtillägg installerade

Om du vill hämta en lista över VM-tillägg på din Azure Arc-aktiverade server använder du az connectedmachine extension list med parametrarna --machine-name och --resource-group :

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

Som standard finns utdata från Azure CLI-kommandon i JSON (JavaScript Object Notation). Om du vill ändra standardutdata till en lista eller tabell använder du till exempel az config set core.output=table. Du kan också lägga till --output till vilket som helst kommando för en engångsändring i utdataformatet.

I följande exempel visas de partiella JSON-utdata från az connectedmachine extension -list kommandot:

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

Uppdatera en tilläggskonfiguration

Vissa VM-tillägg kräver konfigurationsinställningar så att du kan installera dem på en Azure Arc-aktiverad server (till exempel tillägget för anpassat skript). Om du vill uppgradera konfigurationen av ett tillägg använder du az connectedmachine extension update.

I följande exempel visas hur du konfigurerar tillägget för anpassat skript:

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"

Uppgradera tillägg

När en ny version av ett vm-tillägg som stöds släpps kan du uppgradera det till den senaste versionen. Om du vill uppgradera ett VM-tillägg använder du az connectedmachine upgrade-extension parametrarna --machine-name, --resource-group och --extension-targets.

För parametern --extension-targets måste du ange tillägget och den senaste tillgängliga versionen. Om du vill fastställa den senaste versionen som är tillgänglig för ett tillägg går du till sidan Tillägg för den valda Azure Arc-aktiverade servern i Azure Portal, eller kör az vm extension image list. Du kan ange flera tillägg i en enda uppgraderingsbegäran genom att ange båda:

  • En kommaavgränsad lista över tillägg som definieras av deras utgivare och typ (avgränsade med en punkt)
  • Målversionen för varje tillägg

Du kan granska versionen av installerade VM-tillägg när som helst genom att köra kommandot az connectedmachine extension list. Egenskapsvärdet typeHandlerVersion representerar versionen av tillägget.

Tips/Råd

Många VM-tillägg kan konfigureras för automatiska uppgraderingar.

Ta bort tillägg

Om du vill ta bort ett installerat VM-tillägg från din Azure Arc-aktiverade server använder du az connectedmachine extension delete parametrarna --extension-name, --machine-nameoch --resource-group .

Relaterat innehåll