Поделиться через

Включите расширения Azure VM с помощью Azure CLI

В этой статье объясняется, как развертывать, обновлять, обновлять и удалять расширения виртуальных машин на серверах с поддержкой Azure Arc с помощью Azure CLI.

Предпосылки

Установите расширение Azure CLI

Команды ConnectedMachine не поставляются в составе Azure CLI. Прежде чем использовать Azure CLI для подключения к Azure и управления расширениями виртуальных машин на гибридном сервере, управляемом серверами с поддержкой Azure Arc, необходимо загрузить ConnectedMachine расширение.

Эти операции управления можно выполнять с рабочей станции, а не на сервере с поддержкой Azure Arc.

Выполните следующую команду, чтобы установить расширение Azure CLI ConnectedMachine :

az extension add --name connectedmachine

Включить расширение

Чтобы включить расширение виртуальной машины на сервере с поддержкой Azure Arc, используйте az connectedmachine extension create с параметрами --machine-name, --extension-name, --location, --type, settings и --publisher.

В этом примере включено расширение пользовательского скрипта на сервере с поддержкой 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"

В этом примере включено расширение виртуальной машины Azure Key Vault на сервере с поддержкой 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" }}'

Этот пример включает расширение Защиты от вредоносных программ Майкрософт на сервере Windows с поддержкой 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\"}"'

Этот пример включает расширение Datadog на сервере Windows с поддержкой 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" }'

Подсказка

Многие другие расширения поддерживаются на серверах с поддержкой Arc. Дополнительные сведения см. в разделе "Управление расширениями виртуальных машин с серверами с поддержкой Azure Arc".

Список установленных расширений

Чтобы получить список расширений виртуальных машин на сервере с поддержкой Azure Arc, используйте параметры --machine-name и --resource-group с az connectedmachine extension list.

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

По умолчанию выходные данные команд Azure CLI в формате JSON (JavaScript Object Notation). Чтобы изменить стандартный вывод на список или таблицу, например, используйте az config set core.output=table. Вы также можете добавить --output к любой команде для однократного изменения формата вывода.

Следующий пример показывает частичный JSON вывод команды az connectedmachine extension -list:

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

Обновить конфигурацию расширения

Для некоторых расширений виртуальных машин требуются параметры конфигурации, чтобы их можно было установить на сервере с поддержкой Azure Arc (например, расширение пользовательского скрипта). Чтобы обновить конфигурацию расширения, используйте az connectedmachine extension update.

В следующем примере показано, как настроить расширение пользовательского скрипта:

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"

Обновить расширения

При выпуске новой версии поддерживаемого расширения виртуальной машины его можно обновить до последнего выпуска. Чтобы обновить расширение виртуальной машины, используйте az connectedmachine upgrade-extension с параметрами --machine-name, --resource-group и --extension-targets.

Для параметра --extension-targets необходимо указать расширение и последнюю доступную версию. Чтобы определить последнюю доступную версию расширения, перейдите на страницу Extensions для выбранного сервера с поддержкой Azure Arc в портале Azure или выполните команду az vm extension image list. Вы можете указать несколько расширений в одном запросе на обновление, предоставив оба:

  • Список расширений, разделённый запятыми, определённый их издателем и типом (разделённый точкой)
  • Целевая версия для каждого расширения

Версию установленных расширений виртуальных машин можно просмотреть в любое время, выполнив команду az connectedmachine extension list. Значение свойства typeHandlerVersion представляет версию расширения.

Подсказка

Для автоматического обновления можно настроить множество расширений виртуальных машин.

Удалить расширения

Чтобы удалить установленное расширение ВМ с сервера, поддерживаемого Azure Arc, используйте az connectedmachine extension delete с параметрами --extension-name, --machine-name и --resource-group.

Связанный контент