Hantera registrering av Azure Stack HCI-kluster

  • Artikel

Gäller för: Azure Stack HCI, versionerna 22H2 och 21H2

Beroende på klusterkonfigurationen och kraven kan du behöva vidta ytterligare åtgärder när du har registrerat klustret med Azure. Den här artikeln beskriver hur du hanterar klusterregistreringen med Windows Admin Center, PowerShell eller Azure Portal. Den ger också svar på vanliga frågor om klusterregistrering.

När du registrerar klustret med Azure skapas en Azure-Resource Manager resurs som representerar det lokala Azure Stack HCI-klustret. Från och med Azure Stack HCI, version 21H2, skapar registrering av ett kluster automatiskt en Azure Arc av serverresursen för varje server i Azure Stack HCI-klustret. Den här Azure Arc-integreringen utökar Azure-hanteringsplanet till Azure Stack HCI. Azure Arc-integreringen möjliggör regelbunden synkronisering av information mellan Azure-resursen och de lokala klustren.

Visa status för registrering och Arc-aktiverade servrar

När du ansluter till ett kluster med Windows Admin Center visas instrumentpanelen, som visar azure Stack HCI-registrering och status för Arc-aktiverade servrar.

  • För Azure Stack HCI-registrering innebär Ansluten att klustret redan har registrerats med Azure och har synkroniserats till molnet under den senaste dagen.

  • För Arc-aktiverade servrar innebär Ansluten att alla fysiska servrar är Arc-aktiverade och kan hanteras från Azure Portal.

    Skärmbild som visar status för klusteranslutningen på Windows Admin Center-instrumentpanelen.

Du kan få mer information genom att välja Azure Arcpå verktygsmenyn till vänster.

Anteckning

Azure Arc-instrumentpanelen är för närvarande i offentlig förhandsversion.

Skärmbild som visar val för att hämta Azure Stack HCI-registreringsinformation.

På sidan Översikt hittar du statusinformation på hög nivå om Azure Stack HCI-registrering och Arc-aktiverade servrar. Du kan klicka på någon av panelerna för att gå till de enskilda sidorna.

Skärmbild av statusinformation om registrering.

På sidan Azure Stack HCI-registrering kan du visa både Azure Stack HCI-systemet och serverstatusen. Detta inkluderar Azure-anslutningsstatus och senaste Azure-synkronisering. Du hittar användbara länkar till felsökningsdokumentation och klustertillägg. Du kan avregistrera om det behövs.

Skärmbild av servrarnas status.

Om klustret är registrerat med Azure, men de fysiska servrarna ännu inte är Arc-aktiverade, kan du göra det från sidan Arc-aktiverade servrar . Om de fysiska servrarna är Arc-aktiverade kan du visa Azure Arc-status och versions-ID för varje server. Du hittar även användbara länkar till felsökningsinformation.

Aktivera Azure Arc-integrering

Från och med Azure Stack HCI, version 21H2, är klustren automatiskt Arc-aktiverade vid registrering. Azure Arc-integrering är inte tillgängligt i Azure Stack HCI, version 20H2.

Du måste aktivera Azure Arc-integrering manuellt i följande scenarier:

  • Du har uppdaterat dina klusterservrar från Azure Stack HCI, version 20H2 (som tidigare inte var Arc-aktiverade manuellt) till version 21H2.
  • Om du tidigare har Arc-aktiverat dina 20H2-kluster och arc-aktiveringen fortfarande inte har uppgraderats till 21H2 kan du läsa mer i vägledningen här för att felsöka.
  • Du har inaktiverat Arc-aktivering tidigare och nu har du för avsikt att Arc-aktivera ditt 21H2- eller senare Azure Stack HCI-kluster.

Följ dessa steg för att aktivera Azure Arc-integrering:

  1. Installera den senaste versionen av modulen Az.Resources på hanteringsdatorn:

    Install-Module -Name Az.Resources

  2. Installera den senaste versionen av modulen Az.StackHCI på hanteringsdatorn:

    Install-Module -Name Az.StackHCI

  3. Kör cmdleten Register-AzStackHCI igen och ange ditt Azure-prenumerations-ID, som måste vara samma ID som klustret ursprungligen registrerades med. Parametern -ComputerName kan vara namnet på valfri server i klustret. Det här steget möjliggör Azure Arc-integrering på alla servrar i klustret. Det påverkar inte din aktuella klusterregistrering med Azure och du behöver inte avregistrera klustret först:

    Register-AzStackHCI  -SubscriptionId "<subscription_ID>" -ComputerName Server1 -Region <region> -TenantId "<tenant_id>"

    Viktigt

    Om klustret ursprungligen registrerades med hjälp av , -Region-ResourceNameeller -ResourceGroupName som skiljer sig från standardinställningarna, måste du ange samma parametrar och värden här. När du kör Get-AzureStackHCI visas dessa värden.

Information om fel vid aktivering av Arc finns i vägledningen här för felsökning.

Uppgradera Arc-agenten på klusterservrar

Från och med Azure Stack HCI, version 21H2, för att automatiskt uppdatera Arc-agenten när en ny version är tillgänglig, kontrollerar du att klusterservrarna har konfigurerats med Microsoft Update. Mer information finns i Microsoft Update-konfiguration.

Följ dessa steg för att uppgradera Arc-agenten på klusterservrar:

  1. I serverkonfigurationsverktyget (SConfig) väljer du alternativet Installera Uppdateringar (alternativ 6):

    Skärmbild av SConfig som visar alternativet för att installera uppdateringen.

  2. Välj alternativet för Alla kvalitetsuppdateringar (alternativ 1).

  3. Du kan välja att specifikt uppdatera Arc-agenten eller installera alla tillgängliga uppdateringar:

    Konfigurationsalternativ.

  4. Kör azcmagent version från PowerShell på varje nod för att verifiera Arc-agentversionen.

Avregistrera Azure Stack HCI

Du kan avregistrera Azure Stack HCI med hjälp av Windows Admin Center eller powershell.

Avregistreringsprocessen rensar automatiskt den Azure-resurs som representerar klustret, Azure-resursgruppen (om gruppen skapades under registreringen och inte innehåller några andra resurser) och Microsoft Entra appidentitet. Den här rensningen stoppar alla funktioner för övervakning, support och fakturering via Azure Arc.

Följ dessa steg för att avregistrera ditt Azure Stack HCI-kluster via Windows Admin Center:

  1. Anslut till klustret med Windows Admin Center.

  2. Välj Azure Arc på menyn till vänster.

  3. Välj Azure Stack HCI-registrering, välj knappen Avregistrera och välj sedan Avregistrera igen.

Anteckning

Om din Windows Admin Center gateway är registrerad på ett annat Microsoft Entra klientorganisations-ID som användes för att registrera klustret kan det uppstå problem när du försöker avregistrera klustret med hjälp av Windows Admin Center. Om detta händer kan du använda PowerShell-anvisningarna i nästa avsnitt.

Rensa efter ett kluster som inte har avregistrerats korrekt

Om en användare förstör ett Azure Stack HCI-kluster utan att avregistrera det, till exempel genom att avbilda värdservrarna på nytt eller ta bort virtuella klusternoder, blir artefakterna kvar i Azure. Dessa artefakter är ofarliga och medför inte fakturering eller användning av resurser, men de kan röra Azure Portal. Om du vill rensa dem kan du ta bort dem manuellt.

Om du vill ta bort Azure Stack HCI-resursen går du till resursen i Azure Portal och väljer Ta bort i åtgärdsfältet. Du kan hämta resursinformationen genom att köra cmdleten Get-AzureStackHCI .

Azure Stack HCI skapar två Microsoft Entra-program som en del av registreringen: resourceName och resourceName.arc. Om du vill ta bort dem går du till Microsoft Entra ID>Appregistreringar>alla program. Välj Ta bort och bekräfta.

Du kan också ta bort Azure Stack HCI-resursen med hjälp av PowerShell:

Remove-AzResource -ResourceId "<resource_name>"

Du kan behöva installera modulen Az.Resources :

Install-Module -Name Az.Resources

Om resursgruppen skapades under registreringen och inte innehåller några andra resurser kan du även ta bort den:

Remove-AzResourceGroup -Name "<resourceGroupName>"

Felsökning

Information om vanliga fel och åtgärdssteg för att lösa dem finns i Felsöka Azure Stack HCI-registrering.

Vanliga frågor och svar

Få svar på några vanliga frågor:

Hur gör jag för att använda en mer begränsad anpassad behörighetsroll?

Du kan ytterligare minska de behörigheter som krävs för att utföra Azure Stack HCI-registrering enligt beskrivningen i Tilldela Azure-behörigheter med hjälp av PowerShell, förutsatt att vissa av de åtgärder som beskrivs nedan redan utförs out-of-band av en användare som har rollen deltagare och administratör för användaråtkomst.

  1. Registrera nödvändiga resursprovidrar. Logga in på den prenumeration som du ska använda för att registrera klustret. Under Inställningar > Resursprovidrar väljer du följande resursprovidrar och sedan Registrera:

    • Microsoft.AzureStackHCI
    • Microsoft.HybridCompute
    • Microsoft.GuestConfiguration
    • Microsoft.HybridConnectivity

  2. Skapa resursgrupperna. Kontrollera att de resursgrupper som Azure Stack HCI-resurserna ska projiceras till i förväg har skapats av en privilegierad användare. Mer information finns i avsnittet förutsättningar .

    När dessa två förutsättningar har konfigurerats skapar du en anpassad roll och använder den för registrering enligt beskrivningen nedan. Skapa först en JSON-fil med namnet customHCIRole.json med följande innehåll. Se till att ändra <subscriptionID> ID:t för din Azure-prenumeration. Om du vill hämta ditt prenumerations-ID går du till Azure Portal, går till Prenumerationer och kopierar/klistrar in ditt ID från listan:

    {
  "Name": "Azure Stack HCI registration role",
  "Id": null,
  "IsCustom": true,
  "Description": "Custom Azure role to allow subscription-level access to register Azure Stack HCI",
  "Actions": [
    "Microsoft.Resources/subscriptions/resourceGroups/read",
    "Microsoft.AzureStackHCI/clusters/*",
    "Microsoft.Authorization/roleAssignments/write",
    "Microsoft.Authorization/roleAssignments/read"
   ],
   "NotActions": [
   ],
   "AssignableScopes": [
      "/subscriptions/<subscriptionId>"
   ]
}

  3. Skapa den anpassade rollen:

    New-AzRoleDefinition -InputFile <path to customHCIRole.json>

  4. Tilldela den anpassade rollen till användaren:

    $user = get-AzAdUser -DisplayName <userdisplayname>
$role = Get-AzRoleDefinition -Name "Azure Stack HCI registration role"
New-AzRoleAssignment -ObjectId $user.Id -RoleDefinitionId $role.Id -Scope /subscriptions/<subscriptionid>

    Nu kan du registrera klustret med Register-AzStackHCI.

    Om du behöver avregistrera det här klustret lägger du till behörigheten Microsoft.Resources/subscriptions/resourceGroups/delete i JSON-filen när du skapar den anpassade rollen.

Hur gör jag för att registrera ett kluster med ArmAccessToken/SPN?

Kontrollera att förutsättningarna är uppfyllda innan du registrerar dig.

Anteckning

Dessa SPN-autentiseringsuppgifter används för inledande registrering till Azure Stack HCI. Azure Stack HCI skapar fortfarande separata SPN-autentiseringsuppgifter för Arc-registrering. Om du vill använda ett anpassat SPN för Arc-registrering läser du Hur gör jag för att registrera ett kluster med SPN för Arc-registrering?.

  1. Kör "Connect-AzAccount" för att ansluta till Azure. Om du vill använda SPN för att ansluta kan du använda:

    • Enhetskodbaserad autentisering. Använd -DeviceCode i cmdleten .
    • Certifikatbaserad autentisering. Se den här artikeln för att konfigurera SPN för certifikatbaserad autentisering. Använd sedan lämpliga parametrar i cmdleten Connect-AzAccount som accepterar certifikatinformation. Det SPN som du använder bör ha alla nödvändiga behörigheter för prenumerationerna som anges här.

  2. Tilldela $token = Get-AzAccessToken.

  3. Använd parametrarna Register-AzStackHCI med parametrarna TenantId, SubscriptionIdArmAccessToken, och AccountId enligt följande:

    Register-AzStackHCI -TenantId "<tenant_ID>" -SubscriptionId "<subscription_ID>" -ComputerName Server1 -Region <region> -ArmAccessToken $token.Token -AccountId $token.UserId

Hur gör jag för att registrera ett kluster med SPN för Arc-registrering?

Följande riktlinjer gäller för den användare som kör registrerings-cmdleten som inte kan tilldelas behörigheten Microsoft.Authorization/roleAssignments/write . I sådana fall kan de använda det i förväg skapade SPN:et med Arc-registreringsroller (Azure Connected Machine Onboarding och Azure Connected Machine Resource Administrator) som tilldelats SPN och ange autentiseringsuppgifterna för registrerings-cmdleten -ArcSpnCredential med hjälp av alternativet .

Anteckning

Azure Stack HCI uppdaterar inte autentiseringsuppgifterna för det SPN som skapats på det här sättet. När SPN-autentiseringsuppgifterna snart upphör att gälla måste du återskapa autentiseringsuppgifterna och köra flödet "reparera registrering" för att uppdatera SPN-autentiseringsuppgifterna i klustret.

Anteckning

Använd PowerShell-modul version 1.4.1 eller tidigare för att använda SPN-autentiseringsuppgifter för Arc-registrering om du inte kan tilldela behörigheten Microsoft.Authorization/roleAssignments/write till registreringsrollen.

Kontrollera att förhandskraven och förkontrollerna är uppfyllda före registreringen. Användaren som registrerar klustret har antingen rollen "deltagare" tilldelad för prenumerationen som används för klusterregistreringen eller har följande lista över behörigheter om en anpassad roll har tilldelats:

  • "Microsoft.Resources/subscriptions/resourceGroups/read",
  • "Microsoft.Resources/subscriptions/resourceGroups/write",
  • "Microsoft.AzureStackHCI/register/action",
  • "Microsoft.AzureStackHCI/Unregister/Action",
  • "Microsoft.AzureStackHCI/clusters/*",
  • "Microsoft.Authorization/roleAssignments/read",
  • "Microsoft.HybridCompute/register/action",
  • "Microsoft.GuestConfiguration/register/action",
  • "Microsoft.HybridConnectivity/register/action"

För avregistrering kontrollerar du att du också har behörigheten Microsoft.Resources/subscriptions/resourceGroups/delete .

Om du vill registrera klustret och Arc-aktivera servrarna kör du följande PowerShell-kommandon när du har uppdaterat dem med din miljöinformation. Följande kommandon kräver Az.Resources (lägsta version 5.6.0) och Az.Accounts (lägsta version 2.7.6). Du kan använda cmdleten get-installedModule <module name> för att kontrollera den installerade versionen av en PowerShell-modul.

#Connect to subscription
Connect-AzAccount -TenantId <tenant_id> -SubscriptionId <Subscription_ID> -Scope Process

#Create a new application registration
$app = New-AzADApplication -DisplayName "<unique_name>"

#Create a new SPN corresponding to the application registration
$sp = New-AzADServicePrincipal -ApplicationId  $app.AppId -Role "Reader" 

#Roles required on SPN for Arc onboarding
$AzureConnectedMachineOnboardingRole = "Azure Connected Machine Onboarding"
$AzureConnectedMachineResourceAdministratorRole = "Azure Connected Machine Resource Administrator"

#Assign roles to the created SPN
New-AzRoleAssignment -ObjectId $sp.Id -RoleDefinitionName $AzureConnectedMachineOnboardingRole | Out-Null
New-AzRoleAssignment -ObjectId $sp.Id -RoleDefinitionName $AzureConnectedMachineResourceAdministratorRole | Out-Null

# Set password validity time. SPN must be updated on the HCI cluster after this timeframe.
$pwdExpiryInYears = 300
$start = Get-Date
$end = $start.AddYears($pwdExpiryInYears)
$pw = New-AzADSpCredential -ObjectId $sp.Id -StartDate $start -EndDate $end
$password = ConvertTo-SecureString $pw.SecretText -AsPlainText -Force  

# Create SPN credentials object to be used in the register-azstackhci cmdlet
$spnCred = New-Object System.Management.Automation.PSCredential ($app.AppId, $password)
Disconnect-AzAccount -ErrorAction Ignore | Out-Null

# Use the SPN credentials created previously in the register-azstackhci cmdlet
Register-AzStackHCI -SubscriptionId < Subscription_ID> -Region <region> -ArcSpnCredential:$spnCred

Stöds resursflytt för Azure Stack HCI-resurser?

Vi stöder inte resursflytt för några Azure Stack HCI-resurser. Om du vill ändra platsen för resurserna måste du först avregistrera klustret och sedan registrera det igen på den nya platsen genom att skicka lämpliga parametrar i cmdleten Register-AzStackHCI .

Vilka är några av de vanligaste registrerings- och Arc-cmdletarna?

  • Cmdletar för Az.StackHCI PowerShell-modul finns i HCI PowerShell-dokumentationen.
  • Get-AzureStackHCI: returnerar den aktuella nodanslutningen och principinformationen för Azure Stack HCI.
  • Get-AzureStackHCIArcIntegration: returnerar status för nod arc-integrering.
  • Sync-AzureStackHCI:
    • Utför fakturering, licensiering och censussynkronisering med Azure.
    • Systemet kör denna cmdlet automatiskt var 12:e timme.
    • Du bör bara använda den här cmdleten när ett klusters Internetanslutning har varit otillgänglig under en längre period.
    • Kör inte denna cmdlet omedelbart efter omstart av servern. låt den automatiska synkroniseringen ske. Annars kan det resultera i ett felaktigt tillstånd.

Nästa steg

Mer detaljerad information finns i även: