Azure Arc-extensiebeheer in Azure Stack HCI

Van toepassing op: Azure Stack HCI, versies 23H2 en 22H2

In dit artikel wordt beschreven hoe u Azure Arc-extensies installeert, upgradet en beheert op Azure Stack HCI-servermachines.

Door de klant beheerde Azure Arc-extensies op Azure Stack HCI

Met Azure Stack HCI kunt u Azure Arc-extensies installeren, verwijderen en bijwerken op uw Azure Stack HCI-systemen. Met Azure Arc kunt u hybride services zoals bewaking en Windows Admin Center uitvoeren in de Azure Portal.

Dit zijn de afzonderlijke extensies die u kunt installeren en beheren.

• Azure Monitoring Agent
• Azure Site Recovery
• Windows Admin Center

Door Azure beheerde extensies in Azure Stack HCI

Zodra u uw nieuwe Azure Stack HCI-cluster hebt geregistreerd bij Azure, worden door Azure beheerde extensies automatisch geïnstalleerd op uw cluster. Deze extensies zijn essentieel voor de functionaliteit en kwaliteit van uw systeem en kunnen niet worden verwijderd. U kunt het gedrag van deze extensies in de Azure Portal beheren door naar de pagina Extensies te navigeren en het menu Instellingen te selecteren.

Als u een bestaand Azure Stack HCI-cluster hebt dat is geregistreerd bij Azure zonder deze extensies, wordt een banner weergegeven op de pagina Overzicht of Extensies in de Azure Portal. U kunt de informatie in de banner gebruiken om u te helpen bij het installeren van deze extensies.

Dit zijn de door Azure beheerde extensies:

• Telemetrie en diagnostische gegevens
• Arc-extensie voor externe ondersteuning

Een extensie installeren

Azure-portal

U kunt extensies installeren via het tabblad Mogelijkheden voor uw Azure Stack HCI Arc-servers, zoals wordt weergegeven in de schermafbeelding. U kunt het tabblad Mogelijkheden gebruiken om de meeste extensies te installeren.

Wanneer u een extensie in de Azure Portal installeert, is dit een clusterbewuste bewerking. De extensie wordt geïnstalleerd op alle servers van het cluster. Als u meer servers aan uw cluster toevoegt, worden alle extensies die op uw cluster zijn geïnstalleerd, automatisch toegevoegd aan de nieuwe servers.

Azure-CLI

Azure CLI is beschikbaar voor installatie in Windows-, macOS- en Linux-omgevingen. Het kan ook worden uitgevoerd in Azure Cloud Shell. Raadpleeg Quickstart voor Azure Cloud Shell voor meer informatie.

Start Azure Cloud Shell en gebruik Bash om een extensie te installeren door de volgende stappen uit te voeren:

1. Parameters instellen vanuit uw abonnement, resourcegroep en clusters

   subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   resourceGroup="hcicluster-rg" # Replace with your resource group name
   
   az account set --subscription "${subscription}"
   
   clusters=($(az graph query -q "resources | where type == 'microsoft.azurestackhci/clusters'| where resourceGroup =~ '${resourceGroup}' | project name" | jq -r '.data[].name'))
   

2. Voer de volgende opdracht uit om de extensie Windows Admin Center te installeren op alle clusters onder de resourcegroep:

   extensionName="AdminCenter"
   extensionType="AdminCenter"
   extensionPublisher="Microsoft.AdminCenter"
   settingsConfig="{'port':'6516'}"
   connectivityProps="{enabled:true}"
   
   for cluster in ${clusters}; do
       echo "Enabling Connectivity for cluster $currentCluster"
       az stack-hci arc-setting update \
           --resource-group ${resourceGroup} \
           --cluster-name ${cluster} \
           --name "default" \
           --connectivity-properties ${connectivityProps}
   
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}" \
           --settings "${settingsConfig}"
   done
   

3. Voer de volgende opdracht uit om de Azure Monitor-agentextensie te installeren op alle clusters onder de resourcegroep:

   extensionName="AzureMonitorWindowsAgent"
   extensionType="AzureMonitorWindowsAgent"
   extensionPublisher="Microsoft.Azure.Monitor"
   
   for cluster in ${clusters}; do
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
   
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}"
   done
   

4. Voer de volgende opdracht uit om de Azure Site Recovery-extensie te installeren op alle clusters onder de resourcegroep:

   asrSubscription="00000000-0000-0000-0000-000000000000" # Replace with your ASR subscription ID
   asrResourceGroup="asr-rg" # Replace with your ASR resource group
   asrVaultName="asr-vault" # Replace with your ASR vault name
   asrLocation="East US" # Replace with your ASR Location
   asrSiteId="00000000-0000-0000-0000-000000000000" # Replace with your ASR Site ID
   asrSiteName="asr-site" # Replace with your Site Name
   asrSitePolicyId="/subscriptions/${asrSubscription}/resourceGroups/${asrResourceGroup}/providers/Microsoft.RecoveryServices/vaults/${asrVaultName}/replicationPolicies/s-cluster-policy" # Replace with your Site Policy name
   
   extensionName="ASRExtension"
   extensionType="Windows"
   extensionPublisher="Microsoft.SiteRecovery.Dra"
   jsonFile="./tmp-asr.json" #Temp JSON file
   
   echo "{\"SubscriptionId\": \"${asrSubscription}\", \"Environment\": \"AzureCloud\",\"ResourceGroup\": \"${asrResourceGroup}\",\"Location\": \"${asrLocation}\",\"SiteId\": \"${asrSiteId}\", \"SiteName\": \"${asrSiteName}\", \"PolicyId\": \"${asrSitePolicyId}\", \"PrivateEndpointStateForSiteRecovery\": \"None\" }" > ${jsonFile}
   
   for cluster in ${clusters}; do
       echo "Installing extension: ${extensionName} on cluster: ${cluster}"
   
       az stack-hci extension create \
           --arc-setting-name "default" \
           --cluster-name "${cluster}" \
           --resource-group "${resourceGroup}" \
           --name "${extensionName}" \
           --auto-upgrade "true" \
           --publisher "${extensionPublisher}" \
           --type "${extensionType}" \
           --settings "${jsonFile}"
   done
   

Azure PowerShell

Azure PowerShell kan worden uitgevoerd in Azure Cloud Shell. In dit document wordt beschreven hoe u PowerShell gebruikt in Azure Cloud Shell. Raadpleeg Quickstart voor Azure Cloud Shell voor meer informatie.

Start Azure Cloud Shell en gebruik PowerShell om een extensie te installeren door de volgende stappen uit te voeren:

1. Stel parameters in van uw abonnement, resourcegroep en clusters:

   $subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   $resourceGroup = "hcicluster-rg" # Replace with your resource group name
   
   Set-AzContext -Subscription "${subscription}"
   $clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name
   

2. Voer de volgende opdracht uit om de extensie Windows Admin Center te installeren op alle clusters onder de resourcegroep:

   $extensionName = "AdminCenter"
   $extensionType = "AdminCenter"
   $extensionPublisher = "Microsoft.AdminCenter"
   $settingsConfig = @{"port" = 6516 }
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Enable connectivity for cluster ${clusterName}")
       Invoke-AzRestMethod `
           -Method PATCH `
           -SubscriptionId ${subscription} `
           -ResourceGroupName ${resourceGroup} `
           -ResourceProviderName "Microsoft.AzureStackHCI" `
           -ResourceType ("clusters/" + ${clusterName} + "/arcSettings") `
           -Name "default" `
           -ApiVersion "2023-02-01" `
           -Payload (@{"properties" = @{ "connectivityProperties" = @{ "enabled" = $true } } } | ConvertTo-Json -Depth 5)
   
   
       Write-Output ("Installing Extension '${extensionName}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}" `
           -ExtensionParameterSetting ${settingsConfig} `
           -NoWait
   }
   

3. Voer de volgende opdracht uit om de Azure Monitor-agentextensie te installeren op alle clusters onder de resourcegroep:

   $extensionName = "AzureMonitorWindowsAgent"
   $extensionType = "AzureMonitorWindowsAgent"
   $extensionPublisher = "Microsoft.Azure.Monitor"
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}"
   }
   

4. Als u de Extensie Azure Site Recovery wilt installeren op alle clusters onder de resourcegroep, maakt u een JSON-parameterbestand en voert u de volgende opdracht uit:

   $settings = @{
       SubscriptionId = "<Replace with your Subscription Id>"
       Environment = "<Replace with the cloud environment type. For example: AzureCloud>"
       ResourceGroup = "<Replace with your Site Recovery Vault resource group>"
       ResourceName = "<Replace with your Site Recovery Vault Name>"
       Location = "<Replace with your Site Recovery Azure Region>"
       SiteId = "<Replace with the ID of your recovery site>"
       SiteName = "<Replace with your recovery site name>"
       PolicyId = "<Replace with resource ID of your recovery site policy>"
       PrivateEndpointStateForSiteRecovery = "None"
   }
   
   $extensionName = "ASRExtension"
   $extensionType = "Windows"
   $extensionPublisher = "Microsoft.SiteRecovery.Dra"
   
   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
   
       Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")
   
       New-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default" `
           -Name "${extensionName}" `
           -ExtensionParameterPublisher "${extensionPublisher}" `
           -ExtensionParameterType "${extensionType}" `
           -ExtensionParameterSetting ${settings} `
           -NoWait
   }
   

De extensiestatus controleren

Azure-portal

U kunt de status van een extensie op elke server controleren op de pagina Extensies door de statuskolom van het raster te bekijken.

Azure-CLI

Azure CLI is beschikbaar voor installatie in Windows-, macOS- en Linux-omgevingen. Het kan ook worden uitgevoerd in Azure Cloud Shell. Raadpleeg Quickstart voor Azure Cloud Shell voor meer informatie.

Start Azure Cloud Shell en gebruik Bash om de status van een extensie te controleren door de volgende stappen uit te voeren:

1. Parameters instellen vanuit uw abonnement, resourcegroep, clusternaam en extensienaam

   subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   resourceGroup="hcicluster-rg" # Replace with your resource group name
   clusterName="HCICluster" # Replace with your cluster name
   extensionName="AzureMonitorWindowsAgent" # Replace with the extension name
   
   az account set --subscription "${subscription}"
   

2. Voer de volgende opdracht uit om alle extensies in een cluster weer te geven:

   az stack-hci extension list \
   --arc-setting-name "default" \
   --cluster-name "${clusterName}" \
   --resource-group "${resourceGroup}" \
   -o table
   

3. Als u een specifieke extensie wilt filteren, zoals AzureMonitorWindowsAgent, voert u de volgende opdracht uit:

   az stack-hci extension list \
   --arc-setting-name "default" \
   --cluster-name "${clusterName}" \
   --resource-group "${resourceGroup}" \
   --query "[?name=='${extensionName}'].{Name:name, ManagedBy:managedBy, ProvisionStatus:provisioningState, State:aggregateState, Type:extensionParameters.type}" \
   -o table
   

Azure PowerShell

Azure PowerShell kan worden uitgevoerd in Azure Cloud Shell. In dit document wordt beschreven hoe u PowerShell gebruikt in Azure Cloud Shell. Raadpleeg Quickstart voor Azure Cloud Shell voor meer informatie.

Start Azure Cloud Shell en gebruik PowerShell om de status van een extensie te controleren door de volgende stappen uit te voeren:

1. Parameters instellen vanuit uw abonnement, resourcegroep en clusternaam

   $subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
   $resourceGroup = "hcicluster-rg" # Replace with your resource group name
   
   Set-AzContext -Subscription "${subscription}"
   $clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name
   

2. Voer de volgende opdracht uit om alle extensies in een cluster weer te geven:

   foreach ($cluster in $clusters) {
       $clusterName = ${cluster}.Name
       Get-AzStackHciExtension `
           -ClusterName "${clusterName}" `
           -ResourceGroupName "${resourceGroup}" `
           -ArcSettingName "default"|Format-Table -Property Name, ParameterType, ParameterPublisher, ParameterEnableAutomaticUpgrade, ProvisioningState
   }
   

Hoe de extensie-upgrade werkt

Wanneer deze wordt gepubliceerd door het extensie-uitgeversteam, vervangt het upgradeproces van de extensie de bestaande extensieversie door een nieuw ondersteunde versie. De functie voor automatische uitbreidingsupgrade is standaard ingeschakeld voor alle extensies die zijn geïmplementeerd op clusters met Azure Stack HCI Arc, tenzij u zich expliciet afmeldt voor automatische upgrades.

Op dit moment worden automatische uitbreidingsupgrades alleen ondersteund in de Windows Admin Center extensie, maar in de toekomst worden er meer extensies toegevoegd.

Notitie

Standaard zijn alle extensies zo ingesteld dat automatische upgrades worden ingeschakeld, zelfs als een extensie de automatische uitbreidingsupgrade niet ondersteunt. Deze standaardinstelling heeft echter geen effect totdat de uitgever van de extensie ervoor kiest automatische uitbreidingsupgrade te ondersteunen.

Automatische uitbreidingsupgrade inschakelen

Azure-portal

Voor sommige extensies kunt u automatische upgrades inschakelen via extensiebeheer.

Als u een automatische upgrade wilt inschakelen, gaat u naar de pagina Extensies en voert u de volgende stappen uit:

1. Kies de extensie waarvoor u automatische upgrade wilt inschakelen.

2. Selecteer Automatische upgrade inschakelen in het bovenste menu

   

3. Wanneer u wordt gevraagd om uw intentie te bevestigen, selecteert u OK.

   

Azure-CLI

Als u automatisch upgraden voor een specifieke extensie wilt installeren en inschakelen, voert AzureMonitorWindowsAgent u de volgende opdracht uit:

clusterName="HCICluster" # Replace with your cluster name
resourceGroup="hcicluster-rg" # Replace with your resource group name

extensionName="AzureMonitorWindowsAgent"
extensionPublisher="Microsoft.Azure.Monitor"
extensionType="AzureMonitorWindowsAgent"

az stack-hci extension create \
    --name "${extensionName}" \
    --arc-setting-name "default" \
    --cluster-name "${clusterName}" \
    --resource-group "${resourceGroup}" \
    --publisher ${extensionPublisher} \
    --type ${extensionType} \
    --auto-upgrade "true"

Azure PowerShell

Als u automatisch upgraden voor een specifieke extensie wilt installeren en inschakelen, voert AzureMonitorWindowsAgent u de volgende opdracht uit:

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"
$extensionType = "AzureMonitorWindowsAgent"
$extensionPublisher = "Microsoft.Azure.Monitor"

New-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}" `
    -ExtensionParameterPublisher "${extensionPublisher}" `
    -ExtensionParameterType "${extensionType}" `
    -ExtensionParameterEnableAutomaticUpgrade

Handmatige extensie-upgrade via de Azure Portal

De handmatige uitbreidingsupgrade werkt net als de automatische extensie-upgrade. Wanneer u in een cluster met Azure Stack HCI Arc handmatig een upgrade uitvoert voor een extensie, slaat Azure de geselecteerde versie op. Azure probeert vervolgens de extensie op alle servers in het cluster bij te werken naar die versie.

Als op sommige servers de upgrade van de extensie mislukt, probeert het platform tijdens de volgende Azure Stack HCI-cloudsynchronisatie een upgrade uit te voeren naar de geselecteerde versie.

Gebruik de handmatige werkstroom in deze scenario's:

• Er is een nieuwe versie van de extensie beschikbaar en u wilt deze handmatig upgraden.

• De optie voor automatische upgrade van de extensie is uitgeschakeld en er is een versie die niet overeenkomt op verschillende servers van het Azure Stack HCI-cluster.

Voer de volgende stappen uit om een extensie handmatig te upgraden:

1. Ga naar de pagina Extensies .

2. Kies de extensie die u wilt upgraden en selecteer Instellingen in het bovenste menu.

   

3. Kies de nieuwste versie en selecteer Opslaan.

Automatische uitbreidingsupgrade uitschakelen

U kunt automatische upgrades uitschakelen voor bepaalde extensies in de Azure Portal. Als u automatische upgrades wilt uitschakelen, gaat u naar de pagina Extensies en voert u de volgende stappen uit:

1. Kies de extensie waarvoor u de automatische upgrade wilt uitschakelen.

2. Selecteer Automatische upgrade uitschakelen in het bovenste menu.

   

3. Wanneer u wordt gevraagd om uw intentie te bevestigen, selecteert u OK.

   

De upgradegeschiedenis van de extensie controleren

U kunt het tabblad Activiteitenlogboek weergeven op afzonderlijke azure Arc-serverresources, resourcegroepen en abonnementen om de geschiedenis van automatische uitbreidingsupgrades voor afzonderlijke clusterservers te controleren. Zie Geschiedenis van automatische uitbreidingsupgrade controleren voor meer informatie.

Beschikbaarheid-eerste updates

Voor een groep clusters met Azure Stack HCI Arc die een upgrade ondergingen, heeft het Azure-platform het model Automatische extensie-upgrade gebruikt om upgrades te organiseren.

Timing van automatische uitbreidingsupgrades

Wanneer een nieuwe versie van een ondersteunde extensie wordt gepubliceerd, wordt deze beschikbaar voor installatie en handmatige upgrade op servers met Azure Arc. Upgrades worden in batches uitgegeven in Azure-regio's en -abonnementen, dus mogelijk ziet u dat er op sommige servers een extensie-upgrade wordt uitgevoerd vóór op andere servers. Zie Timing van automatische uitbreidingsupgrades voor meer informatie.

Als u een extensie onmiddellijk wilt upgraden, raadpleegt u Handmatig upgraden via de Azure Portal.

Automatisch terugdraaien en nieuwe pogingen

Als een extensie-upgrade mislukt, voert Azure de acties uit die zijn gekoppeld aan automatisch terugdraaien en probeert opnieuw om de extensie te herstellen.

Als u problemen blijft ondervinden met een extensie-upgrade, kunt u de automatische extensie-upgrade uitschakelen. Wanneer u de automatische upgrade uitschakelt, voorkomt u dat het systeem opnieuw wordt geprobeerd terwijl u het probleem oplost. U kunt de automatische uitbreidingsupgrade opnieuw inschakelen wanneer u klaar bent.

Upgrades met meerdere extensies

Als er meerdere uitbreidingsupgrades beschikbaar zijn voor een computer, kunnen ze in batches worden uitgevoerd. Elke uitbreidingsupgrade wordt echter afzonderlijk op de computer toegepast. Zie Uitbreidingsupgrades met meerdere extensies voor meer informatie.

Een extensie verwijderen

Azure-portal

Indien gewenst kunt u enkele extensies verwijderen uit uw Azure Stack HCI-clusters in de Azure Portal. Voer de volgende stappen uit om een extensie te verwijderen:

1. Ga naar de pagina Extensies.

2. Kies de extensie die u wilt verwijderen. De knop Verwijderen is niet beschikbaar voor door Azure beheerde extensies.

   

3. Selecteer Verwijderen in het bovenste menu.

4. Bevestig de intentie en selecteer Ja.

   

Azure-CLI

Voer de volgende opdracht uit om een specifieke extensie AzureMonitorWindowsAgent te verwijderen:

extensionName="AzureMonitorWindowsAgent" # Replace with the extension name
resourceGroup="hcicluster-rg" # Replace with your resource group name
clusterName="HCICluster" # Replace with your cluster name

az stack-hci extension delete \
--arc-setting-name "default" \
--name "${extensionName}" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}"

Azure PowerShell

Voer de volgende opdracht uit om een specifieke extensie AzureMonitorWindowsAgent te verwijderen:

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"

Remove-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}"

Problemen met extensiefouten oplossen

Extensiestatus: Mislukt

Aanbeveling: voor een extensie met de status Mislukt selecteert u de koppeling Mislukt (Details weergeven). Bekijk alle informatie over de fout en pas de tips voor probleemoplossing toe.

Volgende stap

Meer informatie over het beheer van virtuele-machine-extensies met servers met Azure Arc.