Rejestrowanie ASDK na platformie AzureRegister the ASDK with Azure

Możesz zarejestrować instalację Azure Stack Development Kit (ASDK) na platformie Azure, aby pobierać elementy z witryny Marketplace z platformy Azure i konfigurować raporty danych handlowych z powrotem do firmy Microsoft.You can register your Azure Stack Development Kit (ASDK) installation with Azure to download marketplace items from Azure and to set up commerce data reporting back to Microsoft. Rejestracja jest wymagana do obsługi pełnej funkcjonalności centrum Azure Stack, w tym zespalanie z witryny Marketplace.Registration is required to support full Azure Stack Hub functionality, including marketplace syndication. Rejestracja jest wymagana, aby umożliwić przetestowanie ważnych funkcji Centrum Azure Stack, takich jak zespalanie zespalania i raportowanie użycia.Registration is required to enable you to test important Azure Stack Hub functionality like marketplace syndication and usage reporting. Po zarejestrowaniu centrum Azure Stack zostanie zgłoszone użycie usługi Azure commerce.After you register Azure Stack Hub, usage is reported to Azure commerce. Zobaczysz ją w ramach subskrypcji użytej do rejestracji.You can see it under the subscription you used for registration. Jednak użytkownicy ASDK nie są obciążani opłatami za żadne raporty dotyczące użycia.However, ASDK users aren't charged for any usage they report.

Jeśli nie zarejestrujesz ASDK, być może zobaczysz Alert ostrzegawczy wymagające aktywacji , który zaleci zarejestrowanie ASDK.If you don't register your ASDK, you might see an Activation Required warning alert that advises you to register your ASDK. Takie zachowanie jest oczekiwane.This behavior is expected.

Wymagania wstępnePrerequisites

Przed skorzystaniem z tych instrukcji w celu zarejestrowania ASDK na platformie Azure upewnij się, że zainstalowano program PowerShell centrum Azure Stack i pobrano narzędzia centrum Azure Stack, zgodnie z opisem w artykule dotyczącym konfiguracji powdrożeniowej .Before using these instructions to register the ASDK with Azure, ensure that you've installed the Azure Stack Hub PowerShell and downloaded the Azure Stack Hub tools as described in the post-deployment configuration article.

Tryb języka programu PowerShell musi być również ustawiony na FullLanguage na komputerze używanym do rejestrowania ASDK na platformie Azure.The PowerShell language mode must also be set to FullLanguage on the computer used to register the ASDK with Azure. 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 programu PowerShell:To verify that the current language mode is set to full, open an elevated PowerShell window and run the following PowerShell commands:

$ExecutionContext.SessionState.LanguageMode

Upewnij się, że dane wyjściowe zwracają FullLanguage.Ensure the output returns FullLanguage. Jeśli jest zwracany dowolny inny tryb języka, rejestracja musi być uruchamiana na innym komputerze lub w trybie języka ustawionym na FullLanguage przed kontynuowaniem.If any other language mode is returned, registration needs to be run on another computer or the language mode set to FullLanguage before continuing.

Konto usługi Azure AD używane na potrzeby rejestracji 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ą.The Azure AD account used for registration needs to have access to the Azure subscription and have permissions to create identity apps and service principals in the directory associated with that subscription. Zalecamy zarejestrowanie centrum Azure Stack na platformie Azure przez utworzenie konta usługi do użycia na potrzeby rejestracji , a nie przy użyciu poświadczeń administratora globalnego.We recommend you register Azure Stack Hub with Azure by creating a service account to use for registration rather than using global admin credentials.

Zarejestruj ASDKRegister the ASDK

Wykonaj następujące kroki, aby zarejestrować ASDK na platformie Azure.Follow these steps to register the ASDK with Azure.

Uwaga

Wszystkie te kroki należy uruchomić z komputera, który ma dostęp do uprzywilejowanego punktu końcowego.All these steps must be run from a computer that has access to the privileged endpoint. ASDK jest to komputer hosta ASDK.For the ASDK, that's the ASDK host computer.

  1. Otwórz wiersz polecenia programu PowerShell z podwyższonym poziomem uprawnień.Open an elevated PowerShell prompt.

  2. Uruchom następujące polecenia cmdlet programu PowerShell, aby zarejestrować instalację ASDK na platformie Azure.Run the following PowerShell cmdlets to register your ASDK installation with Azure. Zaloguj się do zarówno identyfikatora subskrypcji rozliczeń platformy Azure, jak i lokalnej instalacji ASDK.Sign in to both your Azure billing Subscription ID and the local ASDK installation. Jeśli nie masz jeszcze identyfikatora subskrypcji rozliczeń platformy Azure, możesz tutaj utworzyć bezpłatne konto platformy Azure.If you don't have an Azure billing subscription ID yet, you can create a free Azure account here. Rejestracja centrum Azure Stack w ramach subskrypcji platformy Azure nie wiąże się z żadnymi kosztami.Registering Azure Stack Hub incurs no cost on your Azure subscription.

    Ustaw unikatową nazwę rejestracji podczas uruchamiania polecenia cmdlet Set-AzsRegistration .Set a unique name for the registration when you run the Set-AzsRegistration cmdlet. Parametr registrationname ma wartość domyślną AzureStackRegistration.The RegistrationName parameter has a default value of AzureStackRegistration. Jeśli jednak używasz tej samej nazwy w więcej niż jednym wystąpieniu Azure Stack Hub, skrypt zakończy się niepowodzeniem.However, if you use the same name on more than one instance of Azure Stack Hub, the script will fail.

    # Add the Azure cloud subscription environment name. 
    # Supported environment names are AzureCloud, AzureChinaCloud, or AzureUSGovernment depending which Azure subscription you're using.
    Connect-AzAccount -EnvironmentName "<environment name>"
    
    # Register the Azure Stack Hub resource provider in your Azure subscription
    Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack
    
    # Import the registration module that was downloaded with the GitHub tools
    Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1
    
    # If you have multiple subscriptions, run the following command to select the one you want to use:
    # Get-AzSubscription -SubscriptionID "<subscription ID>" | Select-AzSubscription
    
    # Register Azure Stack Hub
    $AzureContext = Get-AzContext
    $CloudAdminCred = Get-Credential -UserName AZURESTACK\CloudAdmin -Message "Enter the credentials to access the privileged endpoint."
    $RegistrationName = "<unique-registration-name>"
    Set-AzsRegistration `
    -PrivilegedEndpointCredential $CloudAdminCred `
    -PrivilegedEndpoint AzS-ERCS01 `
    -BillingModel Development `
    -RegistrationName $RegistrationName `
    -UsageReportingEnabled:$true
    
  3. Po zakończeniu działania skryptu powinien zostać wyświetlony następujący komunikat: środowisko jest teraz zarejestrowane i aktywowane przy użyciu podanych parametrów.When the script completes, you should see this message: Your environment is now registered and activated using the provided parameters.

Twoje środowisko jest teraz zarejestrowane

Rejestrowanie w środowiskach odłączonychRegister in disconnected environments

Jeśli rejestrujesz centrum Azure Stack w odłączonym środowisku (bez łączności z Internetem), musisz uzyskać token rejestracji ze środowiska centrum Azure Stack, a następnie użyć tego tokenu na komputerze, który może połączyć się z platformą Azure, aby zarejestrować i utworzyć zasób aktywacji dla środowiska ASDK.If you're registering Azure Stack Hub in a disconnected environment (with no internet connectivity), you need to get a registration token from the Azure Stack Hub environment and then use that token on a computer that can connect to Azure to register and create an activation resource for your ASDK environment.

Ważne

Przed rozpoczęciem korzystania z tych instrukcji w celu zarejestrowania centrum Azure Stack upewnij się, że zainstalowano program PowerShell dla usługi Azure Stack Hub i pobrano narzędzia Azure Stack Hub, zgodnie z opisem w artykule Konfiguracja po wdrożeniu na komputerze hosta ASDK i komputerze z dostępem do Internetu używanym do nawiązywania połączenia z platformą Azure i rejestrowania.Before using these instructions to register Azure Stack Hub, ensure that you've installed PowerShell for Azure Stack Hub and downloaded the Azure Stack Hub tools as described in the post-deployment configuration article on both the ASDK host computer and the computer with internet access used to connect to Azure and register.

Pobierz token rejestracji ze środowiska Azure Stack HubGet a registration token from the Azure Stack Hub environment

Na komputerze hosta ASDK Uruchom program PowerShell jako administrator i przejdź do folderu rejestracji w katalogu AzureStack-Tools-AZ utworzonego podczas pobierania narzędzi Azure Stack Hub.On the ASDK host computer, start PowerShell as an admin and navigate to the Registration folder in the AzureStack-Tools-az directory created when you downloaded the Azure Stack Hub tools. Użyj następujących poleceń programu PowerShell, aby zaimportować moduł RegisterWithAzure. PSM1 , a następnie użyj polecenia cmdlet Get-AzsRegistrationToken , aby uzyskać token rejestracji:Use the following PowerShell commands to import the RegisterWithAzure.psm1 module and then use the Get-AzsRegistrationToken cmdlet to get the registration token:

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1

# Create registration token
$CloudAdminCred = Get-Credential -UserName AZURESTACK\CloudAdmin -Message "Enter the credentials to access the privileged endpoint."
# File path to save the token. This example saves the file as C:\RegistrationToken.txt.
$FilePathForRegistrationToken = "$env:SystemDrive\RegistrationToken.txt"
$RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $CloudAdminCred `
-UsageReportingEnabled:$false `
-PrivilegedEndpoint AzS-ERCS01 `
-BillingModel Development `
-MarketplaceSyndicationEnabled:$false `
-TokenOutputFilePath $FilePathForRegistrationToken

Zapisz ten token rejestracji do użycia na komputerze podłączonym do Internetu.Save this registration token for use on the internet-connected computer. Możesz skopiować plik lub tekst z pliku utworzonego przez $FilePathForRegistrationToken parametr.You can copy the file or the text from the file created by the $FilePathForRegistrationToken parameter.

Nawiązywanie połączenia z platformą Azure i rejestrowanieConnect to Azure and register

Na komputerze połączonym z Internetem Użyj następujących poleceń programu PowerShell w celu zaimportowania modułu RegisterWithAzure. PSM1 , a następnie użyj polecenia cmdlet register-AzsEnvironment , aby zarejestrować się na platformie Azure przy użyciu właśnie utworzonego tokenu rejestracji i unikatowej nazwy rejestracji:On the internet-connected computer, use the following PowerShell commands to import the RegisterWithAzure.psm1 module and then use the Register-AzsEnvironment cmdlet to register with Azure using the registration token you just created and a unique registration name:

# Add the Azure cloud subscription environment name. 
# Supported environment names are AzureCloud, AzureChinaCloud or AzureUSGovernment depending which Azure subscription you are using.
Connect-AzAccount -EnvironmentName "<environment name>"

# If you have multiple subscriptions, run the following command to select the one you want to use:
# Get-AzSubscription -SubscriptionID "<subscription ID>" | Select-AzSubscription

# Register the Azure Stack Hub resource provider in your Azure subscription
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1

# Register with Azure
# This example uses the C:\RegistrationToken.txt file.
$registrationToken = Get-Content -Path "$env:SystemDrive\RegistrationToken.txt"
$RegistrationName = "<unique-registration-name>"
Register-AzsEnvironment -RegistrationToken $registrationToken `
-RegistrationName $RegistrationName

Alternatywnie możesz użyć polecenia cmdlet Get-Content , aby wskazać plik, który zawiera token rejestracji:Alternatively, you can use the Get-Content cmdlet to point to a file that contains your registration token:

# Add the Azure cloud subscription environment name. 
# Supported environment names are AzureCloud, AzureChinaCloud or AzureUSGovernment depending which Azure subscription you are using.
Connect-AzAccount -EnvironmentName "<environment name>"

# If you have multiple subscriptions, run the following command to select the one you want to use:
# Get-AzSubscription -SubscriptionID "<subscription ID>" | Select-AzSubscription

# Register the Azure Stack Hub resource provider in your Azure subscription
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1

# Register with Azure 
# This example uses the C:\RegistrationToken.txt file.
$registrationToken = Get-Content -Path "$env:SystemDrive\RegistrationToken.txt"
Register-AzsEnvironment -RegistrationToken $registrationToken `
-RegistrationName $RegistrationName

Po zakończeniu rejestracji powinien zostać wyświetlony komunikat podobny do: środowisko centrum Azure Stack jest teraz zarejestrowane na platformie Azure.When registration is complete, you should see a message similar to: Your Azure Stack Hub environment is now registered with Azure.

Ważne

Nie zamykaj okna programu PowerShell.Do not close the PowerShell window.

Zapisz token rejestracji i nazwę zasobu rejestracji do użytku w przyszłości.Save the registration token and registration resource name for future reference.

Pobieranie klucza aktywacji z zasobu rejestracji platformy AzureRetrieve an activation key from the Azure registration resource

Nadal korzystając z komputera połączonego z Internetem i tego samego okna konsoli programu PowerShell, Pobierz klucz aktywacji z zasobu rejestracji utworzonego podczas rejestracji na platformie Azure.Still using the internet-connected computer, and the same PowerShell console window, retrieve an activation key from the registration resource created when you registered with Azure.

Aby uzyskać klucz aktywacji, uruchom następujące polecenia programu PowerShell.To get the activation key, run the following PowerShell commands. Użyj tej samej unikatowej wartości nazwy rejestracji podanej podczas rejestracji na platformie Azure w poprzednim kroku:Use the same unique registration name value you provided when registering with Azure in the previous step:

$RegistrationResourceName = "<unique-registration-name>"
# File path to save the activation key. This example saves the file as C:\ActivationKey.txt.
$KeyOutputFilePath = "$env:SystemDrive\ActivationKey.txt"
$ActivationKey = Get-AzsActivationKey -RegistrationName $RegistrationResourceName `
-KeyOutputFilePath $KeyOutputFilePath

Tworzenie zasobu aktywacji w centrum Azure StackCreate an activation resource in Azure Stack Hub

Wróć do środowiska Azure Stack Hub z plikiem lub tekstem z klucza aktywacji utworzonego za pomocą Get-AzsActivationKey.Return to the Azure Stack Hub environment with the file or text from the activation key created from Get-AzsActivationKey. Uruchom następujące polecenia programu PowerShell, aby utworzyć zasób aktywacji w centrum Azure Stack przy użyciu tego klucza aktywacji:Run the following PowerShell commands to create an activation resource in Azure Stack Hub using that activation key:

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1

$CloudAdminCred = Get-Credential -UserName AZURESTACK\CloudAdmin -Message "Enter the credentials to access the privileged endpoint."
$ActivationKey = "<activation key>"
New-AzsActivationResource -PrivilegedEndpointCredential $CloudAdminCred `
-PrivilegedEndpoint AzS-ERCS01 `
-ActivationKey $ActivationKey

Alternatywnie możesz użyć polecenia cmdlet Get-Content , aby wskazać plik, który zawiera token rejestracji:Alternatively, you can use the Get-Content cmdlet to point to a file that contains your registration token:

# Import the registration module that was downloaded with the GitHub tools
Import-Module C:\AzureStack-Tools-az\Registration\RegisterWithAzure.psm1

$CloudAdminCred = Get-Credential -UserName AZURESTACK\CloudAdmin -Message "Enter the credentials to access the privileged endpoint."
# This example uses the C:\ActivationKey.txt file.
$ActivationKey = Get-Content -Path "$env:SystemDrive\Activationkey.txt"
New-AzsActivationResource -PrivilegedEndpointCredential $CloudAdminCred `
-PrivilegedEndpoint AzS-ERCS01 `
-ActivationKey $ActivationKey

Po zakończeniu aktywacji powinien zostać wyświetlony komunikat podobny do: Twoje środowisko zakończyło proces rejestracji i aktywacji.When activation is complete, you should see a message similar to: Your environment has finished the registration and activation process.

Sprawdź, czy rejestracja zakończyła się pomyślnieVerify the registration was successful

Możesz użyć kafelka zarządzanie regionami , aby sprawdzić, czy rejestracja centrum Azure Stack zakończyła się pomyślnie.You can use the Region management tile to verify that the Azure Stack Hub registration was successful. Ten kafelek jest dostępny na domyślnym pulpicie nawigacyjnym w portalu administratora.This tile is available on the default dashboard in the administrator portal.

  1. Zaloguj się do portalu administratora centrum Azure Stack https://adminportal.local.azurestack.external .Sign in to the Azure Stack Hub administrator portal https://adminportal.local.azurestack.external.

  2. Z poziomu pulpitu nawigacyjnego wybierz pozycję zarządzanie regionami.From the Dashboard, select Region management.

    Kafelek zarządzanie regionami w portalu administratora Azure Stack HubRegion management tile in Azure Stack Hub administrator portal

  3. Wybierz pozycję Właściwości.Select Properties. Ten blok pokazuje stan i szczegóły środowiska.This blade shows the status and details of your environment. Stan może być zarejestrowany lub nie jest zarejestrowany.The status can be Registered or Not registered. W przypadku zarejestrowania zawiera również Identyfikator subskrypcji platformy Azure, który został użyty do zarejestrowania centrum Azure Stack, wraz z grupą zasobów rejestracji i nazwą.If registered, it also shows the Azure subscription ID that you used to register your Azure Stack Hub, along with the registration resource group and name.

Przenoszenie zasobu rejestracjiMove a registration resource

Obsługiwane jest przeniesienie zasobu rejestracji między grupami zasobów w ramach tej samej subskrypcji.Moving a registration resource between resource groups under the same subscription is supported. 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.For more info on moving resources to a new resource group, see Move resources to new resource group or subscription.

Następne krokiNext steps