Van toepassing op: Azure Local, versies 23H2 en 22H2
In dit artikel wordt beschreven hoe u Azure Arc-extensies installeert, upgradet en beheert in Azure Local.
Door de klant beheerde Azure Arc-extensies in Azure Local
U kunt Azure Arc-extensies installeren, verwijderen en bijwerken op uw lokale Azure-locatie. Met Azure Arc kunt u hybride services uitvoeren, zoals bewaking en Windows Admin Center in Azure Portal.
Hier volgen de afzonderlijke extensies die u kunt installeren en beheren.
Zodra u uw nieuwe Azure Local hebt geregistreerd bij Azure, worden door Azure beheerde extensies automatisch op uw systeem geïnstalleerd. 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 Azure Portal beheren door naar de pagina Extensies te navigeren en het menu Instellingen te selecteren.
Als u een bestaande Lokale Versie van Azure hebt die is geregistreerd bij Azure zonder deze extensies, wordt er een banner weergegeven op de pagina Overzicht of Extensies in Azure Portal. U kunt de informatie in de banner gebruiken om u te begeleiden bij het installeren van deze extensies.
U kunt extensies installeren op het tabblad Mogelijkheden voor uw servers met lokale Arc van Azure, zoals wordt weergegeven in de schermopname. U kunt het tabblad Mogelijkheden gebruiken om de meeste extensies te installeren.
Wanneer u een extensie in Azure Portal installeert, is dit een clusterbewuste bewerking. De extensie wordt geïnstalleerd op alle knooppunten van het systeem. Als u meer knooppunten aan uw systeem toevoegt, worden alle extensies die op uw systeem zijn geïnstalleerd, automatisch toegevoegd aan de nieuwe servers.
Azure CLI is beschikbaar voor installatie in Windows-, macOS- en Linux-omgevingen. Het kan ook worden uitgevoerd in Azure Cloud Shell. Raadpleeg de 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:
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'))
Voer de volgende opdracht uit om de Windows Admin Center-extensie op alle systemen onder de resourcegroep te installeren:
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
Als u de Azure Monitor Agent-extensie wilt installeren op alle systemen in de resourcegroep, voert u de volgende opdracht uit:
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
Voer de volgende opdracht uit om de Azure Site Recovery-extensie te installeren op alle systemen 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 kan worden uitgevoerd in Azure Cloud Shell. In dit document wordt beschreven hoe u PowerShell gebruikt in Azure Cloud Shell. Raadpleeg de 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:
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
Set-AzContext -Subscription "${subscription}"
$clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name
Voer de volgende opdracht uit om de Windows Admin Center-extensie op alle systemen onder de resourcegroep te installeren:
Als u de Azure Site Recovery-extensie wilt installeren op alle systemen onder de resourcegroep, maakt u een JSON-parameterbestand en voert u vervolgens 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
}
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 is beschikbaar voor installatie in Windows-, macOS- en Linux-omgevingen. Het kan ook worden uitgevoerd in Azure Cloud Shell. Raadpleeg de 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:
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}"
Voer de volgende opdracht uit om alle extensies op een systeem weer te geven:
az stack-hci extension list \
--arc-setting-name "default" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}" \
-o table
Als u een specifieke extensie wilt filteren, voert AzureMonitorWindowsAgentu de volgende opdracht uit:
Azure PowerShell kan worden uitgevoerd in Azure Cloud Shell. In dit document wordt beschreven hoe u PowerShell gebruikt in Azure Cloud Shell. Raadpleeg de 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 te volgen:
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
Voer de volgende opdracht uit om alle extensies op een systeem weer te geven:
Wanneer dit wordt gepubliceerd door het uitgeversteam van de extensie, 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 in clusters met Azure Local Arc, tenzij u expliciet afmeldt voor automatische upgrades.
Op dit moment worden automatische uitbreidingsupgrades alleen ondersteund in de Windows Admin Center-extensie, maar er worden in de toekomst meer extensies toegevoegd.
Notitie
Standaard worden alle extensies ingesteld om automatische upgrades in te schakelen, zelfs als een extensie geen ondersteuning biedt voor de automatische uitbreidingsupgrade. Deze standaardinstelling heeft echter geen effect totdat de uitgever van de extensie ervoor kiest om automatische uitbreidingsupgrade te ondersteunen.
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:
Kies de extensie waarvoor u automatische upgrade wilt inschakelen.
Selecteer Automatische upgrade inschakelen in het bovenste menu
Wanneer u wordt gevraagd uw intentie te bevestigen, selecteert u OK.
Als u automatische upgrade wilt installeren en inschakelen voor een specifieke extensie, 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"
Als u automatische upgrade wilt installeren en inschakelen voor een specifieke extensie, 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 uitbreidingsupgrade via Azure Portal
De handmatige extensie-upgrade werkt als de automatische extensie-upgrade. Wanneer u een extensie handmatig bijwerken, slaat Azure op een lokaal Arc-cluster de versie op die u hebt geselecteerd. Vervolgens probeert Azure de extensie bij te werken op alle knooppunten in het cluster naar die versie.
Als de upgrade van de extensie op sommige servers mislukt, probeert het platform tijdens de volgende lokale Azure-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 bijwerken.
De optie voor automatische upgrade van de extensie is uitgeschakeld en er is een versie die niet overeenkomt met verschillende knooppunten van Azure Local.
Voer de volgende stappen uit om handmatig een extensie bij te werken:
Ga naar de pagina Extensies .
Kies de extensie die u wilt upgraden en selecteer Instellingen in het bovenste menu.
Kies de nieuwste versie en selecteer Opslaan.
Automatische uitbreidingsupgrade uitschakelen
U kunt automatische upgrades uitschakelen voor bepaalde extensies in Azure Portal. Als u automatische upgrades wilt uitschakelen, gaat u naar de pagina Extensies en voert u de volgende stappen uit:
Kies de extensie waarvoor u de automatische upgrade wilt uitschakelen.
Selecteer Automatische upgrade uitschakelen in het bovenste menu.
Wanneer u wordt gevraagd uw intentie te bevestigen, selecteert u OK.
De upgradegeschiedenis van de extensie controleren
U kunt het tabblad Activiteitenlogboek bekijken op afzonderlijke serverresources, resourcegroepen en abonnementen met Azure Arc om de geschiedenis van automatische uitbreidingsupgrades voor afzonderlijke knooppunten te controleren. Zie De geschiedenis van automatische uitbreidingsupgrades controleren voor meer informatie.
Beschikbaarheids-eerste updates
Voor een groep clusters met azure Local Arc die een upgrade ondergaan, heeft het Azure-platform het model voor automatische uitbreidingsupgrade 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 uitgegeven in batches tussen Azure-regio's en -abonnementen, dus u ziet mogelijk een extensie-upgrade op sommige servers voordat andere. Zie Timing van automatische uitbreidingsupgrades voor meer informatie.
Als u problemen ondervindt met een extensie-upgrade, kunt u de automatische extensie-upgrade uitschakelen. Wanneer u de automatische upgrade uitschakelt, voorkomt het opnieuw proberen van het systeem terwijl u het probleem oplost. U kunt de automatische uitbreidingsupgrade weer inschakelen wanneer u klaar bent.
Upgrades met meerdere extensies
Als er meerdere uitbreidingsupgrades beschikbaar zijn voor een knooppunt, kunnen ze samen worden gebatcheerd. Elke extensie-upgrade wordt echter afzonderlijk toegepast op het knooppunt. Zie Uitbreidingsupgrades met meerdere extensies voor meer informatie.
Desgewenst kunt u enkele extensies verwijderen uit uw Lokale Azure-portal in Azure Portal. Als u een extensie wilt verwijderen, voert u de volgende stappen uit:
Ga naar de pagina Extensies.
Kies de extensie die u wilt verwijderen. De knop Verwijderen is niet beschikbaar voor door Azure beheerde extensies.
Selecteer Verwijderen in het bovenste menu.
Bevestig de intentie en selecteer Ja.
Als u een specifieke extensie wilt verwijderen, voert AzureMonitorWindowsAgent u de volgende opdracht uit:
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}"
Als u een specifieke extensie wilt verwijderen, 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"
Remove-AzStackHciExtension `
-ClusterName "${clusterName}" `
-ResourceGroupName "${resourceGroup}" `
-ArcSettingName "default" `
-Name "${extensionName}"
Extensiefouten oplossen
Extensiestatus: mislukt
Aanbeveling: Voor een extensie met een mislukte status selecteert u de koppeling Mislukt (Details weergeven). Bekijk alle informatie over de fout en pas de tips voor probleemoplossing toe.
