Azure Stack Hub registreren bij Azure
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 treedt 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 Microsoft Entra-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 (als 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 deze 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 voor gedeelde EA-, CSP- of CSP-services worden ondersteund voor registratie. CSP's moeten beslissen of ze een CSP- of APSS-abonnement moeten gebruiken.
Als u de id wilt ophalen, gaat u naar 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 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).
De gebruiker die Azure Stack Hub registreert, is de eigenaar van de service-principal in Microsoft Entra ID. Alleen de gebruiker die Azure Stack Hub heeft geregistreerd, kan de Azure Stack Hub-registratie wijzigen. Alle andere gebruikers 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 dit een 403-antwoord tegenkomen. 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. Voor het registreren van Azure Stack Hub worden 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. Hierdoor kunt u het gebruik gemakkelijker bijhouden.
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 bevoegdheden 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 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 GitHub-opslagplaats voor Azure Stack Hub-hulpprogramma's bevat PowerShell-modules die azure Stack Hub-functionaliteit ondersteunen, inclusief registratiefunctionaliteit. Tijdens het registratieproces moet u de PowerShell-module RegisterWithAzure.psm1 (in de opslagplaats van de Azure Stack Hub-hulpprogramma's) importeren en gebruiken om uw Azure Stack Hub-exemplaar bij Azure te registreren.
Als u ervoor wilt 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 Het toegangswerkstation voor Azure Stack Hub-operatoren voor meer informatie.
Uw factureringsmodel bepalen
Met een verbonden implementatie kan Azure Stack Hub verbinding maken met internet en met Azure. U kunt ook Microsoft Entra ID 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 het factureringsmodel later op tijdens het uitvoeren van het registratiescript.
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 het factureringsmodel later op tijdens het uitvoeren van het registratiescript.
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 behulp van het factureringsmodel op basis van capaciteit moeten de unieke naam wijzigen wanneer ze opnieuw worden geregistreerd 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 betalen per gebruik-facturering
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 in Azure Stack Hub gebruiken 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.
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 Connect-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 Description EnvironmentName De naam van de omgeving van het Azure-cloudabonnement. Ondersteunde omgevingsnamen zijn AzureCloud, AzureUSGovernment of als u een China Azure-abonnement gebruikt, AzureChinaCloud. Notitie
Als uw sessie verloopt, is uw wachtwoord gewijzigd of wilt u gewoon van account wisselen, voert u de volgende cmdlet uit voordat u zich aanmeldt met Connect-AzAccount:
Remove-AzAccount-Scope ProcessAls 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-AzSubscriptionVoer de volgende opdracht uit om de Azure Stack Hub-resourceprovider te registreren in uw Azure-abonnement:
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStackStart PowerShell ISE als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-az die is gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 met behulp van PowerShell:
Import-Module .\RegisterWithAzure.psm1Voordat u doorgaat, controleert u in dezelfde PowerShell-sessie opnieuw of u bent aangemeld bij de juiste Azure PowerShell-context (zo niet, herhaalt u stap 2 en 3.) Deze context zou het Azure-account zijn 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 $RegistrationNameZie Registratieverwijzing 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
Al deze stappen moeten worden uitgevoerd vanaf een computer die toegang heeft tot het bevoegde eindpunt (PEP). Zie Het bevoegde eindpunt in Azure Stack Hub gebruiken 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.
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 Connect-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 -Environment "<environment name>"Parameter Description EnvironmentName De naam van de omgeving van het Azure-cloudabonnement. Ondersteunde omgevingsnamen zijn AzureCloud, AzureUSGovernment of als u een China Azure-abonnement 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-AzSubscriptionVoer de volgende opdracht uit om de Azure Stack Hub-resourceprovider te registreren in uw Azure-abonnement:
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStackStart PowerShell ISE als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-az die is gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 met behulp van PowerShell:
Import-Module .\RegisterwithAzure.psm1Voordat u doorgaat, controleert u in dezelfde PowerShell-sessie opnieuw of u bent aangemeld bij de juiste Azure PowerShell-context (zo niet, 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 $RegistrationNameGebruik 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 Registratieverwijzing 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
Start PowerShell ISE als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-az die is gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 :
Import-Module .\RegisterWithAzure.psm1Voer 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 $FilePathForRegistrationTokenGebruik het EA-overeenkomstnummer waar uw capaciteits-SKU-licenties zijn gekocht.
Zie Registratieverwijzing 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 uit $FilePathForRegistrationToken kopiëren.
Verbinding maken met 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 u wilt registreren 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.
Start PowerShell ISE als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-az die is gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 :
Import-Module .\RegisterWithAzure.psm1Voer vervolgens de volgende PowerShell-cmdlets uit:
$RegistrationToken = "<Your Registration Token>" $RegistrationName = "<unique-registration-name>" Register-AzsEnvironment -RegistrationToken $RegistrationToken -RegistrationName $RegistrationName
U kunt eventueel de cmdlet Get-Content gebruiken om te verwijzen naar een bestand dat uw registratietoken bevat.
U hebt uw registratietoken en een unieke tokennaam nodig.
Start PowerShell ISE als beheerder en navigeer naar de map Registratie in de map AzureStack-Tools-az die is gemaakt toen u de Azure Stack Hub-hulpprogramma's hebt gedownload. Importeer de module RegisterWithAzure.psm1 :
Import-Module .\RegisterWithAzure.psm1Voer 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 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 inzicht 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 vanuit 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:
# 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
U kunt eventueel de cmdlet Get-Content gebruiken om te verwijzen naar een bestand dat uw registratietoken bevat:
$ActivationKey = Get-Content -Path '<Path>\<Activation Key File>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey
Azure Stack Hub-registratie verifiëren
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 beheerdersportal. 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 worden de status en details van uw omgeving weergegeven. De status kan geregistreerd, niet geregistreerd of verlopen zijn.
Indien geregistreerd, zijn de eigenschappen onder andere:
- Registratieabonnement-id: de Azure-abonnements-id geregistreerd en gekoppeld aan Azure Stack Hub.
- Registratieresourcegroep: De Azure-resourcegroep in het bijbehorende abonnement met de Azure Stack Hub-resources.
U kunt Azure Portal gebruiken om Azure Stack Hub-registratiebronnen weer te geven en vervolgens te controleren of de registratie is geslaagd. Meld u aan bij 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 op de blade Marketplace-beheer ziet, 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 bijwerken in de volgende omstandigheden:
- Nadat u uw jaarlijkse abonnement op basis van capaciteit hebt verlengd.
- Wanneer u uw factureringsmodel wijzigt.
- Wanneer uw schaal verandert (knooppunten toevoegen/verwijderen) voor facturering op basis van capaciteit.
Notitie
Als proactieve logboekverzameling is ingeschakeld en u uw Azure Stack Hub-registratie verlengt of wijzigt, moet u proactieve logboekverzameling opnieuw inschakelen. Zie Diagnostische logboekverzameling voor meer informatie over proactieve logboekverzameling.
Vereisten
U hebt de volgende informatie van de beheerdersportal nodig om de registratie te vernieuwen of te wijzigen:
| Beheerdersportal | Cmdlet-parameter | Opmerkingen |
|---|---|---|
| REGISTRATIEABONNEMENTS-ID | Abonnement | Abonnements-id die tijdens de vorige registratie is gebruikt |
| REGISTRATIERESOURCEGROEP | ResourceGroupName | Resourcegroep waaronder de vorige registratieresource bestaat |
| REGISTRATIENAAM | RegistrationName | Registratienaam die tijdens de vorige registratie is gebruikt |
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 eventuele gewijzigde parameters, waaronder <billing model>. Tijdens het uitvoeren van Remove-AzsRegistration moet u zijn aangemeld bij het abonnement dat tijdens de registratie wordt gebruikt en waarden van de RegistrationName en ResourceGroupName parameters gebruiken, zoals wordt weergegeven in de beheerdersportal:
# 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>'
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 opnieuw uit met een nieuwe BillingModel waarde, terwijl de RegistrationName waarden en ResourceGroupName parameters hetzelfde blijven als in de beheerdersportal:
# 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>'
U moet uw registratie bijwerken of verlengen in de volgende omstandigheden:
- Nadat u uw jaarlijkse abonnement 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
U moet eerst de activeringsresource uit Azure Stack Hub verwijderen 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:
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
Remove-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint
Als u vervolgens de registratieresource in Azure wilt verwijderen, controleert u of u zich op een met Azure verbonden computer 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 beheerportal:
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 in een verbonden status, 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 behulp van 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
Schakel voor Azure Stack Hub-omgevingen die gebruikmaken van een capaciteitsfactureringsmodel gebruiksrapportage uit met de parameter UsageReportingEnabled met behulp van de cmdlets Set-AzsRegistration 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:
$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 $FilePathForRegistrationTokenGebruik 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 inzicht wijzigen.
Sla dit registratietoken op voor gebruik op de met Azure verbonden machine. U kunt het bestand of de tekst uit $FilePathForRegistrationToken kopiëren.
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 een nieuwe resourcegroep of een nieuw abonnement voor meer informatie over het verplaatsen van resources naar een nieuwe resourcegroep.
Belangrijk
Om te voorkomen dat registratieresources per ongeluk in de portal worden verwijderd, 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.
Registratiereferentie
Set-AzsRegistration
U kunt Set-AzsRegistration gebruiken om Azure Stack Hub bij Azure te registreren en de aanbieding van items in de marketplace en gebruiksrapportage in of uit te schakelen.
Als u de cmdlet wilt uitvoeren, hebt u het volgende nodig:
- Een Azure-abonnement van elk type.
- Als u zich wilt aanmelden bij Azure PowerShell met een account dat eigenaar of bijdrager is aan dat abonnement.
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 | String | Een vooraf geconfigureerde externe PowerShell-console die u mogelijkheden biedt, zoals logboekverzameling en andere taken na de implementatie. Raadpleeg het artikel over het bevoegde eindpunt voor meer informatie. |
| AzureContext | PSObject | |
| ResourceGroupName | String | |
| ResourceGroupLocation | String | |
| BillingModel | String | Het factureringsmodel dat uw abonnement gebruikt. Toegestane waarden voor deze parameter zijn: Capaciteit, PayAsYouUse en Ontwikkeling. |
| MarketplaceSyndicationEnabled | True/False | Bepaalt of de marketplace-beheerfunctie beschikbaar is in de portal. Ingesteld op waar als u zich registreert met een internetverbinding. Ingesteld op onwaar als u zich registreert in niet-verbonden omgevingen. Voor niet-verbonden registraties kan het hulpprogramma voor offline syndicatie worden gebruikt voor het downloaden van Marketplace-items. |
| UsageReportingEnabled | True/False | 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 | String | Het nummer van de EA-overeenkomst waaronder de capaciteits-SKU voor deze Azure Stack is besteld. |
| RegistrationName | String | 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 | String | Een vooraf geconfigureerde externe PowerShell-console die u mogelijkheden biedt, zoals logboekverzameling en andere taken na de implementatie. Raadpleeg het artikel over het bevoegde eindpunt voor meer informatie. |
| AzureContext | PSObject | |
| ResourceGroupName | String | |
| ResourceGroupLocation | String | |
| BillingModel | String | Het factureringsmodel dat uw abonnement gebruikt. Toegestane waarden voor deze parameter zijn: Capaciteit, Aangepast en Ontwikkeling. |
| MarketplaceSyndicationEnabled | True/False | |
| UsageReportingEnabled | True/False | 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 | String |
Registratiefouten
Mogelijk ziet u een van de onderstaande fouten tijdens het registreren van uw Azure Stack Hub:
Kan verplichte hardwaregegevens niet ophalen voor
$hostName. Controleer de fysieke host en connectiviteit en voer vervolgens de registratie opnieuw uit.Kan geen verbinding maken om hardwaregegevens op te
$hostNamehalen. Controleer de fysieke host en connectiviteit en voer vervolgens de registratie opnieuw uit.Oorzaak: We hebben geprobeerd om hardwaregegevens te verkrijgen, zoals UUID, Bios en CPU van de hosts om activering uit te voeren en zijn niet in staat om verbinding te maken met de fysieke host.
Cloud-id [
GUID] is al geregistreerd. Het opnieuw gebruiken 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.