Azure VM-extensies inschakelen met behulp van Azure PowerShell

In dit artikel wordt uitgelegd hoe u extensies voor virtuele machines (VM's) implementeert, bijwerkt en verwijdert op servers met Azure Arc met behulp van Azure PowerShell.

Vereiste voorwaarden

• Een computer met Azure PowerShell. Zie Azure PowerShell installeren en configureren voor instructies.

• De Az.ConnectedMachine module. Voordat u Azure PowerShell gebruikt om VM-extensies te beheren op uw hybride server die wordt beheerd door servers met Azure Arc, moet u deze module installeren.

  U kunt deze beheerbewerkingen uitvoeren vanaf uw werkstation in plaats van op de server met Azure Arc.

  Voer de volgende opdracht uit om de Az.ConnectedMachine module te installeren:

  Install-Module -Name Az.ConnectedMachine
  

Een extensie inschakelen

Om een VM-extensie op uw Azure Arc-ingeschakelde server in te schakelen, gebruik New-AzConnectedMachineExtension met de -Name, -ResourceGroupName, -MachineName, -Location, -Publisher, -ExtensionType en -Settings parameters.

In dit voorbeeld wordt de aangepaste scriptextensie ingeschakeld op een server met 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

In dit voorbeeld wordt de Microsoft Antimalware-extensie ingeschakeld op een Windows-server met Azure Arc:

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

In dit voorbeeld wordt de Key Vault-VM-extensie ingeschakeld op een server met Azure Arc:

# 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

In dit voorbeeld wordt de Datadog VM-extensie ingeschakeld op een server met Azure Arc:

$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

Toon geïnstalleerde extensies

Om een lijst van de VM-extensies op uw Azure Arc-ingeschakelde server op te halen, gebruikt u Get-AzConnectedMachineExtension met de parameters -MachineName en -ResourceGroupName.

Get-AzConnectedMachineExtension -ResourceGroupName myResourceGroup -MachineName myMachineName

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

Werk een extensieconfiguratie bij

Om een geïnstalleerde extensie opnieuw te configureren, kunt u de Update-AzConnectedMachineExtension cmdlet gebruiken met de -Name, -MachineName, -ResourceGroupName, en -Settings parameters.

Zie Update-AzConnectedMachineExtension voor meer informatie.

Extensies upgraden

Wanneer een nieuwe versie van een ondersteunde VM-extensie wordt vrijgegeven, kunt u upgraden naar die nieuwste release. Als u een VM-extensie wilt upgraden, gebruikt u Update-AzConnectedExtension met de parameters -MachineName, -ResourceGroupName en -ExtensionTarget.

Voor de -ExtensionTarget parameter moet u de extensie en de nieuwste beschikbare versie specificeren. Om de nieuwste beschikbare versie van een extensie te bepalen, ga naar de pagina Extensies voor de geselecteerde Azure Arc-ingeschakelde server in de Azure-portal of voer Get-AzVMExtensionImage uit. Je kunt meerdere extensies in een enkele upgradeverzoek specificeren door beide te verstrekken.

• Een komma-gescheiden lijst van extensies, gedefinieerd door hun uitgever en type (gescheiden door een punt)
• De doelversie voor elke extensie

U kunt de versie van geïnstalleerde VM-extensies op elk gewenst moment controleren door de opdracht Get-AzConnectedMachineExtensionuit te voeren. De TypeHandlerVersion eigenschapswaarde vertegenwoordigt de versie van de extensie.

Extensies verwijderen

Om een geïnstalleerde VM-extensie op uw Azure Arc-ingeschakelde server te verwijderen, gebruikt u Remove-AzConnectedMachineExtension met de parameters -Name, -MachineName en -ResourceGroupName.

Gerelateerde inhoud

• Vm-extensies implementeren, beheren en verwijderen met behulp van de Azure CLI, Azure Portal of Azure Resource Manager-sjablonen.
• Zoek informatie over probleemoplossing in de handleiding voor het oplossen van problemen met VM-extensies.