다음을 통해 공유

Azure CLI(Windows 및 Linux)를 사용하여 Azure VM 확장 사용

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

필수 구성 요소

Azure CLI에 Connected Machine 확장 설치

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

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

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

az extension add --name connectedmachine

확장 사용

Azure Arc 지원 서버에서 VM 확장을 사용하도록 설정하려면 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 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 맬웨어 방지 확장을 사용하도록 설정합니다.

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

팁 (조언)

다른 많은 확장은 Arc 지원 서버에서 지원됩니다. 자세한 내용은 Azure Arc 지원 서버를 사용한 가상 머신 확장 관리를 참조하세요.

설치된 확장 나열

Azure Arc 지원 서버에서 VM 확장 목록을 얻으려면 az connectedmachine extension list를 --machine-name 및 --resource-group 매개 변수와 함께 사용하십시오.

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 확장을 업그레이드하려면 az connectedmachine upgrade-extension을 --machine-name, --resource-group, --extension-targets 매개 변수와 함께 사용합니다.

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

  • 게시자 및 형식(마침표로 구분)에 따라 정의된 확장명의 쉼표로 구분된 목록
  • 각 확장에 대한 대상 버전

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

팁 (조언)

자동 업그레이드를 위해 많은 VM 확장을 구성할 수 있습니다.

확장 제거

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

관련 콘텐츠

  • Last updated on