Udostępnij za pośrednictwem

Włączanie rozszerzeń maszyn wirtualnych platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure

  • Artykuł

W tym artykule opisano sposób wdrażania, uaktualniania, aktualizowania i odinstalowywania rozszerzeń maszyn wirtualnych obsługiwanych przez serwery z obsługą usługi Azure Arc. Przedstawiono w nim sposób wykonywania tych zadań na maszynie hybrydowej z systemem Linux lub Windows przy użyciu interfejsu wiersza polecenia platformy Azure.

Uwaga

Serwery z obsługą usługi Azure Arc nie obsługują wdrażania rozszerzeń maszyn wirtualnych platformy Azure i zarządzania nimi na maszynach wirtualnych platformy Azure. Aby zapoznać się z maszynami wirtualnymi platformy Azure, zobacz artykuł Omówienie rozszerzenia maszyny wirtualnej.

Wymagania wstępne

Instalowanie rozszerzenia interfejsu wiersza polecenia platformy Azure

Polecenia ConnectedMachine nie są dostarczane w ramach interfejsu wiersza polecenia platformy Azure. Przed użyciem interfejsu wiersza polecenia platformy Azure do nawiązania połączenia z platformą Azure i zarządzania rozszerzeniami maszyn wirtualnych na serwerze hybrydowym zarządzanym przez serwery z obsługą usługi Azure Arc należy załadować rozszerzenie ConnectedMachine.

Te operacje zarządzania można wykonać na stacji roboczej. Nie trzeba ich uruchamiać na serwerze z obsługą usługi Azure Arc.

Uruchom następujące polecenie, aby zainstalować rozszerzenie ConnectedMachine interfejsu wiersza polecenia platformy Azure:

az extension add --name connectedmachine

Włączanie rozszerzenia

Aby włączyć rozszerzenie maszyny wirtualnej na serwerze z obsługą usługi Azure Arc, użyj parametrów az connectedmachine extension create --machine-name, , --location--extension-name, --type, settingsi --publisher .

Poniższy przykład umożliwia rozszerzenie niestandardowego skryptu na serwerze z obsługą usługi 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"

Poniższy przykład umożliwia rozszerzenie maszyny wirtualnej usługi Azure Key Vault na serwerze z obsługą usługi 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" }}'

Poniższy przykład umożliwia rozszerzenie Microsoft Antimalware na serwerze z systemem Windows z obsługą usługi 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\"}"'

Poniższy przykład umożliwia rozszerzenie Datadog na serwerze z systemem Windows z obsługą usługi 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" }'

Lista zainstalowanych rozszerzeń

Aby uzyskać listę rozszerzeń maszyn wirtualnych na serwerze z obsługą usługi Azure Arc, użyj parametrów az connectedmachine extension list --machine-name i --resource-group .

Oto przykład:

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

Domyślnie dane wyjściowe poleceń interfejsu wiersza polecenia platformy Azure są w formacie JSON (JavaScript Object Notation). Aby zmienić domyślne dane wyjściowe na listę lub tabelę, na przykład użyj polecenia az config set core.output=table. Można również dodać --output do dowolnego polecenia jednorazowej zmiany w formacie danych wyjściowych.

Poniższy przykład przedstawia częściowe dane wyjściowe JSON z az connectedmachine extension -list polecenia :

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

Aktualizowanie konfiguracji rozszerzenia

Niektóre rozszerzenia maszyn wirtualnych wymagają ustawień konfiguracji, aby można je było zainstalować na serwerze z obsługą usługi Azure Arc (na przykład rozszerzenie niestandardowego skryptu). Aby uaktualnić konfigurację rozszerzenia, użyj polecenia az connectedmachine extension update.

W poniższym przykładzie pokazano, jak skonfigurować rozszerzenie niestandardowego skryptu:

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"

Uaktualnianie rozszerzeń

Po wydaniu nowej wersji obsługiwanego rozszerzenia maszyny wirtualnej można uaktualnić ją do tej najnowszej wersji. Aby uaktualnić rozszerzenie maszyny wirtualnej, użyj parametrów az connectedmachine upgrade-extension --machine-name, --resource-groupi --extension-targets .

Dla parametru --extension-targets należy określić rozszerzenie i najnowszą dostępną wersję. Aby określić najnowszą wersję dostępną dla rozszerzenia, przejdź do strony Rozszerzenia wybranego serwera z obsługą usługi Azure Arc w witrynie Azure Portal lub uruchom polecenie az vm extension image list. Możesz określić wiele rozszerzeń w jednym żądaniu uaktualnienia, podając oba te rozszerzenia:

  • Rozdzielona przecinkami lista rozszerzeń zdefiniowana przez wydawcę i typ (oddzielona kropką)
  • Wersja docelowa dla każdego rozszerzenia

Możesz przejrzeć wersję zainstalowanych rozszerzeń maszyn wirtualnych w dowolnym momencie, uruchamiając polecenie az connectedmachine extension list. Wartość typeHandlerVersion właściwości reprezentuje wersję rozszerzenia.

Usuwanie rozszerzeń

Aby usunąć zainstalowane rozszerzenie maszyny wirtualnej z serwera z obsługą usługi Azure Arc, użyj parametrów az connectedmachine extension delete --extension-name, --machine-namei --resource-group .

Powiązana zawartość