Registrera Azure Stack Hub med Azure

  • Artikel

Registrera Azure Stack Hub med Azure så att du kan ladda ned Azure Marketplace objekt från Azure och konfigurera handelsdata som rapporterar tillbaka till Microsoft. När du har registrerat Azure Stack Hub rapporteras användningen till Azure Commerce och du kan se den under det Prenumerations-ID för Azure-fakturering som används för registrering.

Informationen i den här artikeln beskriver hur du registrerar Azure Stack Hub-integrerade system med Azure. Information om hur du registrerar ASDK med Azure finns i Azure Stack Hub-registrering i ASDK-dokumentationen.

Viktigt

Registrering krävs för att stödja fullständiga Azure Stack Hub-funktioner, inklusive att erbjuda objekt på marknadsplatsen. Du bryter mot licensvillkoren för Azure Stack Hub om du inte registrerar dig när du använder faktureringsmodellen betala per användning. Mer information om Azure Stack Hub-licensieringsmodeller finns på sidan Så här köper du.

Anteckning

För anslutna registreringar skapas ett Microsoft Entra program och associerat huvudnamn för tjänsten i den Active Directory-katalog som är associerad med registreringen. Tjänstens huvudnamn används för Azure Stack Hub Marketplace-scenarier (för att visa och ladda ned Azure Marketplace objekt), ladda upp användningsdata (om användningsrapportering är aktiverat), insamling av diagnostikloggar och fjärrsupport. Om du tar bort eller ändrar det här programmet eller tjänstens huvudnamn fungerar inte dessa scenarier och aviseringar aktiveras. Om den tas bort kan den återskapas genom avregistrering och sedan omregistrera Azure Stack Hub med Azure.

Anteckning

Syndikering på marknadsplatsen online, insamling av diagnostikloggar och fjärrsupport är inte tillgängliga för frånkopplade registreringar. Du måste använda offlinesyndikering på Marketplace.

Förutsättningar

Slutför följande krav innan du registrerar dig:

  • Verifiera dina autentiseringsuppgifter.
  • Ange PowerShell-språkläget.
  • Installera PowerShell för Azure Stack Hub.
  • Ladda ned Azure Stack Hub-verktygen.
  • Fastställ din faktureringsmodell.
  • Fastställ ditt unika registreringsnamn.

Ange autentiseringsuppgifterna

Innan du registrerar Azure Stack Hub med Azure måste du ha:

  • Prenumerations-ID för en Azure-prenumeration. Endast ea-, CSP- eller CSP-prenumerationer för delade tjänster stöds för registrering. Molnlösningsleverantörer måste bestämma om de ska använda en CSP- eller APSS-prenumeration.

    Om du vill hämta ID:t går du till Azure Portal och väljer Alla tjänster > Allmänna > prenumerationer, väljer den prenumeration som du vill använda i listan. I avsnittet Essentials letar du upp prenumerations-ID:t. Vi rekommenderar att du använder separata prenumerationer för produktions- och utvecklings- eller testmiljöer.

  • Prenumerations-ID för en Azure-prenumeration. Endast EA-prenumerationer stöds för registrering.

    Om du vill hämta ID:t går du till Azure Portal och väljer Alla tjänster > Allmänna > prenumerationer, väljer den prenumeration som du vill använda i listan. I avsnittet Essentials letar du upp prenumerations-ID:t. Vi rekommenderar att du använder separata prenumerationer för produktions- och utvecklings- eller testmiljöer.

Anteckning

Molnprenumerationer i Tyskland stöds inte för närvarande.

  • Användarnamn och lösenord för ett konto som är ägare till prenumerationen.

  • Användarkontot måste ha åtkomst till Azure-prenumerationen och ha behörighet att skapa identitetsappar och tjänstens huvudnamn i katalogen som är associerad med den prenumerationen. Vi rekommenderar att du registrerar Azure Stack Hub med Azure med hjälp av administration med lägsta behörighet. Mer information om hur du skapar en anpassad rolldefinition som begränsar åtkomsten till din prenumeration för registrering finns i Skapa en registreringsroll för Azure Stack Hub.

  • Registrerade Azure Stack Hub-resursprovidern (mer information finns i avsnittet Registrera Azure Stack Hub-resursprovider).

Efter registreringen krävs inte Microsoft Entra global administratörsbehörighet. Vissa åtgärder kan dock kräva autentiseringsuppgifter för global administratör (till exempel ett installationsskript för resursprovidern eller en ny funktion som kräver en behörighet att beviljas). Du kan antingen tillfälligt återställa kontots globala administratörsbehörigheter eller använda ett separat globalt administratörskonto som är ägare till standardleverantörsprenumerationen.

Den användare som registrerar Azure Stack Hub är ägare till tjänstens huvudnamn i Microsoft Entra-ID. Endast den användare som registrerade Azure Stack Hub kan ändra Azure Stack Hub-registreringen. Alla andra användare, även om de är globala administratörer, måste läggas till i "Standardleverantörsprenumeration" via "Åtkomstkontroll (IAM)". Om en icke-administratörsanvändare som inte är ägare till registreringstjänstens huvudnamn försöker registrera eller omregistrera Azure Stack Hub kan de stöta på ett 403-svar. Ett 403-svar anger att användaren inte har tillräckliga behörigheter för att slutföra åtgärden.

Om du inte har en Azure-prenumeration som uppfyller dessa krav kan du skapa ett kostnadsfritt Azure-konto här. Registrering av Azure Stack Hub medför ingen kostnad för din Azure-prenumeration.

Anteckning

Om du har fler än en Azure Stack Hub är bästa praxis att registrera varje Azure Stack Hub till sin egen prenumeration. Det gör det enklare för dig att spåra användningen.

Ange PowerShell-språkläge

Om du vill registrera Azure Stack Hub måste PowerShell-språkläget vara inställt på FullLanguage. Om du vill kontrollera att det aktuella språkläget är inställt på fullt öppnar du ett upphöjt PowerShell-fönster och kör följande PowerShell-cmdletar:

$ExecutionContext.SessionState.LanguageMode

Se till att utdata returnerar FullLanguage. Om något annat språkläge returneras måste registreringen köras på en annan dator, annars måste språkläget vara inställt på FullLanguage innan du fortsätter.

Installera PowerShell för Azure Stack Hub

Använd den senaste Versionen av PowerShell för Azure Stack Hub för att registrera dig för Azure.

Om den senaste versionen inte redan är installerad kan du läsa installera PowerShell för Azure Stack Hub.

Ladda ned Azure Stack Hub-verktygen

GitHub-lagringsplatsen Azure Stack Hub-verktyg innehåller PowerShell-moduler som stöder Azure Stack Hub-funktioner, inklusive registreringsfunktioner. Under registreringsprocessen måste du importera och använda PowerShell-modulen RegisterWithAzure.psm1 (finns i Azure Stack Hub-verktygslagringsplatsen) för att registrera din Azure Stack Hub-instans med Azure.

För att säkerställa att du använder den senaste versionen tar du bort alla befintliga versioner av Azure Stack Hub-verktygen och laddar ned den senaste versionen från GitHub innan du registrerar dig med Azure.

Anteckning

Du kan också använda OAW (The Operator Access Workstation) för att få åtkomst till den privilegierade slutpunkten (PEP), administratörsportalen för supportscenarier och Azure Stack Hub GitHub Tools. Mer information finns i Åtkomst till arbetsstation för Azure Stack Hub-operatör.

Fastställa din faktureringsmodell

Med en ansluten distribution kan Azure Stack Hub ansluta till Internet och till Azure. Du kan också använda antingen Microsoft Entra-ID eller Active Directory Federation Services (AD FS) (AD FS) som identitetslager och välja mellan två faktureringsmodeller: betala per användning eller kapacitetsbaserad. Du anger faktureringsmodellen senare när du kör registreringsskriptet.

Med en frånkopplad distribution kan du använda Azure Stack Hub utan anslutning till Internet. Med en frånkopplad distribution är du begränsad till ett AD FS-identitetslager och den kapacitetsbaserade faktureringsmodellen. Du anger faktureringsmodellen senare när du kör registreringsskriptet.

Fastställ ditt unika registreringsnamn

När du kör registreringsskriptet måste du ange ett unikt registreringsnamn. Ett enkelt sätt att associera din Azure Stack Hub-prenumeration med en Azure-registrering är att använda ditt Azure Stack Hub-moln-ID.

Anteckning

Azure Stack Hub-registreringar som använder den kapacitetsbaserade faktureringsmodellen måste ändra det unika namnet vid omregistrering efter att de årliga prenumerationerna upphör att gälla om du inte tar bort den utgångna registreringen och registrerar om med Azure.

Information om hur du fastställer moln-ID:t för din Azure Stack Hub-distribution finns i Hitta ditt moln-ID.

Registrera dig med betala per användning-fakturering

Använd de här stegen för att registrera Azure Stack Hub med Azure med faktureringsmodellen betala per användning.

Anteckning

Alla dessa steg måste köras från en dator som har åtkomst till den privilegierade slutpunkten (PEP). Mer information om PEP finns i Använda den privilegierade slutpunkten i Azure Stack Hub.

Anslutna miljöer kan komma åt Internet och Azure. För dessa miljöer måste du registrera Azure Stack Hub-resursprovidern med Azure och sedan konfigurera din faktureringsmodell.

  1. Om du vill registrera Azure Stack Hub-resursprovidern med Azure startar du PowerShell ISE som administratör och använder följande PowerShell-cmdletar med parametern EnvironmentName inställd på lämplig Azure-prenumerationstyp (se parametrarna nedan).

  2. Lägg till det Azure-konto som du använde för att registrera Azure Stack Hub. Om du vill lägga till kontot kör du cmdleten Connect-AzAccount . Du uppmanas att ange dina autentiseringsuppgifter för Azure-kontot och du kan behöva använda tvåfaktorautentisering baserat på ditt kontos konfiguration.

    Connect-AzAccount -EnvironmentName "<environment name>"
    Parameter Beskrivning
    EnvironmentName Namnet på azure-molnprenumerationsmiljön. Miljönamn som stöds är AzureCloud, AzureUSGovernment eller AzureChinaCloud om du använder en China Azure-prenumeration.

    Anteckning

    Om sessionen upphör att gälla har ditt lösenord ändrats, eller om du bara vill byta konto, kör du följande cmdlet innan du loggar in med Connect-AzAccount: Remove-AzAccount-Scope Process

  3. Om du har flera prenumerationer kör du följande kommando för att välja den du vill använda:

    Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription

  4. Kör följande kommando för att registrera Azure Stack Hub-resursprovidern i din Azure-prenumeration:

    Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack

  5. Starta PowerShell ISE som administratör och gå till mappen Registrering i katalogen AzureStack-Tools-az som skapades när du laddade ned Azure Stack Hub-verktygen. Importera modulen RegisterWithAzure.psm1 med PowerShell:

    Import-Module .\RegisterWithAzure.psm1

  6. Innan du fortsätter i samma PowerShell-session kontrollerar du igen att du är inloggad på rätt Azure PowerShell kontext (om inte, upprepa steg 2 och 3.) Den här kontexten är det Azure-konto som användes för att registrera Azure Stack Hub-resursprovidern tidigare. I samma PowerShell-session kör du cmdleten Set-AzsRegistration :

    $CloudAdminCred = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint."
$RegistrationName = "<unique-registration-name>"
Set-AzsRegistration `
   -PrivilegedEndpointCredential $CloudAdminCred `
   -PrivilegedEndpoint <PrivilegedEndPoint computer name> `
   -BillingModel PayAsYouUse `
   -RegistrationName $RegistrationName

    Mer information om cmdleten Set-AzsRegistration finns i Registreringsreferens.

Processen tar mellan 10 och 15 minuter. När kommandot har slutförts visas meddelandet "Din miljö har nu registrerats och aktiverats med hjälp av de angivna parametrarna".

Registrera med kapacitetsfakturering

Använd de här stegen för att registrera Azure Stack Hub med Azure med hjälp av kapacitetsfaktureringsmodellen.

Anteckning

Alla dessa steg måste köras från en dator som har åtkomst till den privilegierade slutpunkten (PEP). Mer information om PEP finns i Använda den privilegierade slutpunkten i Azure Stack Hub.

Anslutna miljöer kan komma åt Internet och Azure. För dessa miljöer måste du registrera Azure Stack Hub-resursprovidern med Azure och sedan konfigurera din faktureringsmodell.

  1. Om du vill registrera Azure Stack Hub-resursprovidern med Azure startar du PowerShell ISE som administratör och använder följande PowerShell-cmdletar med parametern EnvironmentName inställd på lämplig Azure-prenumerationstyp (se parametrarna nedan).

  2. Lägg till det Azure-konto som du använde för att registrera Azure Stack Hub. Om du vill lägga till kontot kör du cmdleten Connect-AzAccount . Du uppmanas att ange dina autentiseringsuppgifter för Azure-kontot och du kan behöva använda tvåfaktorautentisering baserat på ditt kontos konfiguration.

    Connect-AzAccount -Environment "<environment name>"
    Parameter Beskrivning
    EnvironmentName Namnet på azure-molnprenumerationsmiljön. Miljönamn som stöds är AzureCloud, AzureUSGovernment eller AzureChinaCloud om du använder en China Azure-prenumeration.

  3. Om du har flera prenumerationer kör du följande kommando för att välja den du vill använda:

    Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription

  4. Kör följande kommando för att registrera Azure Stack Hub-resursprovidern i din Azure-prenumeration:

    Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack

  5. Starta PowerShell ISE som administratör och gå till mappen Registrering i katalogen AzureStack-Tools-az som skapades när du laddade ned Azure Stack Hub-verktygen. Importera modulen RegisterWithAzure.psm1 med PowerShell:

    Import-Module .\RegisterwithAzure.psm1

  6. Innan du fortsätter i samma PowerShell-session kontrollerar du igen att du är inloggad på rätt Azure PowerShell kontext (om inte, upprepa steg 2 och 3.) Den här kontexten är det Azure-konto som användes för att registrera Azure Stack Hub-resursprovidern. I samma PowerShell-session kör du cmdleten Set-AzsRegistration :

    $CloudAdminCred = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint."
$RegistrationName = "<unique-registration-name>"
Set-AzsRegistration `
   -PrivilegedEndpointCredential $CloudAdminCred `
   -PrivilegedEndpoint <PrivilegedEndPoint computer name> `
   -AgreementNumber <EA agreement number> `
   -BillingModel Capacity `
   -RegistrationName $RegistrationName

    Använd EA-avtalsnumret där dina kapacitets-SKU-licenser köptes.

    Anteckning

    Du kan inaktivera användningsrapportering med parametern UsageReportingEnabled för cmdleten Set-AzsRegistration genom att ange parametern till false.

    Mer information om cmdleten Set-AzsRegistration finns i Registreringsreferens.

Registrera med kapacitetsfakturering

Om du registrerar Azure Stack Hub i en frånkopplad miljö (utan internetanslutning) måste du hämta en registreringstoken från Azure Stack Hub-miljön. Använd sedan denna token på en dator som kan ansluta till Azure och har PowerShell för Azure Stack Hub installerat.

Hämta en registreringstoken från Azure Stack Hub-miljön

  1. Starta PowerShell ISE som administratör och gå till mappen Registrering i katalogen AzureStack-Tools-az som skapades när du laddade ned Azure Stack Hub-verktygen. Importera modulen RegisterWithAzure.psm1 :

    Import-Module .\RegisterWithAzure.psm1

  2. Kör följande PowerShell-cmdletar för att hämta registreringstoken:

    $FilePathForRegistrationToken = "$env:SystemDrive\RegistrationToken.txt"
$YourCloudAdminCredential = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint."
$RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $YourCloudAdminCredential `
 -UsageReportingEnabled:$false `
 -PrivilegedEndpoint <PrivilegedEndPoint computer name> `
 -BillingModel Capacity `
 -AgreementNumber '<EA agreement number>' `
 -TokenOutputFilePath $FilePathForRegistrationToken

    Använd EA-avtalsnumret där dina kapacitets-SKU-licenser köptes.

    Mer information om cmdleten Get-AzsRegistrationToken finns i Registreringsreferens.

    Tips

    Registreringstoken sparas i filen som har angetts för $FilePathForRegistrationToken. Du kan ändra filsökvägen eller filnamnet efter eget gottfinnande.

  3. Spara den här registreringstoken för användning på den Azure-anslutna datorn. Du kan kopiera filen eller texten från $FilePathForRegistrationToken.

Ansluta till Azure och registrera dig

På datorn som är ansluten till Internet utför du samma steg för att importera modulen RegisterWithAzure.psm1 och logga in på rätt Azure PowerShell kontext. Anropa sedan Register-AzsEnvironment. Ange den registreringstoken som ska registreras med Azure. Om du registrerar fler än en instans av Azure Stack Hub med samma Azure-prenumerations-ID anger du ett unikt registreringsnamn.

Du behöver din registreringstoken och ett unikt tokennamn.

  1. Starta PowerShell ISE som administratör och gå till mappen Registrering i katalogen AzureStack-Tools-az som skapades när du laddade ned Azure Stack Hub-verktygen. Importera modulen RegisterWithAzure.psm1 :

    Import-Module .\RegisterWithAzure.psm1

  2. Kör sedan följande PowerShell-cmdletar:

    $RegistrationToken = "<Your Registration Token>"
$RegistrationName = "<unique-registration-name>"
Register-AzsEnvironment -RegistrationToken $RegistrationToken -RegistrationName $RegistrationName

Du kan också använda cmdleten Get-Content för att peka på en fil som innehåller din registreringstoken.

Du behöver din registreringstoken och ett unikt tokennamn.

  1. Starta PowerShell ISE som administratör och gå till mappen Registrering i katalogen AzureStack-Tools-az som skapades när du laddade ned Azure Stack Hub-verktygen. Importera modulen RegisterWithAzure.psm1 :

    Import-Module .\RegisterWithAzure.psm1

  2. Kör sedan följande PowerShell-cmdletar:

    $RegistrationToken = Get-Content -Path '<Path>\<Registration Token File>'
Register-AzsEnvironment -RegistrationToken $RegistrationToken -RegistrationName $RegistrationName

Anteckning

Spara namnet på registreringsresursen och registreringstoken för framtida referens.

Hämta en aktiveringsnyckel från Azure-registreringsresursen

Därefter måste du hämta en aktiveringsnyckel från registreringsresursen som skapades i Azure under Register-AzsEnvironment.

Hämta aktiveringsnyckeln genom att köra följande PowerShell-cmdletar:

$RegistrationResourceName = "<unique-registration-name>"
$KeyOutputFilePath = "$env:SystemDrive\ActivationKey.txt"
$ActivationKey = Get-AzsActivationKey -RegistrationName $RegistrationResourceName -KeyOutputFilePath $KeyOutputFilePath

Tips

Aktiveringsnyckeln sparas i filen som anges för $KeyOutputFilePath. Du kan ändra filsökvägen eller filnamnet efter eget gottfinnande.

Skapa en aktiveringsresurs i Azure Stack Hub

Gå tillbaka till Azure Stack Hub-miljön med filen eller texten från aktiveringsnyckeln som skapats från Get-AzsActivationKey. Skapa sedan en aktiveringsresurs i Azure Stack Hub med den aktiveringsnyckeln. Om du vill skapa en aktiveringsresurs kör du följande PowerShell-cmdletar:

# Open the file that contains the activation key (from Azure), copy the entire contents into your clipboard, then within your PowerShell session (that will communicate with the PEP), paste the activation key contents into a string variable, enclosed by quotation marks: 
$ActivationKey = "<paste activation key here>"
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey

Du kan också använda cmdleten Get-Content för att peka på en fil som innehåller din registreringstoken:

$ActivationKey = Get-Content -Path '<Path>\<Activation Key File>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey

Verifiera Azure Stack Hub-registrering

Du kan använda panelen Regionhantering för att kontrollera att Azure Stack Hub-registreringen lyckades. Den här panelen är tillgänglig på standardinstrumentpanelen i administratörsportalen. Statusen kan registreras eller inte registreras. Om det är registrerat visas även det Azure-prenumerations-ID som du använde för att registrera din Azure Stack Hub tillsammans med registreringsresursgruppen och namnet.

  1. Logga in på Azure Stack Hub-administratörsportalen https://adminportal.local.azurestack.external.

  2. Välj Regionhantering på instrumentpanelen.

  3. Välj Egenskaper. Det här bladet visar status och information om din miljö. Statusen kan vara Registrerad, Inte registrerad eller Förfallen.

    Regionhanteringspanel i administratörsportalen för Azure Stack Hub

    Om de är registrerade inkluderar egenskaperna:

    • Prenumerations-ID för registrering: Det Azure-prenumerations-ID som registrerats och associerats med Azure Stack Hub.
    • Resursgrupp för registrering: Azure-resursgruppen i den associerade prenumerationen som innehåller Azure Stack Hub-resurserna.

  4. Du kan använda Azure Portal för att visa Azure Stack Hub-registreringsresurser och sedan kontrollera att registreringen lyckades. Logga in på Azure Portal med ett konto som är kopplat till prenumerationen som du använde för att registrera Azure Stack Hub. Markera Alla resurser, aktivera kryssrutan Visa dolda typer och välj registreringsnamnet.

  5. Om registreringen inte lyckades måste du registrera igen genom att följa stegen här för att lösa problemet.

Du kan också kontrollera om registreringen lyckades med hjälp av Marketplace-hanteringsfunktionen. Om du ser en lista över marketplace-objekt på bladet Marketplace-hantering lyckades registreringen. I frånkopplade miljöer kan du dock inte se marketplace-objekt i Marketplace-hanteringen.

Förnya eller ändra registrering

Du måste uppdatera registreringen under följande omständigheter:

  • När du har förnyat din kapacitetsbaserade årliga prenumeration.
  • När du ändrar faktureringsmodellen.
  • När din skalning ändras (lägg till/ta bort noder) för kapacitetsbaserad fakturering.

Anteckning

Om proaktiv logginsamling är aktiverad och du förnyar eller ändrar din Azure Stack Hub-registrering måste du återaktivera proaktiv logginsamling. Mer information om proaktiv logginsamling finns i Insamling av diagnostikloggar.

Förutsättningar

Du behöver följande information från administratörsportalen för att förnya eller ändra registreringen:

Administratörsportal Cmdlet-parameter Kommentarer
REGISTRERINGSPRENUMERATIONS-ID Prenumeration Prenumerations-ID som användes under föregående registrering
RESURSGRUPP FÖR REGISTRERING ResourceGroupName Resursgrupp där den tidigare registreringsresursen finns
REGISTRERINGSNAMN RegistrationName Registreringsnamn som användes under föregående registrering

Ändra prenumerationen som du använder

Om du vill ändra prenumerationen du använder måste du först köra cmdleten Remove-AzsRegistration och sedan se till att du är inloggad på rätt Azure PowerShell kontext. Kör sedan Set-AzsRegistration med eventuella ändrade parametrar, inklusive <billing model>. När du kör Remove-AzsRegistration måste du vara inloggad på prenumerationen som används under registreringen och använda värdena för parametrarna RegistrationName och ResourceGroupName som visas i administratörsportalen:

# select the subscription used during the registration (shown in portal)
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
# unregister using the parameter values from portal
Remove-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'
# switch to new subscription id
Select-AzSubscription -Subscription '<New subscription ID>'
# register
Set-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel '<Billing model>' -RegistrationName '<Registration name>' -ResourceGroupName '<Registration resource group name>'

Ändra faktureringsmodell, hur funktioner erbjuds eller registrera om din instans

Det här avsnittet gäller om du vill ändra faktureringsmodellen, hur funktioner erbjuds eller om du vill registrera din instans igen. I alla dessa fall anropar du registreringsfunktionen för att ange de nya värdena. Du behöver inte först ta bort den aktuella registreringen. Logga in på prenumerations-ID:t som visas i administratörsportalen och kör sedan registreringen igen med ett nytt BillingModel värde samtidigt som parametervärdena och ResourceGroupName bevaras RegistrationName på samma sätt som i administratörsportalen:

# select the subscription used during the registration
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
# rerun registration with new BillingModel (or same billing model in case of re-registration) but using other parameters values from portal
Set-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel '<New billing model>' -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'

Du måste uppdatera eller förnya registreringen under följande omständigheter:

  • När du har förnyat din kapacitetsbaserade årliga prenumeration.
  • När du ändrar faktureringsmodellen.
  • När du skalar ändringar (lägg till/ta bort noder) för kapacitetsbaserad fakturering.

Ta bort aktiveringsresursen från Azure Stack Hub

Du måste först ta bort aktiveringsresursen från Azure Stack Hub och sedan registreringsresursen i Azure.

Om du vill ta bort aktiveringsresursen i Azure Stack Hub kör du följande PowerShell-cmdletar i din Azure Stack Hub-miljö:

$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
Remove-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint

Om du vill ta bort registreringsresursen i Azure kontrollerar du att du är på en Azure-ansluten dator, loggar in på rätt Azure PowerShell kontext och kör lämpliga PowerShell-cmdletar enligt beskrivningen nedan.

Du kan använda registreringstoken som används för att skapa resursen:

$RegistrationToken = "<registration token>"
Unregister-AzsEnvironment -RegistrationToken $RegistrationToken

Eller så kan du använda namn på registrerings- och registreringsresursgrupp från administratörsportalen:

Unregister-AzsEnvironment -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'

Registrera igen med hjälp av anslutna steg

Om du ändrar din faktureringsmodell från kapacitetsfakturering i ett frånkopplat tillstånd till förbrukningsfakturering i anslutet tillstånd registrerar du om enligt stegen i den anslutna modellen.

Anteckning

Detta ändrar inte din identitetsmodell, bara faktureringsmekanismen, och du kommer fortfarande att använda AD FS som identitetskälla.

Registrera igen med hjälp av frånkopplade steg

Nu har du avregistrerat dig helt i ett frånkopplat scenario och måste upprepa stegen för att registrera en Azure Stack Hub-miljö i ett frånkopplat scenario.

Inaktivera eller aktivera användningsrapportering

För Azure Stack Hub-miljöer som använder en kapacitetsfaktureringsmodell inaktiverar du användningsrapportering med parametern UsageReportingEnabled med hjälp av cmdletarna Set-AzsRegistration eller Get-AzsRegistrationToken . Azure Stack Hub rapporterar användningsstatistik som standard. Operatörer med kapacitetsanvändning eller stöd för en frånkopplad miljö måste inaktivera användningsrapportering.

Kör följande PowerShell-cmdletar:

$CloudAdminCred = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint."
$RegistrationName = "<unique-registration-name>"
Set-AzsRegistration `
   -PrivilegedEndpointCredential $CloudAdminCred `
   -PrivilegedEndpoint <PrivilegedEndPoint computer name> `
   -BillingModel Capacity
   -RegistrationName $RegistrationName
   -UsageReportingEnabled:$false

  1. Om du vill ändra registreringstoken kör du följande PowerShell-cmdletar:

    $YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
$FilePathForRegistrationToken = $env:SystemDrive\RegistrationToken.txt
$RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $YourCloudAdminCredential -UsageReportingEnabled:$false -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel Capacity -AgreementNumber '<EA agreement number>' -TokenOutputFilePath $FilePathForRegistrationToken

    Använd EA-avtalsnumret där dina SKU-kapacitetslicenser köptes.

    Tips

    Registreringstoken sparas i filen som angetts för $FilePathForRegistrationToken. Du kan ändra filsökvägen eller filnamnet efter eget gottfinnande.

  2. Spara den här registreringstoken för användning på den Azure-anslutna datorn. Du kan kopiera filen eller texten från $FilePathForRegistrationToken.

Flytta en registreringsresurs

Flytt av en registreringsresurs mellan resursgrupper under samma prenumeration stöds för alla miljöer. Att flytta en registreringsresurs mellan prenumerationer stöds dock bara för CSP:er när båda prenumerationerna matchar samma partner-ID. Mer information om hur du flyttar resurser till en ny resursgrupp finns i Flytta resurser till ny resursgrupp eller prenumeration.

Viktigt

För att förhindra oavsiktlig borttagning av registreringsresurser i portalen lägger registreringsskriptet automatiskt till ett lås till resursen. Du måste ta bort låset innan du flyttar eller tar bort det. Vi rekommenderar att du lägger till ett lås i registreringsresursen för att förhindra oavsiktlig borttagning.

Registreringsreferens

Set-AzsRegistration

Du kan använda Set-AzsRegistration för att registrera Azure Stack Hub med Azure och aktivera eller inaktivera erbjudandet för objekt på Marketplace och användningsrapportering.

Om du vill köra cmdleten behöver du:

  • En global Azure-prenumeration av valfri typ.
  • Loggas in på Azure PowerShell med ett konto som är ägare eller deltagare i prenumerationen.
Set-AzsRegistration [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String> [[-AzureContext]
    <PSObject>] [[-ResourceGroupName] <String>] [[-ResourceGroupLocation] <String>] [[-BillingModel] <String>]
    [-MarketplaceSyndicationEnabled] [-UsageReportingEnabled] [[-AgreementNumber] <String>] [[-RegistrationName]
    <String>] [<CommonParameters>]
Parameter Typ Description
PrivilegedEndpointCredential PSCredential De autentiseringsuppgifter som används för att komma åt den privilegierade slutpunkten. Användarnamnet är i formatet AzureStackDomain\CloudAdmin.
PrivilegedEndpoint Sträng En förkonfigurerad PowerShell-fjärrkonsol som ger dig funktioner som logginsamling och andra uppgifter efter distributionen. Mer information finns i artikeln använda den privilegierade slutpunkten .
AzureContext PSObject
ResourceGroupName Sträng
ResourceGroupLocation Sträng
BillingModel Sträng Den faktureringsmodell som din prenumeration använder. Tillåtna värden för den här parametern är: Kapacitet, PayAsYouUse och Utveckling.
MarketplaceSyndicationEnabled Sant/falskt Avgör om marketplace-hanteringsfunktionen är tillgänglig i portalen. Ange till true om du registrerar dig med Internetanslutning. Ställ in på false om du registrerar dig i frånkopplade miljöer. För frånkopplade registreringar kan verktyget för offlinesyndikering användas för att ladda ned Marketplace-objekt.
UsageReportingEnabled Sant/falskt Azure Stack Hub rapporterar användningsstatistik som standard. Operatörer med kapacitetsanvändning eller stöd för en frånkopplad miljö måste inaktivera användningsrapportering. Tillåtna värden för den här parametern är: True, False.
AgreementNumber Sträng Antalet EA-avtal enligt vilket kapacitets-SKU:n för den här Azure Stack beställdes.
RegistrationName Sträng Ange ett unikt namn för registreringen om du kör registreringsskriptet på mer än en instans av Azure Stack Hub med samma Azure-prenumerations-ID. Parametern har standardvärdet AzureStackRegistration. Men om du använder samma namn på mer än en instans av Azure Stack Hub misslyckas skriptet.

Get-AzsRegistrationToken

Get-AzsRegistrationToken genererar en registreringstoken från indataparametrarna.

Get-AzsRegistrationToken [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String>
    [-BillingModel] <String> [[-TokenOutputFilePath] <String>] [-UsageReportingEnabled] [[-AgreementNumber] <String>]
    [<CommonParameters>]
Parameter Typ Description
PrivilegedEndpointCredential PSCredential De autentiseringsuppgifter som används för att komma åt den privilegierade slutpunkten. Användarnamnet är i formatet AzureStackDomain\CloudAdmin.
PrivilegedEndpoint Sträng En förkonfigurerad PowerShell-fjärrkonsol som ger dig funktioner som logginsamling och andra uppgifter efter distributionen. Mer information finns i artikeln använda den privilegierade slutpunkten .
AzureContext PSObject
ResourceGroupName Sträng
ResourceGroupLocation Sträng
BillingModel Sträng Den faktureringsmodell som din prenumeration använder. Tillåtna värden för den här parametern är: Kapacitet, Anpassad och Utveckling.
MarketplaceSyndicationEnabled Sant/falskt
UsageReportingEnabled Sant/falskt Azure Stack Hub rapporterar användningsstatistik som standard. Operatörer med kapacitetsanvändning eller stöd för en frånkopplad miljö måste inaktivera användningsrapportering. Tillåtna värden för den här parametern är: True, False.
AgreementNumber Sträng

Registreringsfel

Du kan se något av felen nedan när du försöker registrera din Azure Stack Hub:

  • Det gick inte att hämta obligatorisk maskinvaruinformation för $hostName. Kontrollera den fysiska värden och anslutningen och försök sedan köra registreringen igen.

  • Det går inte att ansluta till $hostName för att hämta maskinvaruinformation. Kontrollera den fysiska värden och anslutningen och försök sedan köra registreringen igen.

    Orsak: Vi försökte hämta maskinvaruinformation som UUID, Bios och CPU från värdarna för att försöka aktivera och kunde inte göra det på grund av att det inte gick att ansluta till den fysiska värden.

  • Molnidentifieraren [GUID] är redan registrerad. Det är inte tillåtet att återanvända molnidentifierare.

    Orsak: Detta inträffar om din Azure Stack-miljö redan är registrerad. Om du vill registrera om din miljö med en annan prenumeration eller faktureringsmodell följer du stegen för att förnya eller ändra registrering.

  • När du försöker komma åt Marketplace-hantering uppstår ett fel när du försöker syndikera produkter.

    Orsak: Detta inträffar vanligtvis när Azure Stack Hub inte kan komma åt registreringsresursen. En vanlig orsak till detta är att när en Azure-prenumerations katalogklientorganisation ändras återställs registreringen. Du kan inte komma åt Azure Stack Hub Marketplace eller rapportanvändningen om du har ändrat prenumerationens katalogklientorganisation. Du måste registrera om för att åtgärda problemet.

  • Marketplace-hanteringen ber dig fortfarande att registrera och aktivera din Azure Stack Hub, även om du redan har registrerat din stämpel med den frånkopplade processen.

    Orsak: Det här är ett känt problem för frånkopplade miljöer och kräver att du verifierar din registreringsstatus. Använd offlineverktyget för att använda Marketplace-hantering.

Nästa steg

Ladda ned Marketplace-objekt från Azure