Aktivera Azure VM-tillägg med hjälp av Azure CLI

Artikel
10/01/2024

Den här artikeln visar hur du distribuerar, uppgraderar, uppdaterar och avinstallerar VM-tillägg som stöds av Azure Arc-aktiverade servrar till en Linux- eller Windows-hybriddator med hjälp av Azure CLI.

Kommentar

Azure Arc-aktiverade servrar stöder inte distribution och hantering av VM-tillägg till virtuella Azure-datorer. Information om virtuella Azure-datorer finns i följande översiktsartikel om VM-tillägg.

Förutsättningar

Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.
- Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.
- När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.
- Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Installera Azure CLI-tillägget

ConnectedMachine-kommandona 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 tillägget ConnectedMachine. Dessa hanteringsåtgärder kan utföras från din arbetsstation. Du behöver inte köra dem på den Azure Arc-aktiverade servern.

Kör följande kommando för att hämta det:

az extension add --name connectedmachine

Aktivera tillägg

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

I följande exempel aktiveras Log Analytics VM-tillägget på en Azure Arc-aktiverad server:

az connectedmachine extension create --machine-name "myMachineName" --name "OmsAgentForLinux or MicrosoftMonitoringAgent" --location "regionName" --settings '{\"workspaceId\":\"myWorkspaceId\"}' --protected-settings '{\"workspaceKey\":\"myWorkspaceKey\"}' --resource-group "myResourceGroup" --type-handler-version "1.13" --type "OmsAgentForLinux or MicrosoftMonitoringAgent" --publisher "Microsoft.EnterpriseCloud.Monitoring"

I följande exempel aktiveras 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"

I följande exempel aktiveras tillägget för den virtuella Key Vault-datorn 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" }}'

I följande exempel aktiveras 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\"}"'

I följande exempel aktiveras 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" }'

Listtillägg installerade

Om du vill hämta en lista över de virtuella datortilläggen på din Azure Arc-aktiverade server använder du az connectedmachine-tilläggslistan med parametrarna --machine-name och --resource-group .

Exempel:

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 ett 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",

Uppdateringstilläggskonfiguration

Vissa VM-tillägg kräver konfigurationsinställningar för att installera dem på den Arc-aktiverade servern, till exempel tillägget för anpassat skript och Log Analytics-agentens VM-tillägg. Om du vill uppgradera konfigurationen av ett tillägg använder du az connectedmachine-tilläggsuppdateringen.

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 med parametrarna --machine-name, --resource-groupoch --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 Arc-aktiverade servern i avbildningslistan Azure Portal eller kör az vm extension image list. Du kan ange flera tillägg i en enda uppgraderingsbegäran genom att ange en kommaavgränsad lista med tillägg som definieras av utgivaren och typen (avgränsade med en period) och målversionen för varje tillägg.

Om du vill uppgradera Log Analytics-agenttillägget för Windows som har en nyare version tillgänglig kör du följande kommando:

az connectedmachine upgrade-extension --machine-name "myMachineName" --resource-group "myResourceGroup" --extension-targets '{"Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent":{"targetVersion":"1.0.18053.0"}}'

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.

Ta bort tillägg

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

Om du till exempel vill ta bort Log Analytics VM-tillägget för Linux kör du följande kommando:

az connectedmachine extension delete --machine-name "myMachineName" --name "OmsAgentForLinux" --resource-group "myResourceGroup"

Nästa steg

Du kan distribuera, hantera och ta bort VM-tillägg med hjälp av Azure PowerShell, från mallarna Azure Portal eller Azure Resource Manager.
Felsökningsinformation finns i guiden Felsöka VM-tillägg.
Mer information om kommandona finns i artikeln Översikt över azure CLI VM-tillägget.

Dela via