다음을 통해 공유

Azure PowerShell을 사용하여 Azure VM 확장 사용

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

필수 조건

  • Azure PowerShell이 설치된 컴퓨터 자세한 내용은 Azure PowerShell 설치 및 구성을 참조하세요.

  • Az.ConnectedMachine 모듈. Azure PowerShell을 사용하여 Azure Arc 지원 서버에서 관리하는 하이브리드 서버에서 VM 확장을 관리하려면 이 모듈을 설치해야 합니다.

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

    다음 명령을 실행하여 Az.ConnectedMachine 모듈을 설치합니다.

    Install-Module -Name Az.ConnectedMachine

확장 사용

Azure Arc 지원 서버에서 VM 확장을 사용하도록 설정하려면 New-AzConnectedMachineExtension를 -Name, -ResourceGroupName, -MachineName, -Location, -Publisher 및 ExtensionType 매개 변수와 함께 사용합니다.

이 예제에서는 Azure Arc 지원 서버에서 사용자 지정 스크립트 확장을 사용하도록 설정합니다.

$Setting = @{ "commandToExecute" = "powershell.exe -c Get-Process" }
New-AzConnectedMachineExtension -Name "custom" -ResourceGroupName "myResourceGroup" -MachineName "myMachineName" -Location "regionName" -Publisher "Microsoft.Compute"  -Settings $Setting -ExtensionType CustomScriptExtension

이 예제에서는 Azure Arc 지원 Windows 서버에서 Microsoft 맬웨어 방지 확장을 사용하도록 설정합니다.

$Setting = @{ "AntimalwareEnabled" = $true }
New-AzConnectedMachineExtension -Name "IaaSAntimalware" -ResourceGroupName "myResourceGroup" -MachineName "myMachineName" -Location "regionName" -Publisher "Microsoft.Azure.Security" -Settings $Setting -ExtensionType "IaaSAntimalware"

이 예제에서는 Azure Arc 지원 서버에서 Key Vault VM 확장을 사용하도록 설정합니다.

경고

\을(를) settings.json 파일에 추가하면 "가 다음과 같은 오류가 발생하여 실패합니다: akvvm_service

PowerShell 사용자는 일반적으로 \" 시퀀스를 사용하여 다른 코드 블록에서 따옴표를 이스케이프하지만, settings.json 파일에서는 해당 서식을 사용하지 않아야 합니다.

# Build settings
    $settings = @{
      secretsManagementSettings = @{
       observedCertificates = @(
        "observedCert1"
       )
      certificateStoreLocation = "myMachineName" # For Linux use "/var/lib/waagent/Microsoft.Azure.KeyVault.Store/"
      certificateStore = "myCertificateStoreName"
      pollingIntervalInS = "pollingInterval"
      }
    authenticationSettings = @{
     msiEndpoint = "http://localhost:40342/metadata/identity"
     }
    }

    $resourceGroup = "resourceGroupName"
    $machineName = "myMachineName"
    $___location = "regionName"

    # Start the deployment
    New-AzConnectedMachineExtension -ResourceGroupName $resourceGroup -Location $___location -MachineName $machineName -Name "KeyVaultForWindows or KeyVaultforLinux" -Publisher "Microsoft.Azure.KeyVault" -ExtensionType "KeyVaultforWindows or KeyVaultforLinux" -Setting $settings

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

$resourceGroup = "resourceGroupName"
$machineName = "machineName"
$___location = "machineRegion"
$osType = "Windows" # change to Linux if appropriate
$settings = @{
    # change to your preferred Datadog site
    site = "us3.datadoghq.com"
}
$protectedSettings = @{
    # change to your Datadog API key
    api_key = "APIKEY"
}

New-AzConnectedMachineExtension -ResourceGroupName $resourceGroup -Location $___location -MachineName $machineName -Name "Datadog$($osType)Agent" -Publisher "Datadog.Agent" -ExtensionType "Datadog$($osType)Agent" -Setting $settings -ProtectedSetting $protectedSettings

팁 (조언)

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

설치된 확장 나열

Azure Arc 사용 서버에서 VM 확장 목록을 얻으려면 Get-AzConnectedMachineExtension 명령을 -MachineName 및 -ResourceGroupName 매개 변수와 함께 사용하세요.

Get-AzConnectedMachineExtension -ResourceGroupName myResourceGroup -MachineName myMachineName

Name    Location  PropertiesType        ProvisioningState
----    --------  --------------        -----------------
custom  westus2   CustomScriptExtension Succeeded

확장 구성 업데이트

설치된 확장을 다시 구성하려면 Update-AzConnectedMachineExtension, -Name, -MachineName, -ResourceGroupName 매개 변수를 사용하여 cmdlet을 실행할 수 있습니다.

자세한 내용은 Update-AzConnectedMachineExtension를 참조하세요.

확장을 업그레이드하다

지원되는 VM 확장의 새 버전이 릴리스되면 해당 최신 릴리스로 업그레이드할 수 있습니다. VM 확장을 업그레이드하려면 Update-AzConnectedExtension와 함께 -MachineName, -ResourceGroupName, -ExtensionTarget 매개 변수를 사용합니다.

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

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

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

팁 (조언)

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

확장 제거

Azure Arc 지원 서버에 설치된 VM 확장을 제거하려면 Remove-AzConnectedMachineExtension를 -Name, -MachineName, -ResourceGroupName 매개 변수와 함께 사용합니다.

관련 콘텐츠