Registrace služby Azure Stack Hub v Azure
Zaregistrujte službu Azure Stack Hub v Azure, abyste si mohli stáhnout položky z Azure Marketplace a nastavit sestavy obchodních dat zpět do Microsoftu. Po registraci služby Azure Stack Hub se využití ohlásí do obchodu Azure a uvidíte ho pod ID fakturačního předplatného Azure použitého k registraci.
Informace v tomto článku popisují registraci integrovaných systémů Služby Azure Stack Hub v Azure. Informace o registraci sady ASDK v Azure najdete v registraci služby Azure Stack Hub v dokumentaci k ASDK.
Důležité
Registrace se vyžaduje, aby podporovala úplné funkce služby Azure Stack Hub, včetně nabídek položek na marketplace. Pokud se při používání fakturačního modelu s průběžným platbou nezaregistrujete, dojde k porušení licenčních podmínek služby Azure Stack Hub. Další informace o licenčních modelech služby Azure Stack Hub najdete na stránce Jak koupit.
Poznámka:
Pro připojené registrace se vytvoří aplikace Microsoft Entra a přidružený instanční objekt v adresáři služby Active Directory přidruženém k registraci. Tento instanční objekt se používá pro scénáře Marketplace služby Azure Stack Hub (k zobrazení a stažení položek Azure Marketplace), nahrávání dat o využití (pokud je povolené vytváření sestav využití), shromažďování diagnostických protokolů a vzdálená podpora. Odebráním nebo změnou této aplikace nebo instančního objektu dochází k tomu, že tyto scénáře nefungují a nevyvolají se upozornění. Pokud se odstraní, můžete ho znovu vytvořit zrušením registrace a opětovnou registrací služby Azure Stack Hub v Azure.
Poznámka:
Synchronizace online marketplace, shromažďování diagnostických protokolů a vzdálená podpora nejsou k dispozici pro odpojené registrace. Musíte použít syndikaci offline marketplace.
Požadavky
Před registrací proveďte následující části požadavků:
- Ověřte své přihlašovací údaje.
- Nastavte režim jazyka PowerShellu.
- Nainstalujte PowerShell pro Azure Stack Hub.
- Stáhněte si nástroje služby Azure Stack Hub.
- Určení fakturačního modelu
- Určete jedinečný název registrace.
Ověření přihlašovacích údajů
Před registrací služby Azure Stack Hub v Azure musíte mít:
- ID předplatného pro předplatné Azure. Registrace se podporuje jenom u předplatných sdílených služeb EA, CSP nebo CSP. Poskytovatelé cloudových služeb se musí rozhodnout, jestli použít předplatné CSP nebo APSS.
Id získáte tak, že přejdete na web Azure Portal a vyberete Všechny služby > Obecné > předplatná, v seznamu zvolte předplatné, které chcete použít. V části Základy vyhledejte ID předplatného. Osvědčeným postupem je použít samostatná předplatná pro produkční a vývojová nebo testovací prostředí.
ID předplatného pro předplatné Azure. Registrace se podporuje jenom předplatná EA.
Id získáte tak, že přejdete na web Azure Portal a vyberete Všechny služby > Obecné > předplatná, v seznamu zvolte předplatné, které chcete použít. V části Základy vyhledejte ID předplatného. Osvědčeným postupem je použít samostatná předplatná pro produkční a vývojová nebo testovací prostředí.
Poznámka:
Německá cloudová předplatná se v současné době nepodporují.
Uživatelské jméno a heslo pro účet, který je vlastníkem předplatného.
Uživatelský účet musí mít přístup k předplatnému Azure a má oprávnění k vytváření aplikací identit a instančních objektů v adresáři přidruženém k danému předplatnému. Doporučujeme zaregistrovat službu Azure Stack Hub v Azure pomocí správy s nejnižšími oprávněními. Další informace o tom, jak vytvořit vlastní definici role, která omezuje přístup k vašemu předplatnému pro registraci, najdete v tématu Vytvoření registrační role pro Azure Stack Hub.
Zaregistrovali jste poskytovatele prostředků služby Azure Stack Hub (podrobnosti najdete v následující části Registrace poskytovatele prostředků služby Azure Stack Hub).
Uživatel, který zaregistruje službu Azure Stack Hub, je vlastníkem instančního objektu v Microsoft Entra ID. Registraci služby Azure Stack Hub může upravit pouze uživatel, který zaregistroval službu Azure Stack Hub. Všichni ostatní uživatelé musí být přidáni do výchozího předplatného poskytovatele prostřednictvím řízení přístupu (IAM). Pokud se uživatel bez oprávnění správce, který není vlastníkem registračního instančního objektu, pokusí zaregistrovat nebo znovu zaregistrovat službu Azure Stack Hub, může narazit na odpověď 403. Odpověď 403 znamená, že uživatel nemá dostatečná oprávnění k dokončení operace.
Pokud nemáte předplatné Azure, které splňuje tyto požadavky, můžete tady vytvořit bezplatný účet Azure. Při registraci služby Azure Stack Hub se neúčtují žádné náklady na vaše předplatné Azure.
Poznámka:
Pokud máte více než jednu službu Azure Stack Hub, osvědčeným postupem je zaregistrovat každou službu Azure Stack Hub do vlastního předplatného. Díky tomu budete snadněji sledovat využití.
Nastavení režimu jazyka PowerShellu
Pokud chcete úspěšně zaregistrovat Azure Stack Hub, musí být režim jazyka PowerShellu nastavený na FullLanguage. Pokud chcete ověřit, že je aktuální režim jazyka nastavený na plný, otevřete okno PowerShellu se zvýšenými oprávněními a spusťte následující rutiny PowerShellu:
$ExecutionContext.SessionState.LanguageMode
Ujistěte se, že výstup vrací FullLanguage. Pokud se vrátí jakýkoli jiný režim jazyka, musí být registrace spuštěna na jiném počítači nebo musí být režim jazyka před pokračováním nastaven na FullLanguage .
Instalace PowerShellu pro Azure Stack Hub
K registraci v Azure použijte nejnovější PowerShell pro Azure Stack Hub.
Pokud ještě není nainstalovaná nejnovější verze, přečtěte si článek o instalaci PowerShellu pro Azure Stack Hub.
Stažení nástrojů služby Azure Stack Hub
Úložiště nástrojů Služby Azure Stack Hub na GitHubu obsahuje moduly PowerShellu, které podporují funkce služby Azure Stack Hub, včetně funkcí registrace. Během procesu registrace musíte importovat a používat modul PowerShellu RegisterWithAzure.psm1 (v úložišti nástrojů služby Azure Stack Hub) k registraci instance služby Azure Stack Hub v Azure.
Abyste měli jistotu, že používáte nejnovější verzi, odstraňte všechny existující verze nástrojů služby Azure Stack Hub a před registrací do Azure stáhněte nejnovější verzi z GitHubu .
Poznámka:
K přístupu k privilegovanému koncovému bodu (PEP), portálu pro správu pro scénáře podpory a nástrojů GitHubu služby Azure Stack Hub můžete použít také pracovní stanici OAW (Operator Access Workstation). Další informace najdete v tématu Pracovní stanice operátora služby Azure Stack Hub.
Určení fakturačního modelu
Připojené nasazení umožňuje službě Azure Stack Hub připojit se k internetu a k Azure. Jako úložiště identit můžete také použít Microsoft Entra ID nebo Active Directory Federation Services (AD FS) (AD FS) a vybrat si ze dvou fakturačních modelů: s průběžným platbami nebo na základě kapacity. Fakturační model zadáte později při spuštění registračního skriptu.
Odpojené nasazení umožňuje používat Službu Azure Stack Hub bez připojení k internetu. S odpojeným nasazením jste omezeni na úložiště identit služby AD FS a model fakturace založený na kapacitě. Fakturační model zadáte později při spuštění registračního skriptu.
Určení jedinečného názvu registrace
Při spuštění registračního skriptu musíte zadat jedinečný název registrace. Snadný způsob, jak přidružit předplatné služby Azure Stack Hub k registraci Azure, je použít ID cloudu služby Azure Stack Hub.
Poznámka:
Registrace služby Azure Stack Hub pomocí fakturačního modelu založeného na kapacitě budou muset při opětovné registraci po uplynutí těchto ročních předplatných změnit jedinečný název, pokud neodstraníte prošlou registraci a znovu se zaregistrujete v Azure.
Pokud chcete zjistit ID cloudu pro nasazení služby Azure Stack Hub, přečtěte si téma Vyhledání ID cloudu.
Registrace s fakturací s průběžnými platbami
Pomocí těchto kroků zaregistrujte službu Azure Stack Hub v Azure pomocí fakturačního modelu s průběžnými platbami.
Poznámka:
Všechny tyto kroky musí být spouštěné z počítače, který má přístup k privilegovanému koncovému bodu . Podrobnosti o privilegovaném koncovém bodu najdete v tématu Použití privilegovaného koncového bodu ve službě Azure Stack Hub.
Připojená prostředí mají přístup k internetu a Azure. V těchto prostředích musíte zaregistrovat poskytovatele prostředků Azure Stack Hub v Azure a pak nakonfigurovat fakturační model.
Pokud chcete zaregistrovat poskytovatele prostředků Služby Azure Stack Hub v Azure, spusťte prostředí PowerShell ISE jako správce a použijte následující rutiny PowerShellu s parametrem EnvironmentName nastaveným na příslušný typ předplatného Azure (viz parametry níže).
Přidejte účet Azure, který jste použili k registraci služby Azure Stack Hub. Pokud chcete přidat účet, spusťte rutinu Connect-AzAccount . Zobrazí se výzva k zadání přihlašovacích údajů k účtu Azure a možná budete muset na základě konfigurace vašeho účtu použít dvojúrovňové ověřování.
Connect-AzAccount -EnvironmentName "<environment name>"
Parametr Popis EnvironmentName Název prostředí cloudového předplatného Azure. Podporované názvy prostředí jsou AzureCloud, AzureUSGovernment nebo pokud používáte předplatné Azure v Číně, AzureChinaCloud. Poznámka:
Pokud platnost relace vyprší, vaše heslo se změnilo nebo chcete jednoduše přepnout účty, spusťte před přihlášením pomocí Connect-AzAccount následující rutinu:
Remove-AzAccount-Scope Process
Pokud máte více předplatných, spusťte následující příkaz a vyberte předplatné, které chcete použít:
Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription
Spuštěním následujícího příkazu zaregistrujte poskytovatele prostředků Služby Azure Stack Hub ve vašem předplatném Azure:
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack
Spusťte prostředí PowerShell ISE jako správce a přejděte do složky Registrace v adresáři AzureStack-Tools-az , který jste vytvořili při stahování nástrojů služby Azure Stack Hub. Importujte modul RegisterWithAzure.psm1 pomocí PowerShellu:
Import-Module .\RegisterWithAzure.psm1
Než budete pokračovat, ověřte ve stejné relaci PowerShellu znovu, že jste přihlášení ke správnému kontextu Azure PowerShellu (pokud ne, opakujte kroky 2 a 3.) Tento kontext by byl účet Azure použitý k registraci poskytovatele prostředků služby Azure Stack Hub dříve. Ve stejné relaci PowerShellu spusťte rutinu 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
Další informace o rutině Set-AzsRegistration najdete v referenčních informacích k registraci.
Proces trvá 10 až 15 minut. Po dokončení příkazu se zobrazí zpráva "Vaše prostředí je nyní zaregistrováno a aktivováno pomocí zadaných parametrů".
Registrace s fakturací kapacity
Pomocí těchto kroků zaregistrujte službu Azure Stack Hub v Azure pomocí modelu fakturace kapacity.
Poznámka:
Všechny tyto kroky musí být spouštěné z počítače, který má přístup k privilegovanému koncovému bodu . Podrobnosti o privilegovaném koncovém bodu najdete v tématu Použití privilegovaného koncového bodu ve službě Azure Stack Hub.
Připojená prostředí mají přístup k internetu a Azure. V těchto prostředích musíte zaregistrovat poskytovatele prostředků Azure Stack Hub v Azure a pak nakonfigurovat fakturační model.
Pokud chcete zaregistrovat poskytovatele prostředků Služby Azure Stack Hub v Azure, spusťte prostředí PowerShell ISE jako správce a použijte následující rutiny PowerShellu s parametrem EnvironmentName nastaveným na příslušný typ předplatného Azure (viz parametry níže).
Přidejte účet Azure, který jste použili k registraci služby Azure Stack Hub. Pokud chcete přidat účet, spusťte rutinu Connect-AzAccount . Zobrazí se výzva k zadání přihlašovacích údajů k účtu Azure a možná budete muset na základě konfigurace vašeho účtu použít dvojúrovňové ověřování.
Connect-AzAccount -Environment "<environment name>"
Parametr Popis EnvironmentName Název prostředí cloudového předplatného Azure. Podporované názvy prostředí jsou AzureCloud, AzureUSGovernment nebo pokud používáte předplatné Azure v Číně, AzureChinaCloud. Pokud máte více předplatných, spusťte následující příkaz a vyberte předplatné, které chcete použít:
Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription
Spuštěním následujícího příkazu zaregistrujte poskytovatele prostředků Služby Azure Stack Hub ve vašem předplatném Azure:
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack
Spusťte prostředí PowerShell ISE jako správce a přejděte do složky Registrace v adresáři AzureStack-Tools-az, který jste vytvořili při stahování nástrojů služby Azure Stack Hub. Importujte modul RegisterWithAzure.psm1 pomocí PowerShellu:
Import-Module .\RegisterwithAzure.psm1
Než budete pokračovat, ověřte ve stejné relaci PowerShellu znovu, že jste přihlášení ke správnému kontextu Azure PowerShellu (pokud ne, opakujte kroky 2 a 3.) Tento kontext je účet Azure, který se použil k registraci poskytovatele prostředků služby Azure Stack Hub. Ve stejné relaci PowerShellu spusťte rutinu 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
Použijte číslo smlouvy EA, kde byly zakoupeny licence skladové položky kapacity.
Poznámka:
Generování sestav využití s parametrem UsageReportingEnabled pro rutinu Set-AzsRegistration můžete zakázat nastavením parametru na false.
Další informace o rutině Set-AzsRegistration najdete v referenčních informacích k registraci.
Registrace s fakturací kapacity
Pokud registrujete Službu Azure Stack Hub v odpojeném prostředí (bez připojení k internetu), musíte získat registrační token z prostředí služby Azure Stack Hub. Potom tento token použijte na počítači, který se může připojit k Azure a má nainstalovaný PowerShell pro Azure Stack Hub.
Získání registračního tokenu z prostředí služby Azure Stack Hub
Spusťte prostředí PowerShell ISE jako správce a přejděte do složky Registrace v adresáři AzureStack-Tools-az , který jste vytvořili při stahování nástrojů služby Azure Stack Hub. Import modulu RegisterWithAzure.psm1:
Import-Module .\RegisterWithAzure.psm1
Pokud chcete získat registrační token, spusťte následující rutiny PowerShellu:
$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
Použijte číslo smlouvy EA, kde byly zakoupeny licence skladové položky kapacity.
Další informace o rutině Get-AzsRegistrationToken najdete v referenčních informacích k registraci.
Tip
Registrační token se uloží do souboru určeného pro $FilePathForRegistrationToken. Cestu k souboru nebo název souboru můžete podle vlastního uvážení změnit.
Uložte tento registrační token pro použití na počítači připojeném k Azure. Soubor nebo text můžete zkopírovat z $FilePathForRegistrationToken.
Připojení k Azure a registrace
Na počítači připojeném k internetu naimportujte modul RegisterWithAzure.psm1 stejným postupem a přihlaste se ke správnému kontextu Azure PowerShellu. Pak zavolejte Register-AzsEnvironment. Zadejte registrační token, který se má zaregistrovat v Azure. Pokud registrujete více instancí služby Azure Stack Hub pomocí stejného ID předplatného Azure, zadejte jedinečný název registrace.
Potřebujete registrační token a jedinečný název tokenu.
Spusťte prostředí PowerShell ISE jako správce a přejděte do složky Registrace v adresáři AzureStack-Tools-az , který jste vytvořili při stahování nástrojů služby Azure Stack Hub. Import modulu RegisterWithAzure.psm1:
Import-Module .\RegisterWithAzure.psm1
Pak spusťte následující rutiny PowerShellu:
$RegistrationToken = "<Your Registration Token>" $RegistrationName = "<unique-registration-name>" Register-AzsEnvironment -RegistrationToken $RegistrationToken -RegistrationName $RegistrationName
Volitelně můžete pomocí rutiny Get-Content odkazovat na soubor, který obsahuje váš registrační token.
Potřebujete registrační token a jedinečný název tokenu.
Spusťte prostředí PowerShell ISE jako správce a přejděte do složky Registrace v adresáři AzureStack-Tools-az , který jste vytvořili při stahování nástrojů služby Azure Stack Hub. Import modulu RegisterWithAzure.psm1:
Import-Module .\RegisterWithAzure.psm1
Pak spusťte následující rutiny PowerShellu:
$RegistrationToken = Get-Content -Path '<Path>\<Registration Token File>' Register-AzsEnvironment -RegistrationToken $RegistrationToken -RegistrationName $RegistrationName
Poznámka:
Uložte název prostředku registrace a registrační token pro budoucí referenci.
Načtení aktivačního klíče z registračního prostředku Azure
Dále je potřeba načíst aktivační klíč z registračního prostředku vytvořeného v Azure během registrace Register-AzsEnvironment.
Aktivační klíč získáte spuštěním následujících rutin PowerShellu:
$RegistrationResourceName = "<unique-registration-name>"
$KeyOutputFilePath = "$env:SystemDrive\ActivationKey.txt"
$ActivationKey = Get-AzsActivationKey -RegistrationName $RegistrationResourceName -KeyOutputFilePath $KeyOutputFilePath
Tip
Aktivační klíč se uloží do souboru určeného pro $KeyOutputFilePath. Cestu k souboru nebo název souboru můžete podle vlastního uvážení změnit.
Vytvoření aktivačního prostředku ve službě Azure Stack Hub
Vraťte se do prostředí služby Azure Stack Hub se souborem nebo textem z aktivačního klíče vytvořeného z get-AzsActivationKey. Potom pomocí aktivačního klíče vytvořte prostředek aktivace ve službě Azure Stack Hub. Pokud chcete vytvořit aktivační prostředek, spusťte následující rutiny PowerShellu:
# 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
Volitelně můžete pomocí rutiny Get-Content odkazovat na soubor, který obsahuje váš registrační token:
$ActivationKey = Get-Content -Path '<Path>\<Activation Key File>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey
Ověření registrace služby Azure Stack Hub
Dlaždici Správa oblastí můžete použít k ověření úspěšné registrace služby Azure Stack Hub. Tato dlaždice je dostupná na výchozím řídicím panelu na portálu pro správu. Stav je možné zaregistrovat nebo neregistrovat. Pokud je zaregistrované, zobrazí se také ID předplatného Azure, které jste použili k registraci služby Azure Stack Hub spolu se skupinou prostředků a názvem registrace.
Přihlaste se k portálu
https://adminportal.local.azurestack.external
pro správu služby Azure Stack Hub.Na řídicím panelu vyberte Správa oblastí.
Vyberte Vlastnosti. V tomto okně se zobrazí stav a podrobnosti o vašem prostředí. Stav může být Zaregistrovaný, Nezaregistrovaný nebo Vypršela platnost.
Pokud jsou zaregistrované, zahrnují tyto vlastnosti:
- ID předplatného registrace: ID předplatného Azure zaregistrované a přidružené ke službě Azure Stack Hub.
- Skupina prostředků registrace: Skupina prostředků Azure v přidruženém předplatném, které obsahuje prostředky služby Azure Stack Hub.
Pomocí webu Azure Portal můžete zobrazit registrační prostředky služby Azure Stack Hub a ověřit, že registrace proběhla úspěšně. Přihlaste se k webu Azure Portal pomocí účtu přidruženého k předplatnému, které jste použili k registraci služby Azure Stack Hub. Vyberte Všechny prostředky, zaškrtněte políčko Zobrazit skryté typy a vyberte název registrace.
Pokud se registrace nepovedla, musíte se znovu zaregistrovat podle kroků uvedených tady , abyste tento problém vyřešili.
Případně můžete ověřit, jestli registrace proběhla úspěšně, pomocí funkce správy Marketplace. Pokud se v okně pro správu Marketplace zobrazí seznam položek marketplace, registrace byla úspěšná. V odpojených prostředích se ale ve správě Marketplace nezobrazují položky marketplace.
Prodloužení nebo změna registrace
Registraci musíte aktualizovat za následujících okolností:
- Po prodloužení ročního předplatného založeného na kapacitě.
- Když změníte fakturační model.
- Když se škálování změní (přidá nebo odebere uzly) pro fakturaci na základě kapacity.
Poznámka:
Pokud je aktivní shromažďování protokolů povolené a prodlužujete nebo měníte registraci služby Azure Stack Hub, musíte znovu povolit proaktivní shromažďování protokolů. Další informace o proaktivní shromažďování protokolů najdete v tématu Shromažďování diagnostických protokolů.
Požadavky
K prodloužení nebo změně registrace potřebujete na portálu pro správu následující informace:
Portál správce | Parametr rutiny | Notes |
---|---|---|
ID REGISTRAČNÍHO PŘEDPLATNÉHO | Předplatné | ID předplatného použité během předchozí registrace |
SKUPINA PROSTŘEDKŮ REGISTRACE | ResourceGroupName | Skupina prostředků, ve které existuje předchozí prostředek registrace |
NÁZEV REGISTRACE | RegistrationName | Název registrace použitý během předchozí registrace |
Změna předplatného, které používáte
Pokud chcete změnit předplatné, které používáte, musíte nejprve spustit rutinu Remove-AzsRegistration a pak se ujistit, že jste přihlášeni ke správnému kontextu Azure PowerShellu. Potom spusťte Set-AzsRegistration s libovolnými změněnými parametry, včetně <billing model>
. Při spuštění příkazu Remove-AzsRegistration musíte být přihlášení k předplatnému použitému během registrace a používat hodnoty a ResourceGroupName
parametryRegistrationName
, jak je znázorněno na portálu pro správu:
# 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>'
Změna modelu fakturace, nabízení funkcí nebo opětovné registrace vaší instance
Tato část platí, pokud chcete změnit model fakturace, způsob nabízení funkcí nebo chcete svoji instanci znovu zaregistrovat. U všech těchto případů zavoláte registrační funkci, která nastaví nové hodnoty. Aktuální registraci nemusíte nejdřív odebrat. Přihlaste se k ID předplatného zobrazenému na portálu pro správu a pak znovu spusťte registraci s novou BillingModel
hodnotou a přitom ponechte RegistrationName
hodnoty parametrů ResourceGroupName
stejné jako na portálu pro správu:
# 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>'
Registraci musíte aktualizovat nebo obnovit za následujících okolností:
- Po prodloužení ročního předplatného založeného na kapacitě.
- Když změníte fakturační model.
- Když škálujete změny (přidáte nebo odeberete uzly) pro fakturaci na základě kapacity.
Odebrání aktivačního prostředku ze služby Azure Stack Hub
Nejprve je potřeba odebrat aktivační prostředek ze služby Azure Stack Hub a pak prostředek registrace v Azure.
Pokud chcete odebrat aktivační prostředek ve službě Azure Stack Hub, spusťte v prostředí Azure Stack Hub následující rutiny PowerShellu:
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
Remove-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint
Pokud chcete odebrat prostředek registrace v Azure, ujistěte se, že jste na počítači připojeném k Azure, přihlaste se ke správnému kontextu Azure PowerShellu a spusťte příslušné rutiny PowerShellu, jak je popsáno níže.
K vytvoření prostředku můžete použít registrační token:
$RegistrationToken = "<registration token>"
Unregister-AzsEnvironment -RegistrationToken $RegistrationToken
Nebo můžete použít název registrace a název skupiny prostředků registrace z portálu pro správu:
Unregister-AzsEnvironment -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'
Opětovné registrace pomocí připojených kroků
Pokud měníte fakturační model z fakturace kapacity v odpojeném stavu na fakturaci spotřeby v připojeném stavu, znovu se zaregistrujte podle připojených kroků modelu.
Poznámka:
Tím se nezmění model identity, pouze fakturační mechanismus a jako zdroj identity budete dál používat službu AD FS.
Opětovné registrace pomocí odpojených kroků
Nyní jste úplně neregistrovali odpojený scénář a musíte zopakovat kroky pro registraci prostředí služby Azure Stack Hub v odpojené situaci.
Zakázání nebo povolení generování sestav využití
Pro prostředí služby Azure Stack Hub, která používají model fakturace kapacity, vypněte generování sestav využití pomocí parametru UsageReportingEnabled pomocí rutin Set-AzsRegistration nebo Get-AzsRegistrationToken. Azure Stack Hub ve výchozím nastavení hlásí metriky využití. Operátoři s kapacitou používají nebo podporují odpojené prostředí, musí vypnout generování sestav využití.
Spusťte následující rutiny PowerShellu:
$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
Pokud chcete změnit registrační token, spusťte následující rutiny PowerShellu:
$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
Použijte číslo smlouvy EA, kde byly zakoupeny licence skladové položky kapacity.
Tip
Registrační token se uloží do souboru určeného pro $FilePathForRegistrationToken. Cestu k souboru nebo název souboru můžete podle vlastního uvážení změnit.
Uložte tento registrační token pro použití na připojeném počítači Azure. Soubor nebo text můžete zkopírovat z $FilePathForRegistrationToken.
Přesun prostředku registrace
Přesun registračního prostředku mezi skupinami prostředků v rámci stejného předplatného se podporuje pro všechna prostředí. Přesun registračního prostředku mezi předplatnými se ale podporuje jenom u poskytovatelů CSP, když se obě předplatná přeloží na stejné ID partnera. Další informace o přesunu prostředků do nové skupiny prostředků najdete v tématu Přesunutí prostředků do nové skupiny prostředků nebo předplatného.
Důležité
Aby se zabránilo náhodnému odstranění prostředků registrace na portálu, skript pro registraci automaticky přidá k prostředku zámek. Před přesunutím nebo odstraněním je nutné tento zámek odebrat. Doporučujeme přidat zámek do registračního prostředku, abyste zabránili náhodnému odstranění.
Referenční informace k registraci
Set-AzsRegistration
Sadu AzsRegistration můžete použít k registraci služby Azure Stack Hub v Azure a povolení nebo zakázání nabídky položek na marketplace a generování sestav využití.
Ke spuštění rutiny potřebujete:
- Předplatné Azure libovolného typu.
- Pokud se chcete přihlásit k Azure PowerShellu pomocí účtu, který je vlastníkem nebo přispěvatelem daného předplatného.
Set-AzsRegistration [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String> [[-AzureContext]
<PSObject>] [[-ResourceGroupName] <String>] [[-ResourceGroupLocation] <String>] [[-BillingModel] <String>]
[-MarketplaceSyndicationEnabled] [-UsageReportingEnabled] [[-AgreementNumber] <String>] [[-RegistrationName]
<String>] [<CommonParameters>]
Parametr | Typ | Popis |
---|---|---|
PrivilegedEndpointCredential | PsCredential | Přihlašovací údaje používané pro přístup k privilegovanému koncovému bodu. Uživatelské jméno je ve formátu AzureStackDomain\CloudAdmin. |
PrivilegedEndpoint | String | Předem nakonfigurovaná vzdálená konzola PowerShellu, která poskytuje funkce, jako je shromažďování protokolů a další úlohy po nasazení. Další informace najdete v článku o privilegovaném koncovém bodu . |
AzureContext | Objekt PSObject | |
ResourceGroupName | String | |
ResourceGroupLocation | String | |
Model fakturace | String | Fakturační model, který vaše předplatné používá. Povolené hodnoty pro tento parametr jsou: Capacity, PayAsYouUse a Development. |
MarketplaceSyndicationEnabled | True/false | Určuje, jestli je funkce správy marketplace dostupná na portálu. Pokud se zaregistrujete s připojením k internetu, nastavte na hodnotu true. Pokud se registrujete v odpojených prostředích, nastavte na hodnotu false. Pro odpojené registrace se dá offline nástroj syndikace použít ke stahování položek z marketplace. |
UsageReportingEnabled | True/false | Azure Stack Hub ve výchozím nastavení hlásí metriky využití. Operátoři s kapacitou používají nebo podporují odpojené prostředí, musí vypnout generování sestav využití. Povolené hodnoty pro tento parametr jsou: True, False. |
Číslo smlouvy | String | Počet smluv EA, podle kterých byla skladová položka kapacity pro tuto službu Azure Stack objednána. |
RegistrationName | String | Pokud spouštíte registrační skript ve více instancích služby Azure Stack Hub pomocí stejného ID předplatného Azure, nastavte jedinečný název registrace pro registraci. Parametr má výchozí hodnotu AzureStackRegistration. Pokud ale použijete stejný název ve více než jedné instanci služby Azure Stack Hub, skript selže. |
Get-AzsRegistrationToken
Get-AzsRegistrationToken vygeneruje registrační token ze vstupních parametrů.
Get-AzsRegistrationToken [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String>
[-BillingModel] <String> [[-TokenOutputFilePath] <String>] [-UsageReportingEnabled] [[-AgreementNumber] <String>]
[<CommonParameters>]
Parametr | Typ | Popis |
---|---|---|
PrivilegedEndpointCredential | PsCredential | Přihlašovací údaje používané pro přístup k privilegovanému koncovému bodu. Uživatelské jméno je ve formátu AzureStackDomain\CloudAdmin. |
PrivilegedEndpoint | String | Předem nakonfigurovaná vzdálená konzola PowerShellu, která poskytuje funkce, jako je shromažďování protokolů a další úlohy po nasazení. Další informace najdete v článku o privilegovaném koncovém bodu . |
AzureContext | Objekt PSObject | |
ResourceGroupName | String | |
ResourceGroupLocation | String | |
Model fakturace | String | Fakturační model, který vaše předplatné používá. Povolené hodnoty pro tento parametr jsou: Kapacita, Vlastní a Vývoj. |
MarketplaceSyndicationEnabled | True/false | |
UsageReportingEnabled | True/false | Azure Stack Hub ve výchozím nastavení hlásí metriky využití. Operátoři s kapacitou používají nebo podporují odpojené prostředí, musí vypnout generování sestav využití. Povolené hodnoty pro tento parametr jsou: True, False. |
Číslo smlouvy | String |
Selhání registrace
Při pokusu o registraci služby Azure Stack Hub se může zobrazit jedna z následujících chyb:
Nepodařilo se načíst povinné hardwarové informace pro
$hostName
. Zkontrolujte fyzického hostitele a připojení a zkuste znovu spustit registraci.Nejde se připojit, abyste
$hostName
získali informace o hardwaru. Zkontrolujte fyzického hostitele a připojení a zkuste znovu spustit registraci.Příčina: Pokusili jsme se získat podrobnosti o hardwaru, jako je UUID, Bios a procesor od hostitelů, a pokusili jsme se o aktivaci a kvůli nemožnosti připojit se k fyzickému hostiteli.
Identifikátor cloudu [
GUID
] je již zaregistrovaný. Opětovné nasazení cloudových identifikátorů není povolené.Příčina: K tomu dochází, pokud už je vaše prostředí Azure Stack zaregistrované. Pokud chcete prostředí znovu zaregistrovat s jiným předplatným nebo fakturačním modelem, postupujte podle pokynů k prodloužení nebo změně registrace.
Při pokusu o přístup ke správě Marketplace dojde k chybě při pokusu o syndikaci produktů.
Příčina: K tomu obvykle dochází v případě, že azure Stack Hub nemá přístup k registračnímu prostředku. Jedním z běžných důvodů je to, že když se změní tenant adresáře předplatného Azure, resetuje registraci. Pokud jste změnili tenanta adresáře předplatného, nemůžete získat přístup k marketplace služby Azure Stack Hub ani k využití sestavy. Pokud chcete tento problém vyřešit, musíte se znovu zaregistrovat.
Správa Marketplace vás stále žádá o registraci a aktivaci služby Azure Stack Hub, i když jste už zaregistrovali razítko pomocí odpojeného procesu.
Příčina: Jedná se o známý problém pro odpojená prostředí a vyžaduje ověření stavu registrace. Pokud chcete používat správu Marketplace, použijte offline nástroj.