Udostępnij za pośrednictwem

Rejestrowanie usługi Azure Stack Hub na platformie Azure

  • Artykuł

Zarejestruj usługę Azure Stack Hub na platformie Azure, aby można było pobrać elementy witryny Azure Marketplace z platformy Azure i skonfigurować raportowanie danych handlowych z powrotem do firmy Microsoft. Po zarejestrowaniu usługi Azure Stack Hub użycie jest zgłaszane do handlu platformy Azure i można je zobaczyć w obszarze identyfikatora subskrypcji rozliczeniowej platformy Azure używanego do rejestracji.

Informacje w tym artykule opisano rejestrowanie zintegrowanych systemów usługi Azure Stack Hub z platformą Azure. Aby uzyskać informacje na temat rejestrowania zestawu ASDK na platformie Azure, zobacz Rejestracja w usłudze Azure Stack Hub w dokumentacji zestawu ASDK.

Ważne

Rejestracja jest wymagana do obsługi pełnej funkcjonalności usługi Azure Stack Hub, w tym ofert w witrynie Marketplace. Jeśli nie zarejestrujesz się podczas korzystania z modelu rozliczeniowego z płatnością zgodnie z rzeczywistym użyciem, naruszenie postanowień licencyjnych usługi Azure Stack Hub. Aby dowiedzieć się więcej na temat modeli licencjonowania usługi Azure Stack Hub, zobacz stronę Jak kupić.

Uwaga

W przypadku rejestracji połączonych aplikacja Microsoft Entra i skojarzona jednostka usługi jest tworzona w katalogu usługi Active Directory skojarzonym z rejestracją. Ta jednostka usługi jest używana w scenariuszach witryny Azure Stack Hub Marketplace (w celu wyświetlania i pobierania elementów witryny Azure Marketplace), przekazywania danych użycia (jeśli jest włączona funkcja Raportowanie użycia), zbierania dzienników diagnostycznych i obsługi zdalnej. Usunięcie lub zmiana tej aplikacji lub jednostki usługi powoduje, że te scenariusze nie działają, a alerty są zgłaszane. Jeśli zostanie on usunięty, można go ponownie utworzyć , wyrejestrując, a następnie ponownie zarejestruj usługę Azure Stack Hub na platformie Azure.

Uwaga

Syndykacja na platformie handlowej online, zbieranie dzienników diagnostycznych i zdalna obsługa techniczna są niedostępne w przypadku rozłączonych rejestracji. Musisz użyć syndykacji w witrynie Marketplace w trybie offline.

Wymagania wstępne

Przed zarejestrowaniem wykonaj następujące sekcje wymagań wstępnych:

  • Zweryfikuj poświadczenia.
  • Ustaw tryb języka programu PowerShell.
  • Zainstaluj program PowerShell dla usługi Azure Stack Hub.
  • Pobierz narzędzia usługi Azure Stack Hub.
  • Określanie modelu rozliczeniowego.
  • Określ unikatową nazwę rejestracji.

Weryfikowanie poświadczeń

Przed zarejestrowaniem usługi Azure Stack Hub na platformie Azure musisz mieć następujące elementy:

  • Identyfikator subskrypcji subskrypcji platformy Azure. Do rejestracji są obsługiwane tylko subskrypcje usług udostępnionych EA, CSP lub CSP. Dostawcy CSP muszą zdecydować, czy używać subskrypcji CSP, czy APSS.

    Aby uzyskać identyfikator, przejdź do witryny Azure Portal i wybierz pozycję Wszystkie usługi > Subskrypcje ogólne>, wybierz subskrypcję, której chcesz użyć z listy. W sekcji Podstawy znajdź identyfikator subskrypcji. Najlepszym rozwiązaniem jest użycie oddzielnych subskrypcji dla środowisk produkcyjnych i deweloperskich lub testowych.

  • Identyfikator subskrypcji subskrypcji platformy Azure. Tylko subskrypcje EA są obsługiwane do rejestracji.

    Aby uzyskać identyfikator, przejdź do witryny Azure Portal i wybierz pozycję Wszystkie usługi > Subskrypcje ogólne>, wybierz subskrypcję, której chcesz użyć z listy. W sekcji Podstawy znajdź identyfikator subskrypcji. Najlepszym rozwiązaniem jest użycie oddzielnych subskrypcji dla środowisk produkcyjnych i deweloperskich lub testowych.

Uwaga

Subskrypcje chmury w Niemczech nie są obecnie obsługiwane.

  • Nazwa użytkownika i hasło dla konta, które jest właścicielem subskrypcji.

  • Konto użytkownika musi mieć dostęp do subskrypcji platformy Azure i mieć uprawnienia do tworzenia aplikacji tożsamości i jednostek usługi w katalogu skojarzonym z tą subskrypcją. Zalecamy zarejestrowanie usługi Azure Stack Hub na platformie Azure przy użyciu administracji z najmniejszymi uprawnieniami. Aby uzyskać więcej informacji na temat tworzenia niestandardowej definicji roli, która ogranicza dostęp do subskrypcji na potrzeby rejestracji, zobacz Tworzenie roli rejestracji dla usługi Azure Stack Hub.

  • Zarejestrowano dostawcę zasobów usługi Azure Stack Hub (zobacz poniższą sekcję Rejestrowanie dostawcy zasobów usługi Azure Stack Hub, aby uzyskać szczegółowe informacje).

Użytkownik rejestrujący usługę Azure Stack Hub jest właścicielem jednostki usługi w identyfikatorze Entra firmy Microsoft. Tylko użytkownik, który zarejestrował usługę Azure Stack Hub, może zmodyfikować rejestrację usługi Azure Stack Hub. Wszyscy inni użytkownicy muszą zostać dodani do subskrypcji dostawcy domyślnego za pomocą opcji "Kontrola dostępu (IAM)". Jeśli użytkownik niebędący administratorem, który nie jest właścicielem jednostki usługi rejestracji próbuje zarejestrować lub ponownie zarejestrować usługę Azure Stack Hub, może napotkać odpowiedź 403. Odpowiedź 403 wskazuje, że użytkownik ma niewystarczające uprawnienia do ukończenia operacji.

Jeśli nie masz subskrypcji platformy Azure spełniającej te wymagania, możesz utworzyć bezpłatne konto platformy Azure tutaj. Rejestrowanie usługi Azure Stack Hub nie wiąże się z żadnymi kosztami w ramach subskrypcji platformy Azure.

Uwaga

Jeśli masz więcej niż jedną usługę Azure Stack Hub, najlepszym rozwiązaniem jest zarejestrowanie każdej usługi Azure Stack Hub we własnej subskrypcji. Ułatwia to śledzenie użycia.

Ustawianie trybu języka programu PowerShell

Aby pomyślnie zarejestrować usługę Azure Stack Hub, tryb języka programu PowerShell musi być ustawiony na Wartość FullLanguage. Aby sprawdzić, czy bieżący tryb języka jest ustawiony na pełny, otwórz okno programu PowerShell z podwyższonym poziomem uprawnień i uruchom następujące polecenia cmdlet programu PowerShell:

$ExecutionContext.SessionState.LanguageMode

Upewnij się, że dane wyjściowe zwracają wartość FullLanguage. Jeśli zostanie zwrócony inny tryb językowy, przed kontynuowaniem należy uruchomić rejestrację na innej maszynie lub tryb języka musi być ustawiony na wartość FullLanguage .

Instalowanie programu PowerShell dla usługi Azure Stack Hub

Użyj najnowszego programu PowerShell dla usługi Azure Stack Hub, aby zarejestrować się na platformie Azure.

Jeśli najnowsza wersja nie jest jeszcze zainstalowana, zobacz Instalowanie programu PowerShell dla usługi Azure Stack Hub.

Pobieranie narzędzi usługi Azure Stack Hub

Repozytorium GitHub narzędzi usługi Azure Stack Hub zawiera moduły programu PowerShell, które obsługują funkcje usługi Azure Stack Hub, w tym funkcje rejestracji. Podczas procesu rejestracji należy zaimportować i użyć modułu RegisterWithAzure.psm1 programu PowerShell (znajdującego się w repozytorium narzędzi usługi Azure Stack Hub), aby zarejestrować wystąpienie usługi Azure Stack Hub na platformie Azure.

Aby upewnić się, że używasz najnowszej wersji, usuń wszystkie istniejące wersje narzędzi usługi Azure Stack Hub i pobierz najnowszą wersję z usługi GitHub przed zarejestrowaniem się na platformie Azure.

Uwaga

Możesz również użyć stacji roboczej dostępu operatora (OAW), aby uzyskać dostęp do uprzywilejowanego punktu końcowego (PEP), portalu administratora na potrzeby scenariuszy pomocy technicznej i narzędzi GitHub Usługi Azure Stack Hub. Aby uzyskać więcej informacji, zobacz Stacja robocza dostępu operatora usługi Azure Stack Hub.

Określanie modelu rozliczeniowego

Połączone wdrożenie umożliwia usłudze Azure Stack Hub łączenie się z Internetem i z platformą Azure. Możesz również użyć usługi Microsoft Entra ID lub Active Directory Federation Services (AD FS) jako magazynu tożsamości i wybrać spośród dwóch modeli rozliczeniowych: płatność zgodnie z rzeczywistym użyciem lub pojemność. Model rozliczeń należy określić później podczas uruchamiania skryptu rejestracji.

Odłączone wdrożenie umożliwia korzystanie z usługi Azure Stack Hub bez połączenia z Internetem. Wdrożenie bez połączenia jest ograniczone do magazynu tożsamości usług AD FS i modelu rozliczeń opartego na pojemności. Model rozliczeń należy określić później podczas uruchamiania skryptu rejestracji.

Określanie unikatowej nazwy rejestracji

Po uruchomieniu skryptu rejestracji należy podać unikatową nazwę rejestracji. Łatwym sposobem skojarzenia subskrypcji usługi Azure Stack Hub z rejestracją platformy Azure jest użycie identyfikatora chmury usługi Azure Stack Hub.

Uwaga

Rejestracje usługi Azure Stack Hub przy użyciu modelu rozliczeniowego opartego na pojemności będą musiały zmienić unikatową nazwę podczas ponownego rejestrowania po wygaśnięciu tych rocznych subskrypcji, chyba że usuniesz wygasłą rejestrację i ponownie zarejestrujesz się na platformie Azure.

Aby określić identyfikator chmury dla wdrożenia usługi Azure Stack Hub, zobacz Znajdowanie identyfikatora chmury.

Rejestrowanie się w rozliczeniach z płatnością zgodnie z rzeczywistym użyciem

Wykonaj następujące kroki, aby zarejestrować usługę Azure Stack Hub na platformie Azure przy użyciu modelu rozliczeń z płatnością zgodnie z rzeczywistym użyciem.

Uwaga

Wszystkie te kroki należy uruchomić z komputera, który ma dostęp do uprzywilejowanego punktu końcowego (PEP). Aby uzyskać szczegółowe informacje na temat pep, zobacz Using the privileged endpoint in Azure Stack Hub (Korzystanie z uprzywilejowanego punktu końcowego w usłudze Azure Stack Hub).

Środowiska połączone mogą uzyskiwać dostęp do Internetu i platformy Azure. W przypadku tych środowisk należy zarejestrować dostawcę zasobów usługi Azure Stack Hub na platformie Azure, a następnie skonfigurować model rozliczeń.

  1. Aby zarejestrować dostawcę zasobów usługi Azure Stack Hub na platformie Azure, uruchom program PowerShell ISE jako administrator i użyj następujących poleceń cmdlet programu PowerShell z parametrem EnvironmentName ustawionym na odpowiedni typ subskrypcji platformy Azure (zobacz parametry poniżej).

  2. Dodaj konto platformy Azure użyte do zarejestrowania usługi Azure Stack Hub. Aby dodać konto, uruchom polecenie cmdlet Connect-AzAccount . Zostanie wyświetlony monit o wprowadzenie poświadczeń konta platformy Azure i może być konieczne użycie uwierzytelniania dwuskładnikowego na podstawie konfiguracji konta.

    Connect-AzAccount -EnvironmentName "<environment name>"
    Parametr Opis
    NazwaŚrodowiska Nazwa środowiska subskrypcji chmury platformy Azure. Obsługiwane nazwy środowisk to AzureCloud, AzureUSGovernment lub jeśli używasz subskrypcji platformy Azure w Chinach, AzureChinaCloud.

    Uwaga

    Jeśli sesja wygaśnie, hasło uległo zmianie lub po prostu chcesz przełączyć konta, uruchom następujące polecenie cmdlet przed zalogowaniem się przy użyciu polecenia Connect-AzAccount: Remove-AzAccount-Scope Process

  3. Jeśli masz wiele subskrypcji, uruchom następujące polecenie, aby wybrać tę, której chcesz użyć:

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

  4. Uruchom następujące polecenie, aby zarejestrować dostawcę zasobów usługi Azure Stack Hub w ramach subskrypcji platformy Azure:

    Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack

  5. Uruchom program PowerShell ISE jako administrator i przejdź do folderu Rejestracja w katalogu AzureStack-Tools-az utworzonym podczas pobierania narzędzi usługi Azure Stack Hub. Zaimportuj moduł RegisterWithAzure.psm1 przy użyciu programu PowerShell:

    Import-Module .\RegisterWithAzure.psm1

  6. Przed kontynuowaniem w tej samej sesji programu PowerShell sprawdź ponownie, czy zalogowano się do poprawnego kontekstu programu Azure PowerShell (jeśli nie, powtórz kroki 2 i 3). Ten kontekst będzie kontem platformy Azure, które zostało wcześniej użyte do zarejestrowania dostawcy zasobów usługi Azure Stack Hub. W tej samej sesji programu PowerShell uruchom polecenie cmdlet 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

    Aby uzyskać więcej informacji na temat polecenia cmdlet Set-AzsRegistration, zobacz Dokumentacja rejestracji.

Proces trwa od 10 do 15 minut. Po zakończeniu polecenia zostanie wyświetlony komunikat "Środowisko jest teraz zarejestrowane i aktywowane przy użyciu podanych parametrów".

Rejestrowanie przy użyciu rozliczeń pojemności

Wykonaj następujące kroki, aby zarejestrować usługę Azure Stack Hub na platformie Azure przy użyciu modelu rozliczeń pojemności.

Uwaga

Wszystkie te kroki należy uruchomić z komputera, który ma dostęp do uprzywilejowanego punktu końcowego (PEP). Aby uzyskać szczegółowe informacje na temat pep, zobacz Using the privileged endpoint in Azure Stack Hub (Korzystanie z uprzywilejowanego punktu końcowego w usłudze Azure Stack Hub).

Środowiska połączone mogą uzyskiwać dostęp do Internetu i platformy Azure. W przypadku tych środowisk należy zarejestrować dostawcę zasobów usługi Azure Stack Hub na platformie Azure, a następnie skonfigurować model rozliczeń.

  1. Aby zarejestrować dostawcę zasobów usługi Azure Stack Hub na platformie Azure, uruchom program PowerShell ISE jako administrator i użyj następujących poleceń cmdlet programu PowerShell z parametrem EnvironmentName ustawionym na odpowiedni typ subskrypcji platformy Azure (zobacz parametry poniżej).

  2. Dodaj konto platformy Azure użyte do zarejestrowania usługi Azure Stack Hub. Aby dodać konto, uruchom polecenie cmdlet Connect-AzAccount . Zostanie wyświetlony monit o wprowadzenie poświadczeń konta platformy Azure i może być konieczne użycie uwierzytelniania dwuskładnikowego na podstawie konfiguracji konta.

    Connect-AzAccount -Environment "<environment name>"
    Parametr Opis
    NazwaŚrodowiska Nazwa środowiska subskrypcji chmury platformy Azure. Obsługiwane nazwy środowisk to AzureCloud, AzureUSGovernment lub jeśli używasz subskrypcji platformy Azure w Chinach, AzureChinaCloud.

  3. Jeśli masz wiele subskrypcji, uruchom następujące polecenie, aby wybrać tę, której chcesz użyć:

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

  4. Uruchom następujące polecenie, aby zarejestrować dostawcę zasobów usługi Azure Stack Hub w ramach subskrypcji platformy Azure:

    Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack

  5. Uruchom program PowerShell ISE jako administrator i przejdź do folderu Rejestracja w katalogu AzureStack-Tools-az utworzonym podczas pobierania narzędzi usługi Azure Stack Hub. Zaimportuj moduł RegisterWithAzure.psm1 przy użyciu programu PowerShell:

    Import-Module .\RegisterwithAzure.psm1

  6. Przed kontynuowaniem w tej samej sesji programu PowerShell sprawdź ponownie, czy zalogowano się do poprawnego kontekstu programu Azure PowerShell (jeśli nie, powtórz kroki 2 i 3). Ten kontekst to konto platformy Azure, które zostało użyte do zarejestrowania dostawcy zasobów usługi Azure Stack Hub. W tej samej sesji programu PowerShell uruchom polecenie cmdlet 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

    Użyj numeru umowy EA, w którym zakupiono licencje jednostki SKU pojemności.

    Uwaga

    Raportowanie użycia można wyłączyć za pomocą parametru UsageReportingEnabled dla polecenia cmdlet Set-AzsRegistration , ustawiając parametr na false.

    Aby uzyskać więcej informacji na temat polecenia cmdlet Set-AzsRegistration, zobacz Dokumentacja rejestracji.

Rejestrowanie przy użyciu rozliczeń pojemności

Jeśli rejestrujesz usługę Azure Stack Hub w środowisku bez połączenia z Internetem (bez łączności z Internetem), musisz uzyskać token rejestracji ze środowiska usługi Azure Stack Hub. Następnie użyj tego tokenu na komputerze, który może nawiązać połączenie z platformą Azure i ma zainstalowany program PowerShell dla usługi Azure Stack Hub.

Uzyskiwanie tokenu rejestracji ze środowiska usługi Azure Stack Hub

  1. Uruchom program PowerShell ISE jako administrator i przejdź do folderu Rejestracja w katalogu AzureStack-Tools-az utworzonym podczas pobierania narzędzi usługi Azure Stack Hub. Zaimportuj moduł RegisterWithAzure.psm1 :

    Import-Module .\RegisterWithAzure.psm1

  2. Aby uzyskać token rejestracji, uruchom następujące polecenia cmdlet programu PowerShell:

    $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

    Użyj numeru umowy EA, w którym zakupiono licencje jednostki SKU pojemności.

    Aby uzyskać więcej informacji na temat polecenia cmdlet Get-AzsRegistrationToken, zobacz Dokumentacja rejestracji.

    Napiwek

    Token rejestracji jest zapisywany w pliku określonym dla $FilePathForRegistrationToken. Ścieżkę pliku lub nazwę pliku można zmienić według własnego uznania.

  3. Zapisz ten token rejestracji do użycia na maszynie połączonej z platformą Azure. Możesz skopiować plik lub tekst z $FilePathForRegistrationToken.

Nawiązywanie połączenia z platformą Azure i rejestrowanie

Na komputerze połączonym z Internetem wykonaj te same kroki, aby zaimportować moduł RegisterWithAzure.psm1 i zalogować się do poprawnego kontekstu programu Azure PowerShell. Następnie wywołaj metodę Register-AzsEnvironment. Określ token rejestracji do zarejestrowania się na platformie Azure. Jeśli rejestrujesz więcej niż jedno wystąpienie usługi Azure Stack Hub przy użyciu tego samego identyfikatora subskrypcji platformy Azure, określ unikatową nazwę rejestracji.

Potrzebujesz tokenu rejestracji i unikatowej nazwy tokenu.

  1. Uruchom program PowerShell ISE jako administrator i przejdź do folderu Rejestracja w katalogu AzureStack-Tools-az utworzonym podczas pobierania narzędzi usługi Azure Stack Hub. Zaimportuj moduł RegisterWithAzure.psm1 :

    Import-Module .\RegisterWithAzure.psm1

  2. Następnie uruchom następujące polecenia cmdlet programu PowerShell:

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

Opcjonalnie możesz użyć polecenia cmdlet Get-Content, aby wskazać plik zawierający token rejestracji.

Potrzebujesz tokenu rejestracji i unikatowej nazwy tokenu.

  1. Uruchom program PowerShell ISE jako administrator i przejdź do folderu Rejestracja w katalogu AzureStack-Tools-az utworzonym podczas pobierania narzędzi usługi Azure Stack Hub. Zaimportuj moduł RegisterWithAzure.psm1 :

    Import-Module .\RegisterWithAzure.psm1

  2. Następnie uruchom następujące polecenia cmdlet programu PowerShell:

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

Uwaga

Zapisz nazwę zasobu rejestracji i token rejestracji na potrzeby przyszłego odwołania.

Pobieranie klucza aktywacji z zasobu rejestracji platformy Azure

Następnie należy pobrać klucz aktywacji z zasobu rejestracji utworzonego na platformie Azure podczas rejestracji Za pomocą polecenia Register-AzsEnvironment.

Aby uzyskać klucz aktywacji, uruchom następujące polecenia cmdlet programu PowerShell:

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

Napiwek

Klucz aktywacji jest zapisywany w pliku określonym dla $KeyOutputFilePath. Ścieżkę pliku lub nazwę pliku można zmienić według własnego uznania.

Tworzenie zasobu aktywacji w usłudze Azure Stack Hub

Wróć do środowiska usługi Azure Stack Hub z plikiem lub tekstem z klucza aktywacji utworzonego na podstawie polecenia Get-AzsActivationKey. Następnie utwórz zasób aktywacji w usłudze Azure Stack Hub przy użyciu tego klucza aktywacji. Aby utworzyć zasób aktywacji, uruchom następujące polecenia cmdlet programu PowerShell:

# 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

Opcjonalnie możesz użyć polecenia cmdlet Get-Content, aby wskazać plik zawierający token rejestracji:

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

Weryfikowanie rejestracji w usłudze Azure Stack Hub

Możesz użyć kafelka Zarządzanie regionami , aby sprawdzić, czy rejestracja w usłudze Azure Stack Hub zakończyła się pomyślnie. Ten kafelek jest dostępny na domyślnym pulpicie nawigacyjnym w portalu administratora. Stan można zarejestrować lub nie zarejestrować. W przypadku zarejestrowania zostanie również wyświetlony identyfikator subskrypcji platformy Azure użyty do zarejestrowania usługi Azure Stack Hub wraz z grupą zasobów rejestracji i nazwą.

  1. Zaloguj się do portalu https://adminportal.local.azurestack.externaladministratora usługi Azure Stack Hub.

  2. Na pulpicie nawigacyjnym wybierz pozycję Zarządzanie regionami.

  3. Wybierz Właściwości. Ten blok przedstawia stan i szczegóły środowiska. Stan może być Zarejestrowany, Niezarejestrowany lub Wygasły.

    Kafelek zarządzanie regionami w portalu administratora usługi Azure Stack Hub

    W przypadku zarejestrowania właściwości obejmują:

    • Identyfikator subskrypcji rejestracji: identyfikator subskrypcji platformy Azure zarejestrowany i skojarzony z usługą Azure Stack Hub.
    • Grupa zasobów rejestracji: grupa zasobów platformy Azure w skojarzonej subskrypcji zawierającej zasoby usługi Azure Stack Hub.

  4. Za pomocą witryny Azure Portal możesz wyświetlić zasoby rejestracji usługi Azure Stack Hub, a następnie sprawdzić, czy rejestracja zakończyła się pomyślnie. Zaloguj się do witryny Azure Portal przy użyciu konta skojarzonego z subskrypcją użytą do zarejestrowania usługi Azure Stack Hub. Zaznacz pole wyboru Wszystkie zasoby, włącz pole wyboru Pokaż ukryte typy i wybierz nazwę rejestracji.

  5. Jeśli rejestracja nie powiedzie się, musisz ponownie zarejestrować się, wykonując kroki opisane tutaj , aby rozwiązać ten problem.

Alternatywnie możesz sprawdzić, czy rejestracja zakończyła się pomyślnie, korzystając z funkcji zarządzania witryną Marketplace. Jeśli w bloku zarządzania witryną Marketplace zostanie wyświetlona lista elementów witryny Marketplace, rejestracja zakończyła się pomyślnie. Jednak w środowiskach bez połączenia nie widać elementów witryny Marketplace w zarządzaniu witryną Marketplace.

Odnawianie lub zmienianie rejestracji

Musisz zaktualizować rejestrację w następujących okolicznościach:

  • Po odnowieniu rocznej subskrypcji opartej na pojemności.
  • Po zmianie modelu rozliczeniowego.
  • Gdy skala zmieni się (dodaj/usuń węzły) na potrzeby rozliczeń opartych na pojemności.

Uwaga

Jeśli włączono aktywne zbieranie dzienników i odnowisz lub zmienisz rejestrację usługi Azure Stack Hub, musisz ponownie włączyć proaktywną zbieranie dzienników. Aby uzyskać więcej informacji na temat proaktywnego zbierania dzienników, zobacz Zbieranie dzienników diagnostycznych.

Wymagania wstępne

Aby odnowić lub zmienić rejestrację , potrzebne są następujące informacje z portalu administratora:

Portal administratora Parametr polecenia cmdlet Uwagi
IDENTYFIKATOR SUBSKRYPCJI REJESTRACJI Subskrypcja Identyfikator subskrypcji używany podczas poprzedniej rejestracji
REJESTRACJA GRUPY ZASOBÓW ResourceGroupName Grupa zasobów, w ramach której istnieje poprzedni zasób rejestracji
NAZWA REJESTRACJI Nazwa rejestracji Nazwa rejestracji używana podczas poprzedniej rejestracji

Zmienianie używanej subskrypcji

Jeśli chcesz zmienić używaną subskrypcję, musisz najpierw uruchomić polecenie cmdlet Remove-AzsRegistration , a następnie upewnić się, że zalogowano się do poprawnego kontekstu programu Azure PowerShell. Następnie uruchom polecenie Set-AzsRegistration z dowolnymi zmienionymi parametrami, w tym <billing model>. Podczas uruchamiania polecenia Remove-AzsRegistration musisz zalogować się do subskrypcji używanej podczas rejestracji i używać wartości parametrów RegistrationName i ResourceGroupName , jak pokazano w portalu administratora:

# 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>'

Zmienianie modelu rozliczeń, sposobu oferowaniu funkcji lub ponownego rejestrowania wystąpienia

Ta sekcja ma zastosowanie, jeśli chcesz zmienić model rozliczeń, sposób oferowana funkcji lub chcesz ponownie zarejestrować wystąpienie. W przypadku wszystkich tych przypadków wywołasz funkcję rejestracji, aby ustawić nowe wartości. Nie musisz najpierw usuwać bieżącej rejestracji. Zaloguj się do identyfikatora subskrypcji wyświetlanego w portalu administratora, a następnie uruchom ponownie rejestrację przy użyciu nowej BillingModel wartości, zachowując RegistrationName wartości parametrów i ResourceGroupName , jak pokazano w portalu administratora:

# 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>'

Musisz zaktualizować lub odnowić rejestrację w następujących okolicznościach:

  • Po odnowieniu rocznej subskrypcji opartej na pojemności.
  • Po zmianie modelu rozliczeniowego.
  • Podczas skalowania zmian (dodawanie/usuwanie węzłów) na potrzeby rozliczeń opartych na pojemności.

Usuwanie zasobu aktywacji z usługi Azure Stack Hub

Najpierw musisz usunąć zasób aktywacji z usługi Azure Stack Hub, a następnie zasób rejestracji na platformie Azure.

Aby usunąć zasób aktywacji w usłudze Azure Stack Hub, uruchom następujące polecenia cmdlet programu PowerShell w środowisku usługi Azure Stack Hub:

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

Następnie, aby usunąć zasób rejestracji na platformie Azure, upewnij się, że jesteś na komputerze połączonym z platformą Azure, zaloguj się do poprawnego kontekstu programu Azure PowerShell i uruchom odpowiednie polecenia cmdlet programu PowerShell zgodnie z poniższym opisem.

Możesz użyć tokenu rejestracji używanego do utworzenia zasobu:

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

Możesz też użyć nazwy rejestracji i nazwy grupy zasobów rejestracji z portalu administratora:

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

Ponowne rejestrowanie przy użyciu połączonych kroków

Jeśli zmieniasz model rozliczeniowy z rozliczeń pojemności w stanie rozłączonym na rozliczenia zużycia w stanie połączonym, zarejestruj się ponownie, wykonując kroki połączonego modelu.

Uwaga

Nie powoduje to zmiany modelu tożsamości, tylko mechanizmu rozliczeniowego i nadal będziesz używać usług AD FS jako źródła tożsamości.

Ponowne rejestrowanie przy użyciu rozłączonych kroków

Teraz całkowicie wyrejestrujesz się w scenariuszu bez połączenia i musisz powtórzyć kroki rejestrowania środowiska usługi Azure Stack Hub w scenariuszu bez połączenia.

Wyłączanie lub włączanie raportowania użycia

W przypadku środowisk usługi Azure Stack Hub korzystających z modelu rozliczeń pojemności wyłącz raportowanie użycia za pomocą parametru UsageReportingEnabled przy użyciu polecenia cmdlet Set-AzsRegistration lub Get-AzsRegistrationToken . Usługa Azure Stack Hub domyślnie raportuje metryki użycia. Operatorzy z użyciem pojemności lub obsługą odłączonego środowiska muszą wyłączyć raportowanie użycia.

Uruchom następujące polecenia cmdlet programu 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> `
   -BillingModel Capacity
   -RegistrationName $RegistrationName
   -UsageReportingEnabled:$false

  1. Aby zmienić token rejestracji, uruchom następujące polecenia cmdlet programu PowerShell:

    $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

    Użyj numeru umowy EA, w którym zakupiono licencje jednostki SKU pojemności.

    Napiwek

    Token rejestracji jest zapisywany w pliku określonym dla $FilePathForRegistrationToken. Ścieżkę pliku lub nazwę pliku można zmienić według własnego uznania.

  2. Zapisz ten token rejestracji do użycia na połączonej maszynie platformy Azure. Możesz skopiować plik lub tekst z $FilePathForRegistrationToken.

Przenoszenie zasobu rejestracji

Przenoszenie zasobu rejestracji między grupami zasobów w ramach tej samej subskrypcji jest obsługiwane dla wszystkich środowisk. Jednak przeniesienie zasobu rejestracji między subskrypcjami jest obsługiwane tylko w przypadku dostawców CSP, gdy obie subskrypcje rozpoznają ten sam identyfikator partnera. Aby uzyskać więcej informacji na temat przenoszenia zasobów do nowej grupy zasobów, zobacz Przenoszenie zasobów do nowej grupy zasobów lub subskrypcji.

Ważne

Aby zapobiec przypadkowemu usunięciu zasobów rejestracji w portalu, skrypt rejestracji automatycznie dodaje blokadę do zasobu. Należy usunąć tę blokadę przed przeniesieniem lub usunięciem. Zaleca się dodanie blokady do zasobu rejestracji, aby zapobiec przypadkowemu usunięciu.

Dokumentacja rejestracji

Set-AzsRegistration

Za pomocą polecenia Set-AzsRegistration możesz zarejestrować usługę Azure Stack Hub na platformie Azure i włączyć lub wyłączyć ofertę elementów w witrynie Marketplace i raportowaniu użycia.

Aby uruchomić polecenie cmdlet, potrzebne są następujące elementy:

  • Subskrypcja platformy Azure dowolnego typu.
  • Aby zalogować się do programu Azure PowerShell przy użyciu konta, które jest właścicielem lub współautorem tej subskrypcji.
Set-AzsRegistration [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String> [[-AzureContext]
    <PSObject>] [[-ResourceGroupName] <String>] [[-ResourceGroupLocation] <String>] [[-BillingModel] <String>]
    [-MarketplaceSyndicationEnabled] [-UsageReportingEnabled] [[-AgreementNumber] <String>] [[-RegistrationName]
    <String>] [<CommonParameters>]
Parametr Type Opis
PrivilegedEndpointCredential PsCredential Poświadczenia używane do uzyskiwania dostępu do uprzywilejowanego punktu końcowego. Nazwa użytkownika jest w formacie AzureStackDomain\CloudAdmin.
PrivilegedEndpoint String Wstępnie skonfigurowana zdalna konsola programu PowerShell, która zapewnia funkcje, takie jak zbieranie dzienników i inne zadania po wdrożeniu. Aby dowiedzieć się więcej, zapoznaj się z artykułem dotyczącym korzystania z uprzywilejowanego punktu końcowego .
AzureContext OBIEKT PSObject
ResourceGroupName String
ResourceGroupLocation String
Model rozliczeń String Model rozliczeń używany przez subskrypcję. Dozwolone wartości dla tego parametru to: Capacity, PayAsYouUse i Development.
MarketplaceSyndicationEnabled Prawda/fałsz Określa, czy funkcja zarządzania platformą handlową jest dostępna w portalu. Ustaw wartość true, jeśli rejestrujesz się w połączeniu z Internetem. Ustaw wartość false, jeśli rejestrujesz się w środowiskach bez połączenia. W przypadku rozłączonych rejestracji narzędzie syndykacji offline może służyć do pobierania elementów witryny Marketplace.
UsageReportingEnabled Prawda/fałsz Usługa Azure Stack Hub domyślnie raportuje metryki użycia. Operatorzy z użyciem pojemności lub obsługą odłączonego środowiska muszą wyłączyć raportowanie użycia. Dozwolone wartości dla tego parametru to: True, False.
Numer umowy String Liczba umów EA, w ramach której zamówiono jednostkę SKU pojemności dla tego usługi Azure Stack.
Nazwa rejestracji String Ustaw unikatową nazwę rejestracji, jeśli uruchamiasz skrypt rejestracji w więcej niż jednym wystąpieniu usługi Azure Stack Hub przy użyciu tego samego identyfikatora subskrypcji platformy Azure. Parametr ma wartość domyślną azureStackRegistration. Jeśli jednak używasz tej samej nazwy w więcej niż jednym wystąpieniu usługi Azure Stack Hub, skrypt zakończy się niepowodzeniem.

Get-AzsRegistrationToken

Polecenie Get-AzsRegistrationToken generuje token rejestracji z parametrów wejściowych.

Get-AzsRegistrationToken [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String>
    [-BillingModel] <String> [[-TokenOutputFilePath] <String>] [-UsageReportingEnabled] [[-AgreementNumber] <String>]
    [<CommonParameters>]
Parametr Type Opis
PrivilegedEndpointCredential PsCredential Poświadczenia używane do uzyskiwania dostępu do uprzywilejowanego punktu końcowego. Nazwa użytkownika jest w formacie AzureStackDomain\CloudAdmin.
PrivilegedEndpoint String Wstępnie skonfigurowana zdalna konsola programu PowerShell, która zapewnia funkcje, takie jak zbieranie dzienników i inne zadania po wdrożeniu. Aby dowiedzieć się więcej, zapoznaj się z artykułem dotyczącym korzystania z uprzywilejowanego punktu końcowego .
AzureContext OBIEKT PSObject
ResourceGroupName String
ResourceGroupLocation String
Model rozliczeń String Model rozliczeń używany przez subskrypcję. Dozwolone wartości dla tego parametru to: Pojemność, Niestandardowy i Programowanie.
MarketplaceSyndicationEnabled Prawda/fałsz
UsageReportingEnabled Prawda/fałsz Usługa Azure Stack Hub domyślnie raportuje metryki użycia. Operatorzy z użyciem pojemności lub obsługą odłączonego środowiska muszą wyłączyć raportowanie użycia. Dozwolone wartości dla tego parametru to: True, False.
Numer umowy String

Błędy rejestracji

Podczas próby zarejestrowania usługi Azure Stack Hub może zostać wyświetlony jeden z poniższych błędów:

  • Nie można pobrać obowiązkowych informacji o sprzęcie dla programu $hostName. Sprawdź hosta fizycznego i łączność, a następnie spróbuj ponownie uruchomić rejestrację.

  • Nie można nawiązać połączenia, aby $hostName uzyskać informacje o sprzęcie. Sprawdź hosta fizycznego i łączność, a następnie spróbuj ponownie uruchomić rejestrację.

    Przyczyna: Próbowaliśmy uzyskać szczegóły sprzętu, takie jak UUID, Bios i CPU z hostów, aby spróbować aktywacji i nie można było nawiązać połączenia z hostem fizycznym.

  • Identyfikator chmury [GUID] jest już zarejestrowany. Ponowne używanie identyfikatorów chmury nie jest dozwolone.

    Przyczyna: dzieje się tak, jeśli środowisko usługi Azure Stack jest już zarejestrowane. Jeśli chcesz ponownie zarejestrować środowisko przy użyciu innej subskrypcji lub modelu rozliczeniowego, wykonaj kroki odnawiania lub zmieniania rejestracji.

  • Podczas próby uzyskania dostępu do zarządzania witryną Marketplace występuje błąd podczas próby syndykacji produktów.

    Przyczyna: Zwykle dzieje się tak, gdy usługa Azure Stack Hub nie może uzyskać dostępu do zasobu rejestracji. Jedną z typowych przyczyn jest to, że gdy dzierżawa katalogu subskrypcji platformy Azure zmieni się, resetuje rejestrację. Nie możesz uzyskać dostępu do witryny Azure Stack Hub Marketplace ani użycia raportów, jeśli zmieniono dzierżawę katalogu subskrypcji. Aby rozwiązać ten problem, musisz ponownie zarejestrować się.

  • Zarządzanie witryną Marketplace nadal prosi o zarejestrowanie i aktywowanie usługi Azure Stack Hub, nawet jeśli sygnatura została już zarejestrowana przy użyciu procesu rozłączonego.

    Przyczyna: Jest to znany problem w środowiskach bez połączenia i wymaga zweryfikowania stanu rejestracji. Aby korzystać z zarządzania witryną Marketplace, użyj narzędzia offline.

Następne kroki

Pobieranie elementów witryny Marketplace z platformy Azure