Azure Stack Hub registreren bij Azure

Artikel
07/29/2022
26 minuten om te lezen

Registreer Azure Stack Hub bij Azure zodat u Azure Marketplace items van Azure kunt downloaden en commercegegevensrapportage kunt instellen bij Microsoft. Nadat u Azure Stack Hub hebt geregistreerd, wordt het gebruik gerapporteerd aan Azure Commerce en kunt u dit zien onder de Azure-factureringsabonnements-id die wordt gebruikt voor registratie.

In de informatie in dit artikel wordt beschreven hoe u geïntegreerde Azure Stack Hub-systemen registreert bij Azure. Zie de Azure Stack Hub-registratie in de ASDK-documentatie voor informatie over het registreren van de ASDK bij Azure.

Belangrijk

Registratie is vereist om volledige Functionaliteit van Azure Stack Hub te ondersteunen, inclusief het aanbieden van items in de marketplace. U bent in strijd met de licentievoorwaarden van Azure Stack Hub als u zich niet registreert wanneer u het factureringsmodel voor betalen per gebruik gebruikt. Zie de pagina Kopen voor meer informatie over Azure Stack Hub-licentiemodellen.

Notitie

Voor verbonden registraties wordt een Azure Active Directory-toepassing en de bijbehorende service-principal gemaakt in de Active Directory-directory die is gekoppeld aan de registratie. Deze service-principal wordt gebruikt voor Azure Stack Hub Marketplace-scenario's (voor het weergeven en downloaden van Azure Marketplace items), het uploaden van gebruiksgegevens (indien gebruiksrapportage is ingeschakeld), het verzamelen van diagnostische logboeken en externe ondersteuning. Als u deze toepassing of service-principal verwijdert of wijzigt, werken deze scenario's niet en worden er waarschuwingen gegenereerd. Als deze wordt verwijderd, kan het opnieuw worden gemaakt door de registratie ongedaan te maken en vervolgens Azure Stack Hub opnieuw te registreren bij Azure.

Notitie

Online marketplace-syndicatie, verzameling diagnostische logboeken en externe ondersteuning zijn niet beschikbaar voor niet-verbonden registraties. U moet offline marketplace-syndicatie gebruiken.

Vereisten

Voltooi de volgende secties met vereisten voordat u zich registreert:

Controleer uw referenties.
Stel de PowerShell-taalmodus in.
Installeer PowerShell voor Azure Stack Hub.
Download de Azure Stack Hub-hulpprogramma's.
Bepaal uw factureringsmodel.
Bepaal uw unieke registratienaam.

Uw referenties controleren

Voordat u Azure Stack Hub registreert bij Azure, moet u het volgende hebben:

De abonnements-id voor een Azure-abonnement. Alleen abonnementen op gedeelde EA-, CSP- of CSP-services worden ondersteund voor registratie. CSP's moeten beslissen of u een CSP- of APSS-abonnement wilt gebruiken.

Als u de id wilt ophalen, gaat u naar de Azure Portal en selecteert u Alle services > Algemeen > abonnementen, kiest u het abonnement dat u wilt gebruiken in de lijst. Zoek in de sectie Essentials de abonnements-id . Gebruik als best practice afzonderlijke abonnementen voor productie- en ontwikkel- of testomgevingen.

De abonnements-id voor een Azure-abonnement. Alleen EA-abonnementen worden ondersteund voor registratie.

Als u de id wilt ophalen, gaat u naar de Azure Portal en selecteert u Alle services > Algemeen > abonnementen, kiest u het abonnement dat u wilt gebruiken in de lijst. Zoek in de sectie Essentials de abonnements-id . Gebruik als best practice afzonderlijke abonnementen voor productie- en ontwikkel- of testomgevingen.

Notitie

Duitsland-cloudabonnementen worden momenteel niet ondersteund.

De gebruikersnaam en het wachtwoord voor een account dat eigenaar is van het abonnement.
Het gebruikersaccount moet toegang hebben tot het Azure-abonnement en machtigingen hebben om identiteits-apps en service-principals te maken in de directory die aan dat abonnement is gekoppeld. U wordt aangeraden Azure Stack Hub te registreren bij Azure met behulp van beheer met minimale bevoegdheden. Zie Een registratierol maken voor Azure Stack Hub voor meer informatie over het maken van een aangepaste roldefinitie die de toegang tot uw abonnement voor registratie beperkt.
Registreer de Azure Stack Hub-resourceprovider (zie de volgende sectie Azure Stack Hub-resourceprovider registreren voor meer informatie).

Na de registratie is Azure Active Directory (Azure AD) globale beheerdersmachtiging niet vereist. Voor sommige bewerkingen is echter mogelijk de globale beheerdersreferentie vereist (bijvoorbeeld een script voor het installatieprogramma van de resourceprovider of een nieuwe functie waarvoor een machtiging is vereist). U kunt de globale beheerdersmachtigingen van het account tijdelijk herstellen of een afzonderlijk globaal beheerdersaccount gebruiken dat eigenaar is van het standaardproviderabonnement.

De gebruiker die Azure Stack Hub registreert, is de eigenaar van de service-principal in Azure AD. Alleen de gebruiker die Azure Stack Hub heeft geregistreerd, kan de Azure Stack Hub-registratie wijzigen. Alle andere gebruikers, zelfs als ze een globale beheerder zijn, moeten worden toegevoegd aan 'Standaardproviderabonnement' via 'Toegangsbeheer (IAM)'. Als een niet-beheerder die geen eigenaar van de registratieservice-principal is, azure Stack Hub probeert te registreren of opnieuw te registreren, kan er een 403-antwoord worden weergegeven. Een 403-antwoord geeft aan dat de gebruiker onvoldoende machtigingen heeft om de bewerking te voltooien.

Als u geen Azure-abonnement hebt dat aan deze vereisten voldoet, kunt u hier een gratis Azure-account maken. Als u Azure Stack Hub registreert, worden er geen kosten in rekening gebracht voor uw Azure-abonnement.

Notitie

Als u meer dan één Azure Stack Hub hebt, kunt u het beste elke Azure Stack Hub registreren bij een eigen abonnement. Dit maakt het eenvoudiger voor u om het gebruik bij te houden.

De PowerShell-taalmodus instellen

Als u Azure Stack Hub wilt registreren, moet de PowerShell-taalmodus zijn ingesteld op FullLanguage. Als u wilt controleren of de huidige taalmodus is ingesteld op volledig, opent u een PowerShell-venster met verhoogde bevoegdheid en voert u de volgende PowerShell-cmdlets uit:

$ExecutionContext.SessionState.LanguageMode

Zorg ervoor dat de uitvoer FullLanguage retourneert. Als er een andere taalmodus wordt geretourneerd, moet de registratie worden uitgevoerd op een andere computer of moet de taalmodus worden ingesteld op FullLanguage voordat u doorgaat.

PowerShell voor Azure Stack Hub installeren

Gebruik de nieuwste Versie van PowerShell voor Azure Stack Hub om u te registreren bij Azure.

Als de nieuwste versie nog niet is geïnstalleerd, raadpleegt u PowerShell voor Azure Stack Hub installeren.

De Azure Stack Hub-hulpprogramma's downloaden

De Azure Stack Hub-hulpprogramma's GitHub opslagplaats bevat PowerShell-modules die ondersteuning bieden voor azure Stack Hub-functionaliteit, inclusief registratiefunctionaliteit. Tijdens het registratieproces moet u de PowerShell-module RegisterWithAzure.psm1 (gevonden in de opslagplaats met Azure Stack Hub-hulpprogramma's) importeren en gebruiken om uw Azure Stack Hub-exemplaar bij Azure te registreren.

Om ervoor te zorgen dat u de nieuwste versie gebruikt, verwijdert u alle bestaande versies van de Azure Stack Hub-hulpprogramma's en downloadt u de nieuwste versie van GitHub voordat u zich registreert bij Azure.

Notitie

U kunt ook het OAW (Operator Access Workstation) gebruiken voor toegang tot het bevoegde eindpunt (PEP), de beheerdersportal voor ondersteuningsscenario's en Azure Stack Hub GitHub Tools. Zie Azure Stack Hub Operator Access Workstation voor meer informatie.

Uw factureringsmodel bepalen

Met een verbonden implementatie kan Azure Stack Hub verbinding maken met internet en met Azure. U kunt ook Azure AD of Active Directory Federation Services (AD FS) als uw identiteitsarchief gebruiken en kiezen uit twee factureringsmodellen: betalen per gebruik of op basis van capaciteit. U geeft later het factureringsmodel op terwijl u het registratiescript uitvoert.

Met een niet-verbonden implementatie kunt u Azure Stack Hub gebruiken zonder verbinding met internet. Met een niet-verbonden implementatie bent u beperkt tot een AD FS-identiteitsarchief en het factureringsmodel op basis van capaciteit. U geeft later het factureringsmodel op terwijl u het registratiescript uitvoert.

Uw unieke registratienaam bepalen

Wanneer u het registratiescript uitvoert, moet u een unieke registratienaam opgeven. Een eenvoudige manier om uw Azure Stack Hub-abonnement te koppelen aan een Azure-registratie is door uw Azure Stack Hub Cloud ID te gebruiken.

Notitie

Azure Stack Hub-registraties met het factureringsmodel op basis van capaciteit moeten de unieke naam wijzigen bij het opnieuw registreren nadat deze jaarlijkse abonnementen verlopen, tenzij u de verlopen registratie verwijdert en opnieuw registreert bij Azure.

Zie Uw cloud-id zoeken om de cloud-id voor uw Azure Stack Hub-implementatie te bepalen.

Registreren met facturering per gebruik

Gebruik deze stappen om Azure Stack Hub te registreren bij Azure met behulp van het factureringsmodel voor betalen per gebruik.

Notitie

Al deze stappen moeten worden uitgevoerd vanaf een computer die toegang heeft tot het bevoegde eindpunt (PEP). Zie Het bevoegde eindpunt gebruiken in Azure Stack Hub voor meer informatie over het PEP.

Verbonden omgevingen hebben toegang tot internet en Azure. Voor deze omgevingen moet u de Azure Stack Hub-resourceprovider registreren bij Azure en vervolgens uw factureringsmodel configureren.

Az-modules
AzureRM-modules

Als u de Azure Stack Hub-resourceprovider wilt registreren bij Azure, start u PowerShell ISE als beheerder en gebruikt u de volgende PowerShell-cmdlets met de parameter EnvironmentName ingesteld op het juiste Azure-abonnementstype (zie de onderstaande parameters).

Voeg het Azure-account toe dat u hebt gebruikt om Azure Stack Hub te registreren. Voer de cmdlet Verbinding maken-AzAccount uit om het account toe te voegen. U wordt gevraagd uw Azure-accountreferenties in te voeren en mogelijk moet u tweeledige verificatie gebruiken op basis van de configuratie van uw account.

Connect-AzAccount -EnvironmentName "<environment name>"

Parameter	Beschrijving
EnvironmentName	De naam van de omgeving van het Azure-cloudabonnement. Ondersteunde omgevingsnamen zijn AzureCloud, AzureUSGovernment of als u een Azure-abonnement in China gebruikt, AzureChinaCloud.

Notitie

Als uw sessie verloopt, uw wachtwoord is gewijzigd of als u gewoon van account wilt wisselen, voert u de volgende cmdlet uit voordat u zich aanmeldt met Verbinding maken-AzAccount:Remove-AzAccount-Scope Process

Als u meerdere abonnementen hebt, voert u de volgende opdracht uit om het abonnement te selecteren dat u wilt gebruiken:
```
Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription
```
Voer de volgende opdracht uit om de Azure Stack Hub-resourceprovider te registreren in uw Azure-abonnement:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack
```
Startmenu PowerShell ISE als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-az die u hebt gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 met behulp van PowerShell:
```
Import-Module .\RegisterWithAzure.psm1
```
Voordat u doorgaat, controleert u in dezelfde PowerShell-sessie of u bent aangemeld bij de juiste Azure PowerShell context (als dat niet het geval is, herhaalt u stap 2 en 3.) Deze context is het Azure-account dat eerder is gebruikt om de Azure Stack Hub-resourceprovider te registreren. Voer in dezelfde PowerShell-sessie de cmdlet Set-AzsRegistration uit:
```
$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
```
Zie registratiereferentie voor meer informatie over de cmdlet Set-AzsRegistration.

Als u de Azure Stack Hub-resourceprovider wilt registreren bij Azure, start u PowerShell ISE als beheerder en gebruikt u de volgende PowerShell-cmdlets met de parameter EnvironmentName ingesteld op het juiste Azure-abonnementstype (zie de onderstaande parameters).

Voeg het Azure-account toe dat u hebt gebruikt om Azure Stack Hub te registreren. Voer de cmdlet Add-AzureRMAccount uit om het account toe te voegen. U wordt gevraagd uw Azure-accountreferenties in te voeren en mogelijk moet u tweeledige verificatie gebruiken op basis van de configuratie van uw account.

Add-AzureRMAccount -EnvironmentName "<environment name>"

Parameter	Beschrijving
EnvironmentName	De naam van de omgeving van het Azure-cloudabonnement. Ondersteunde omgevingsnamen zijn AzureCloud, AzureUSGovernment of als u een Azure-abonnement in China gebruikt, AzureChinaCloud.

Notitie

Als uw sessie verloopt, uw wachtwoord is gewijzigd of als u gewoon van account wilt wisselen, voert u de volgende cmdlet uit voordat u zich aanmeldt met Add-AzureRMAccount: Remove-AzureRMAccount-Scope Process

Als u meerdere abonnementen hebt, voert u de volgende opdracht uit om het abonnement te selecteren dat u wilt gebruiken:
```
Get-AzureRMSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzureRMSubscription
```
Voer de volgende opdracht uit om de Azure Stack Hub-resourceprovider te registreren in uw Azure-abonnement:
```
Register-AzureRMResourceProvider -ProviderNamespace Microsoft.AzureStack
```
Startmenu PowerShell ISE als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-az die u hebt gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 met behulp van PowerShell:
```
Import-Module .\RegisterWithAzure.psm1
```

Controleer vervolgens in dezelfde PowerShell-sessie of u bent aangemeld bij de juiste Azure PowerShell context. Deze context is het Azure-account dat eerder is gebruikt om de Azure Stack Hub-resourceprovider te registreren. PowerShell om uit te voeren:

Connect-AzureRMAccount -Environment "<environment name>"

Parameter	Beschrijving
EnvironmentName	De naam van de omgeving van het Azure-cloudabonnement. Ondersteunde omgevingsnamen zijn AzureCloud, AzureUSGovernment of als u een Azure-abonnement in China gebruikt, AzureChinaCloud.

Voer in dezelfde PowerShell-sessie de cmdlet Set-AzsRegistration uit. PowerShell om uit te voeren:

$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

Zie registratiereferentie voor meer informatie over de cmdlet Set-AzsRegistration.

Het proces duurt tussen 10 en 15 minuten. Wanneer de opdracht is voltooid, ziet u het bericht 'Uw omgeving is nu geregistreerd en geactiveerd met behulp van de opgegeven parameters'.

Registreren bij capaciteitsfacturering

Gebruik deze stappen om Azure Stack Hub te registreren bij Azure met behulp van het capaciteitsfactureringsmodel.

Notitie

Verbonden omgevingen hebben toegang tot internet en Azure. Voor deze omgevingen moet u de Azure Stack Hub-resourceprovider registreren bij Azure en vervolgens uw factureringsmodel configureren.

Az-modules
AzureRM-modules

Als u de Azure Stack Hub-resourceprovider wilt registreren bij Azure, start u PowerShell ISE als beheerder en gebruikt u de volgende PowerShell-cmdlets met de parameter EnvironmentName ingesteld op het juiste Azure-abonnementstype (zie de onderstaande parameters).

Connect-AzAccount -Environment "<environment name>"

Parameter	Beschrijving
EnvironmentName	De naam van de omgeving van het Azure-cloudabonnement. Ondersteunde omgevingsnamen zijn AzureCloud, AzureUSGovernment of als u een Azure-abonnement in China gebruikt, AzureChinaCloud.

Als u meerdere abonnementen hebt, voert u de volgende opdracht uit om het abonnement te selecteren dat u wilt gebruiken:
```
Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription
```
Voer de volgende opdracht uit om de Azure Stack Hub-resourceprovider te registreren in uw Azure-abonnement:
```
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack
```
Startmenu PowerShell ISE als beheerder en navigeer naar de registratiemap in de map AzureStack-Tools-az die u hebt gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 met behulp van PowerShell:
```
Import-Module .\RegisterwithAzure.psm1
```
Voordat u doorgaat, controleert u in dezelfde PowerShell-sessie of u bent aangemeld bij de juiste Azure PowerShell context (als dat niet het geval is, herhaalt u stap 2 en 3.) Deze context is het Azure-account dat is gebruikt om de Azure Stack Hub-resourceprovider te registreren. Voer in dezelfde PowerShell-sessie de cmdlet Set-AzsRegistration uit:
```
$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
```
Gebruik het EA-overeenkomstnummer waar uw capaciteits-SKU-licenties zijn gekocht.

Notitie

U kunt gebruiksrapportage uitschakelen met de parameter UsageReportingEnabled voor de cmdlet Set-AzsRegistration door de parameter in te stellen op false.

Zie registratiereferentie voor meer informatie over de cmdlet Set-AzsRegistration.

Als u de Azure Stack Hub-resourceprovider wilt registreren bij Azure, start u PowerShell ISE als beheerder en gebruikt u de volgende PowerShell-cmdlets met de parameter EnvironmentName ingesteld op het juiste Azure-abonnementstype (zie de onderstaande parameters).

Connect-AzureRMAccount -Environment "<environment name>"

Parameter	Beschrijving
EnvironmentName	De naam van de omgeving van het Azure-cloudabonnement. Ondersteunde omgevingsnamen zijn AzureCloud, AzureUSGovernment of als u een Azure-abonnement in China gebruikt, AzureChinaCloud.

Als u meerdere abonnementen hebt, voert u de volgende opdracht uit om het abonnement te selecteren dat u wilt gebruiken:
```
Get-AzureRMSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzureRMSubscription
```
Voer de volgende opdracht uit om de Azure Stack Hub-resourceprovider te registreren in uw Azure-abonnement:
```
Register-AzureRMResourceProvider -ProviderNamespace Microsoft.AzureStack
```
Startmenu PowerShell ISE als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-master die is gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 met behulp van PowerShell:
```
$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
```
Gebruik het EA-overeenkomstnummer waar uw capaciteits-SKU-licenties zijn gekocht.

Notitie

U kunt gebruiksrapportage uitschakelen met de parameter UsageReportingEnabled voor de cmdlet Set-AzsRegistration door de parameter in te stellen op false.

Zie registratiereferentie voor meer informatie over de cmdlet Set-AzsRegistration.

Registreren bij capaciteitsfacturering

Als u Azure Stack Hub registreert in een niet-verbonden omgeving (zonder internetverbinding), moet u een registratietoken ophalen uit de Azure Stack Hub-omgeving. Gebruik dat token vervolgens op een computer die verbinding kan maken met Azure en waarop PowerShell voor Azure Stack Hub is geïnstalleerd.

Een registratietoken ophalen uit de Azure Stack Hub-omgeving

Startmenu PowerShell ISE als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-az die u hebt gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 :
```
Import-Module .\RegisterWithAzure.psm1
```

Voer de volgende PowerShell-cmdlets uit om het registratietoken op te halen:

$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

Gebruik het EA-overeenkomstnummer waar uw capaciteits-SKU-licenties zijn gekocht.

Zie registratiereferentie voor meer informatie over de cmdlet Get-AzsRegistrationToken.

Tip

Het registratietoken wordt opgeslagen in het bestand dat is opgegeven voor $FilePathForRegistrationToken. U kunt het bestandspad of de bestandsnaam naar eigen inzicht wijzigen.

Sla dit registratietoken op voor gebruik op de met Azure verbonden machine. U kunt het bestand of de tekst kopiëren vanuit $FilePathForRegistrationToken.

Verbinding maken naar Azure en registreren

Voer op de computer die is verbonden met internet dezelfde stappen uit om de module RegisterWithAzure.psm1 te importeren en u aan te melden bij de juiste Azure PowerShell context. Roep vervolgens Register-AzsEnvironment aan. Geef het registratietoken op dat moet worden geregistreerd bij Azure. Als u meer dan één exemplaar van Azure Stack Hub registreert met dezelfde Azure-abonnements-id, geeft u een unieke registratienaam op.

U hebt uw registratietoken en een unieke tokennaam nodig.

Startmenu PowerShell ISE als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-az die u hebt gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 :
```
Import-Module .\RegisterWithAzure.psm1
```

Voer vervolgens de volgende PowerShell-cmdlets uit:

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

U kunt eventueel de Get-Content cmdlet gebruiken om te verwijzen naar een bestand dat uw registratietoken bevat.

U hebt uw registratietoken en een unieke tokennaam nodig.

Startmenu PowerShell ISE als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-az die u hebt gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 :
```
Import-Module .\RegisterWithAzure.psm1
```

Voer vervolgens de volgende PowerShell-cmdlets uit:

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

Notitie

Sla de naam van de registratieresource en het registratietoken op voor toekomstig gebruik.

Een activeringssleutel ophalen uit de Azure-registratieresource

Vervolgens moet u een activeringssleutel ophalen uit de registratieresource die in Azure is gemaakt tijdens Register-AzsEnvironment.

Voer de volgende PowerShell-cmdlets uit om de activeringssleutel op te halen:

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

Tip

De activeringssleutel wordt opgeslagen in het bestand dat is opgegeven voor $KeyOutputFilePath. U kunt het bestandspad of de bestandsnaam naar eigen goeddunken wijzigen.

Een activeringsresource maken in Azure Stack Hub

Ga terug naar de Azure Stack Hub-omgeving met het bestand of de tekst van de activeringssleutel die is gemaakt met Get-AzsActivationKey. Maak vervolgens een activeringsresource in Azure Stack Hub met behulp van die activeringssleutel. Voer de volgende PowerShell-cmdlets uit om een activeringsresource te maken:

$ActivationKey = "<activation key>"
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey

U kunt eventueel de Get-Content cmdlet gebruiken om te verwijzen naar een bestand dat uw registratietoken bevat:

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

Azure Stack Hub-registratie controleren

U kunt de tegel Regiobeheer gebruiken om te controleren of de Azure Stack Hub-registratie is geslaagd. Deze tegel is beschikbaar op het standaarddashboard in de beheerportal. De status kan worden geregistreerd of niet geregistreerd. Als deze is geregistreerd, wordt ook de Azure-abonnements-id weergegeven die u hebt gebruikt om uw Azure Stack Hub te registreren, samen met de registratieresourcegroep en -naam.

Meld u aan bij de Azure Stack Hub-beheerdersportal https://adminportal.local.azurestack.external.
Selecteer Regiobeheer in het dashboard.
Selecteer Eigenschappen. Op deze blade ziet u de status en details van uw omgeving. De status kan geregistreerd, Niet geregistreerd of Verlopen zijn.

Als deze zijn geregistreerd, zijn de eigenschappen onder andere:
- Registratieabonnement-id: de azure-abonnements-id die is geregistreerd en is gekoppeld aan Azure Stack Hub.
- Registratieresourcegroep: De Azure-resourcegroep in het bijbehorende abonnement met de Azure Stack Hub-resources.
U kunt de Azure Portal gebruiken om Azure Stack Hub-registratiebronnen weer te geven en vervolgens te controleren of de registratie is geslaagd. Meld u aan bij de Azure Portal met een account dat is gekoppeld aan het abonnement dat u hebt gebruikt om Azure Stack Hub te registreren. Selecteer Alle resources, schakel het selectievakje Verborgen typen weergeven in en selecteer de registratienaam.
Als de registratie niet is geslaagd, moet u zich opnieuw registreren door de stappen hier uit te voeren om het probleem op te lossen.

U kunt ook controleren of uw registratie is geslaagd met behulp van de marketplace-beheerfunctie. Als u een lijst met Marketplace-items ziet op de blade Marketplace-beheer, is uw registratie geslaagd. In niet-verbonden omgevingen kunt u marketplace-items echter niet zien in Marketplace-beheer.

Registratie verlengen of wijzigen

U moet uw registratie in de volgende omstandigheden bijwerken:

Nadat u uw jaarabonnement op basis van capaciteit hebt verlengd.
Wanneer u uw factureringsmodel wijzigt.
Wanneer u wijzigingen schaalt (knooppunten toevoegen/verwijderen) voor facturering op basis van capaciteit.

Vereisten

U hebt de volgende informatie van de beheerdersportal nodig om de registratie te vernieuwen of te wijzigen:

Beheerdersportal	Cmdlet-parameter	Notities
REGISTRATIEABONNEMENT-ID	Abonnement	Abonnements-id die tijdens de vorige registratie is gebruikt
REGISTRATIERESOURCEGROEP	ResourceGroupName	Resourcegroep waaronder de vorige registratieresource bestaat
REGISTRATIENAAM	RegistrationName	Registratienaam gebruikt tijdens eerdere registratie

Het abonnement wijzigen dat u gebruikt

Als u het abonnement wilt wijzigen dat u gebruikt, moet u eerst de cmdlet Remove-AzsRegistration uitvoeren en vervolgens controleren of u bent aangemeld bij de juiste Azure PowerShell context. Voer Vervolgens Set-AzsRegistration uit met gewijzigde parameters, waaronder <billing model>. Tijdens het uitvoeren van Remove-AzsRegistration moet u zijn aangemeld bij het abonnement dat wordt gebruikt tijdens de registratie en de waarden van de RegistrationName en ResourceGroupName parameters gebruiken, zoals wordt weergegeven in de beheerdersportal:

Az-modules
AzureRM-modules

# select the subscription used during the registration (shown in portal)
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
# 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>'

# select the subscription used during the registration (shown in portal)
Select-AzureRMSubscription -Subscription '<Registration subscription ID from portal>'
# 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-AzureRMSubscription -Subscription '<New subscription ID>'
# register
Set-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel '<Billing model>' -RegistrationName '<Registration name>' -ResourceGroupName '<Registration resource group name>'

Factureringsmodel wijzigen, hoe functies worden aangeboden of uw exemplaar opnieuw registreren

Deze sectie is van toepassing als u het factureringsmodel wilt wijzigen, hoe functies worden aangeboden of als u uw exemplaar opnieuw wilt registreren. In al deze gevallen roept u de registratiefunctie aan om de nieuwe waarden in te stellen. U hoeft de huidige registratie niet eerst te verwijderen. Meld u aan bij de abonnements-id die wordt weergegeven in de beheerdersportal en voer de registratie vervolgens opnieuw uit met een nieuwe BillingModel waarde, terwijl u de RegistrationName waarden en ResourceGroupName parameters hetzelfde houdt als weergegeven in de beheerdersportal:

Az-modules
AzureRM-modules

# select the subscription used during the registration
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
# 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>'

# select the subscription used during the registration
Select-AzureRMSubscription -Subscription '<Registration subscription ID from portal>'
# 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>'

U moet uw registratie in de volgende omstandigheden bijwerken of vernieuwen:

Nadat u uw jaarabonnement op basis van capaciteit hebt verlengd.
Wanneer u uw factureringsmodel wijzigt.
Wanneer u wijzigingen schaalt (knooppunten toevoegen/verwijderen) voor facturering op basis van capaciteit.

De activeringsresource verwijderen uit Azure Stack Hub

Eerst moet u de activeringsresource verwijderen uit Azure Stack Hub en vervolgens de registratieresource in Azure.

Als u de activeringsresource in Azure Stack Hub wilt verwijderen, voert u de volgende PowerShell-cmdlets uit in uw Azure Stack Hub-omgeving:

Remove-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint

Als u vervolgens de registratieresource in Azure wilt verwijderen, controleert u of u zich op een computer met Azure bevindt, meldt u zich aan bij de juiste Azure PowerShell context en voert u de juiste PowerShell-cmdlets uit, zoals hieronder wordt beschreven.

U kunt het registratietoken gebruiken dat wordt gebruikt om de resource te maken:

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

U kunt ook de naam van de registratie- en registratieresourcegroep gebruiken vanuit de beheerdersportal:

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

Opnieuw registreren met behulp van verbonden stappen

Als u uw factureringsmodel wijzigt van capaciteitsfacturering in een niet-verbonden status naar verbruiksfacturering, registreert u zich opnieuw volgens de stappen van het verbonden model.

Notitie

Dit verandert uw identiteitsmodel niet, alleen het factureringsmechanisme en u gebruikt AD FS nog steeds als uw identiteitsbron.

Opnieuw registreren met niet-verbonden stappen

U hebt de registratie nu volledig ongedaan gemaakt in een niet-verbonden scenario en moet de stappen herhalen voor het registreren van een Azure Stack Hub-omgeving in een niet-verbonden scenario.

Gebruiksrapportage uitschakelen of inschakelen

Voor Azure Stack Hub-omgevingen die gebruikmaken van een factureringsmodel voor capaciteit, schakelt u gebruiksrapportage uit met de parameter UsageReportingEnabled met behulp van de cmdlets Set-AzsRegistrationToken of Get-AzsRegistrationToken . Azure Stack Hub rapporteert standaard metrische gegevens over gebruik. Operators met capaciteitsgebruik of ondersteuning voor een niet-verbonden omgeving moeten gebruiksrapportage uitschakelen.

Voer de volgende PowerShell-cmdlets uit:

$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

Voer de volgende PowerShell-cmdlets uit om het registratietoken te wijzigen:

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

Gebruik het EA-overeenkomstnummer waar uw capaciteits-SKU-licenties zijn gekocht.

Tip

Het registratietoken wordt opgeslagen in het bestand dat is opgegeven voor $FilePathForRegistrationToken. U kunt het bestandspad of de bestandsnaam naar eigen goeddunken wijzigen.

Sla dit registratietoken op voor gebruik op de verbonden Azure-machine. U kunt het bestand of de tekst kopiëren vanuit $FilePathForRegistrationToken.

Een registratieresource verplaatsen

Het verplaatsen van een registratieresource tussen resourcegroepen onder hetzelfde abonnement wordt ondersteund voor alle omgevingen. Het verplaatsen van een registratieresource tussen abonnementen wordt echter alleen ondersteund voor CSP's wanneer beide abonnementen worden omgezet in dezelfde partner-id. Zie Resources verplaatsen naar nieuwe resourcegroep of nieuw abonnement voor meer informatie over het verplaatsen van resources naar een nieuwe resourcegroep.

Belangrijk

Om onbedoelde verwijdering van registratieresources in de portal te voorkomen, voegt het registratiescript automatisch een vergrendeling toe aan de resource. U moet deze vergrendeling verwijderen voordat u deze verplaatst of verwijdert. Het is raadzaam om een vergrendeling toe te voegen aan uw registratieresource om onbedoeld verwijderen te voorkomen.

Naslaginformatie over registratie

Set-AzsRegistration

U kunt Set-AzsRegistration gebruiken om Azure Stack Hub bij Azure te registreren en de aanbieding van items in marketplace en gebruiksrapportage in of uit te schakelen.

Als u de cmdlet wilt uitvoeren, hebt u het volgende nodig:

Een globaal Azure-abonnement van elk type.
Als u zich wilt aanmelden bij Azure PowerShell met een account dat eigenaar of inzender van dat abonnement is.

Set-AzsRegistration [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String> [[-AzureContext]
    <PSObject>] [[-ResourceGroupName] <String>] [[-ResourceGroupLocation] <String>] [[-BillingModel] <String>]
    [-MarketplaceSyndicationEnabled] [-UsageReportingEnabled] [[-AgreementNumber] <String>] [[-RegistrationName]
    <String>] [<CommonParameters>]

Parameter	Type	Description
PrivilegedEndpointCredential	PSCredential	De referenties die worden gebruikt voor toegang tot het bevoegde eindpunt. De gebruikersnaam heeft de indeling AzureStackDomain\CloudAdmin.
PrivilegedEndpoint	Tekenreeks	Een vooraf geconfigureerde externe PowerShell-console die u mogelijkheden biedt, zoals logboekverzameling en andere taken na de implementatie. Raadpleeg het artikel over het gebruik van het bevoegde eindpunt voor meer informatie.
AzureContext	PSObject
ResourceGroupName	Tekenreeks
ResourceGroupLocation	Tekenreeks
BillingModel	Tekenreeks	Het factureringsmodel dat uw abonnement gebruikt. Toegestane waarden voor deze parameter zijn: Capaciteit, PayAsYouUse en Ontwikkeling.
MarketplaceSyndicationEnabled	Waar/onwaar	Bepaalt of de marketplace-beheerfunctie beschikbaar is in de portal. Ingesteld op Waar als u zich registreert met internetverbinding. Ingesteld op onwaar als u zich registreert in niet-verbonden omgevingen. Voor niet-verbonden registraties kan het offline-syndicatiehulpprogramma worden gebruikt voor het downloaden van Marketplace-items.
UsageReportingEnabled	Waar/onwaar	Azure Stack Hub rapporteert standaard metrische gegevens over gebruik. Operators met capaciteitsgebruik of ondersteuning voor een niet-verbonden omgeving moeten gebruiksrapportage uitschakelen. Toegestane waarden voor deze parameter zijn: Waar, Onwaar.
AgreementNumber	Tekenreeks	Het nummer van de EA-overeenkomst waaronder de Capaciteits-SKU voor deze Azure Stack is besteld.
RegistrationName	Tekenreeks	Stel een unieke naam in voor de registratie als u het registratiescript uitvoert op meer dan één exemplaar van Azure Stack Hub met dezelfde Azure-abonnements-id. De parameter heeft een standaardwaarde van AzureStackRegistration. Als u echter dezelfde naam gebruikt voor meer dan één exemplaar van Azure Stack Hub, mislukt het script.

Get-AzsRegistrationToken

Get-AzsRegistrationToken genereert een registratietoken van de invoerparameters.

Get-AzsRegistrationToken [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String>
    [-BillingModel] <String> [[-TokenOutputFilePath] <String>] [-UsageReportingEnabled] [[-AgreementNumber] <String>]
    [<CommonParameters>]

Parameter	Type	Description
PrivilegedEndpointCredential	PSCredential	De referenties die worden gebruikt voor toegang tot het bevoegde eindpunt. De gebruikersnaam heeft de indeling AzureStackDomain\CloudAdmin.
PrivilegedEndpoint	Tekenreeks	Een vooraf geconfigureerde externe PowerShell-console die u mogelijkheden biedt, zoals logboekverzameling en andere taken na de implementatie. Raadpleeg het artikel over het gebruik van het bevoegde eindpunt voor meer informatie.
AzureContext	PSObject
ResourceGroupName	Tekenreeks
ResourceGroupLocation	Tekenreeks
BillingModel	Tekenreeks	Het factureringsmodel dat uw abonnement gebruikt. Toegestane waarden voor deze parameter zijn: Capaciteit, PayAsYouUse en Ontwikkeling.
MarketplaceSyndicationEnabled	Waar/onwaar
UsageReportingEnabled	Waar/onwaar	Azure Stack Hub rapporteert standaard metrische gegevens over gebruik. Operators met capaciteitsgebruik of ondersteuning voor een niet-verbonden omgeving moeten gebruiksrapportage uitschakelen. Toegestane waarden voor deze parameter zijn: Waar, Onwaar.
AgreementNumber	Tekenreeks

Registratiefouten

Mogelijk ziet u een van de onderstaande fouten bij het registreren van uw Azure Stack Hub:

Kan geen verplichte hardwaregegevens ophalen voor $hostName. Controleer de fysieke host en connectiviteit en voer de registratie opnieuw uit.
Kan geen verbinding maken om $hostName hardwaregegevens op te halen. Controleer de fysieke host en connectiviteit en voer de registratie opnieuw uit.

Oorzaak: dit komt meestal omdat we hardwaredetails zoals UUID, Bios en CPU van de hosts proberen te verkrijgen om te activeren en niet in staat waren om verbinding te maken met de fysieke host.
Cloud-id [GUID] is al geregistreerd. Het hergebruik van cloud-id's is niet toegestaan.

Oorzaak: dit gebeurt als uw Azure Stack-omgeving al is geregistreerd. Als u uw omgeving opnieuw wilt registreren bij een ander abonnement of factureringsmodel, volgt u de registratiestappen verlengen of wijzigen.
Wanneer u toegang probeert te krijgen tot Marketplace-beheer, treedt er een fout op wanneer u producten probeert te syndicateren.

Oorzaak: dit gebeurt meestal wanneer Azure Stack Hub geen toegang heeft tot de registratieresource. Een veelvoorkomende reden hiervoor is dat wanneer de directorytenant van een Azure-abonnement wordt gewijzigd, de registratie opnieuw wordt ingesteld. U hebt geen toegang tot azure Stack Hub Marketplace of rapportgebruik als u de directorytenant van het abonnement hebt gewijzigd. U moet zich opnieuw registreren om dit probleem op te lossen.

Marketplace-beheer vraagt u nog steeds om uw Azure Stack Hub te registreren en te activeren, zelfs wanneer u uw stempel al hebt geregistreerd met behulp van het niet-verbonden proces.

Oorzaak: dit is een bekend probleem voor niet-verbonden omgevingen en vereist dat u de registratiestatus controleert. Als u Marketplace-beheer wilt gebruiken, gebruikt u het offlinehulpprogramma.

Volgende stappen

Marketplace-items downloaden van Azure