다음을 통해 공유

Azure CLI를 사용하여 Azure VM 확장 사용

  • 아티클

이 문서에서는 Azure Arc 지원 서버에서 지원하는 VM(가상 머신) 확장을 배포, 업그레이드, 업데이트 및 제거하는 방법을 설명합니다. Azure CLI를 사용하여 Linux 또는 Windows 하이브리드 머신에서 이러한 작업을 수행하는 방법을 보여 줍니다.

참고 항목

Azure Arc 지원 서버는 Azure 가상 머신에 VM 확장 배포 및 관리를 지원하지 않습니다. Azure VM의 경우 VM 확장 개요 문서를 참조하세요.

필수 조건

Azure CLI 확장 설치

ConnectedMachine 명령은 Azure CLI의 일부로 제공되지 않습니다. Azure CLI를 사용하여 Azure에 연결하고 Azure Arc 지원 서버에서 관리하는 하이브리드 서버에서 VM 확장을 관리하기 전에 ConnectedMachine 확장을 로드해야 합니다.

워크스테이션에서 이러한 관리 작업을 수행할 수 있습니다. Azure Arc 지원 서버에서 실행할 필요가 없습니다.

다음 명령을 실행하여 Azure CLI ConnectedMachine 확장을 설치합니다.

az extension add --name connectedmachine

확장 사용

Azure Arc 지원 서버에서 VM 확장을 사용하도록 설정하려면 , , , --type및 매개 변수와 --publisher 함께 --machine-name사용합니다az connectedmachine extension create. settings--location--extension-name

다음 예제에서는 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 Arc 지원 서버에서 Azure Key Vault VM 확장을 사용하도록 설정합니다.

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

다음 예에서는 Azure Arc 지원 Windows 서버에서 Microsoft Antimalware 확장을 사용하도록 설정합니다.

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

다음 예제에서는 Azure Arc 지원 Windows 서버에서 Datadog 확장을 사용하도록 설정합니다.

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

설치된 확장 나열

Azure Arc 지원 서버에서 VM 확장 목록을 얻으려면 해당 및 --resource-group 매개 변수를 --machine-name 사용합니다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 수도 있습니다.

다음 예제에서는 az connectedmachine extension -list 명령에서의 부분 JSON 출력을 표시합니다.

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

확장 구성 업데이트

일부 VM 확장에는 구성 설정이 필요하므로 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"

확장 업그레이드

지원되는 VM 확장의 새 버전이 릴리스되면 해당 최신 릴리스로 업그레이드할 수 있습니다. VM 확장을 업그레이드하려면 , --resource-group및 매개 변수와 --extension-targets 함께 --machine-name사용합니다az connectedmachine upgrade-extension.

--extension-targets 매개 변수의 경우 확장과 사용 가능한 최신 버전을 지정해야 합니다. 확장에 사용할 수 있는 최신 버전을 확인하려면 Azure Portal에서 선택한 Azure Arc 지원 서버의 확장 페이지로 이동하거나 az vm extension image list를 실행합니다. 다음을 모두 제공하여 단일 업그레이드 요청에서 여러 확장을 지정할 수 있습니다.

  • 게시자와 형식으로 정의된 쉼표로 구분된 확장 목록(마침표로 구분)
  • 각 확장의 대상 버전

명령을 az connectedmachine extension list실행하여 설치된 VM 확장의 버전을 언제든지 검토할 수 있습니다. typeHandlerVersion 속성 값은 확장의 버전을 나타냅니다.

확장 제거

Azure Arc 지원 서버에서 설치된 VM 확장을 제거하려면 , --machine-name및 매개 변수와 --resource-group 함께 --extension-name사용합니다az connectedmachine extension delete.

관련 콘텐츠