Azure에 ASDK를 등록 합니다.Register the ASDK with Azure

Azure에 Azure Stack Development Kit (ASDK) 설치를 등록 하 여 Azure에서 marketplace 항목을 다운로드 하 고 상거래 데이터 보고를 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. Marketplace 배포를 포함 하 여 전체 Azure Stack 기능을 지원 하려면 등록 해야 합니다.Registration is required to support full Azure Stack functionality, including marketplace syndication. Marketplace 배포 및 사용 보고와 같은 중요 한 Azure Stack 기능을 테스트 하려면 등록 해야 합니다.Registration is required to enable you to test important Azure Stack functionality like marketplace syndication and usage reporting. Azure Stack 등록 한 후에는 Azure 상거래에 사용량이 보고 됩니다.After you register Azure Stack, usage is reported to Azure commerce. 등록에 사용한 구독에서 볼 수 있습니다.You can see it under the subscription you used for registration. 그러나 ASDK 사용자에 게 보고 하는 사용량에 대해서는 요금이 부과 되지 않습니다.However, ASDK users aren't charged for any usage they report.

ASDK을 등록 하지 않으면 ASDK을 등록 하는 데 도움이 되는 활성화 필요 경고 경고가 표시 될 수 있습니다.If you don't register your ASDK, you might see an Activation Required warning alert that advises you to register your ASDK. 이는 정상적인 동작입니다.This behavior is expected.

사전 요구 사항Prerequisites

이러한 지침을 사용 하 여 ASDK Azure를 등록 하려면 먼저 Azure Stack PowerShell을 설치 하 고 배포 후 구성 문서에 설명 된 대로 Azure Stack 도구를 다운로드 했는지 확인 합니다.Before using these instructions to register the ASDK with Azure, ensure that you've installed the Azure Stack PowerShell and downloaded the Azure Stack tools as described in the post-deployment configuration article.

또한 Azure에 ASDK를 등록 하는 데 사용 되는 컴퓨터에서 PowerShell 언어 모드를 Fulllanguage 로 설정 해야 합니다.The PowerShell language mode must also be set to FullLanguage on the computer used to register the ASDK with Azure. 현재 언어 모드가 full로 설정 되어 있는지 확인 하려면 관리자 권한 PowerShell 창을 열고 다음 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

출력이 Fulllanguage 를 반환 하는지 확인 합니다.Ensure the output returns FullLanguage. 다른 언어 모드가 반환 되는 경우 계속 하기 전에 다른 컴퓨터에서 등록을 실행 하거나 언어 모드를 Fulllanguage 로 설정 해야 합니다.If any other language mode is returned, registration needs to be run on another computer or the language mode set to FullLanguage before continuing.

등록에 사용 되는 Azure AD 계정에는 Azure 구독에 대 한 액세스 권한이 있어야 하 고 해당 구독과 연결 된 디렉터리에서 id 앱 및 서비스 주체를 만들 수 있는 권한이 있어야 합니다.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. 전역 관리자 자격 증명을 사용 하 는 대신 등록에 사용할 서비스 계정을 만들어 Azure에 Azure Stack를 등록 하는 것이 좋습니다.We recommend you register Azure Stack with Azure by creating a service account to use for registration rather than using global admin credentials.

ASDK를 등록 합니다.Register the ASDK

다음 단계를 수행 하 여 Azure에 ASDK를 등록 합니다.Follow these steps to register the ASDK with Azure.

참고

이러한 모든 단계는 권한 있는 끝점에 대 한 액세스 권한이 있는 컴퓨터에서 실행 해야 합니다.All these steps must be run from a computer that has access to the privileged endpoint. ASDK 호스트 컴퓨터입니다.For the ASDK, that's the ASDK host computer.

  1. 관리자 권한으로 PowerShell 콘솔을 엽니다.Open a PowerShell console as an admin.

  2. 다음 PowerShell 명령을 실행 하 여 ASDK 설치를 Azure에 등록 합니다.Run the following PowerShell commands to register your ASDK installation with Azure. Azure 청구 구독 ID와 로컬 ASDK 설치에 모두 로그인 합니다.Sign in to both your Azure billing Subscription ID and the local ASDK installation. 아직 Azure 청구 구독 ID가 없는 경우 여기에서 무료 azure 계정을 만들수 있습니다.If you don't have an Azure billing subscription ID yet, you can create a free Azure account here. Azure Stack 등록 하면 Azure 구독에 대 한 비용이 발생 하지 않습니다.Registering Azure Stack incurs no cost on your Azure subscription.

    AzsRegistration cmdlet을 실행할 때 등록에 사용할 고유 이름을 설정 합니다.Set a unique name for the registration when you run the Set-AzsRegistration cmdlet. Registrationname 매개 변수에는 azurestackregistration 의 기본값이 있습니다.The RegistrationName parameter has a default value of AzureStackRegistration. 그러나 둘 이상의 Azure Stack 인스턴스에서 동일한 이름을 사용 하는 경우 스크립트가 실패 합니다.However, if you use the same name on more than one instance of Azure Stack, 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.
    Add-AzAccount -EnvironmentName "<environment name>"
    
    # Register the Azure Stack 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
    $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. 스크립트가 완료 되 면 다음 메시지가 표시 됩니다. 제공 된 매개 변수를 사용 하 여 환경이 등록 및 활성화 됩니다 .When the script completes, you should see this message: Your environment is now registered and activated using the provided parameters.

이제 환경이 등록 되었습니다.

연결 되지 않은 환경에 등록Register in disconnected environments

연결이 끊어진 환경 (인터넷 연결 없음)에서 Azure Stack를 등록 하는 경우 Azure Stack 환경에서 등록 토큰을 가져온 다음 Azure에 연결할 수 있는 컴퓨터에서 해당 토큰을 사용 하 여 ASDK 환경에 대 한 정품 인증 리소스를 등록 하 고 만듭니다.If you're registering Azure Stack in a disconnected environment (with no internet connectivity), you need to get a registration token from the Azure Stack 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.

중요

이러한 지침을 사용 하 여 Azure Stack를 등록 하려면 먼저 Azure Stack 용 PowerShell을 설치 하 고 ASDK 호스트 컴퓨터와 Azure에 연결 하는 데 사용 되는 인터넷 액세스를 사용 하는 컴퓨터에서 배포 후 구성 문서에 설명 된 대로 Azure Stack 도구를 다운로드 했는지 확인 합니다.Before using these instructions to register Azure Stack, ensure that you've installed PowerShell for Azure Stack and downloaded the Azure Stack 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.

Azure Stack 환경에서 등록 토큰 가져오기Get a registration token from the Azure Stack environment

ASDK 호스트 컴퓨터에서 관리자 권한으로 PowerShell을 시작 하 고 Azure Stack 도구를 다운로드할 때 생성 된 Azurestack-Tools-az Directory에서 등록 폴더로 이동 합니다.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 tools. 다음 PowerShell 명령을 사용 하 여 Registerwithazure 모듈을 가져온 다음 AzsRegistrationToken cmdlet을 사용 하 여 등록 토큰을 가져옵니다.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

인터넷에 연결 된 컴퓨터에서 사용 하기 위해이 등록 토큰을 저장 합니다.Save this registration token for use on the internet-connected computer. 매개 변수를 통해 만든 파일에서 파일 또는 텍스트를 복사할 수 있습니다 $FilePathForRegistrationToken .You can copy the file or the text from the file created by the $FilePathForRegistrationToken parameter.

Azure에 연결 하 고 등록Connect to Azure and register

인터넷에 연결 된 컴퓨터에서 다음 PowerShell 명령을 사용 하 여 Registerwithazure 모듈을 가져온 다음 AzsEnvironment cmdlet을 사용 하 여 방금 만든 등록 토큰 및 고유한 등록 이름을 사용 하 여 Azure에 등록 합니다.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.
Add-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 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

또는 Get Content cmdlet을 사용 하 여 등록 토큰이 포함 된 파일을 가리킬 수 있습니다.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.
Add-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 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

등록이 완료 되 면 다음과 유사한 메시지가 표시 됩니다. Azure Stack 환경이 이제 Azure에 등록 되었습니다 .When registration is complete, you should see a message similar to: Your Azure Stack environment is now registered with Azure.

중요

PowerShell 창을 닫지 마세요.Do not close the PowerShell window.

나중에 참조할 때 사용할 등록 토큰 및 등록 리소스 이름을 저장 합니다.Save the registration token and registration resource name for future reference.

Azure 등록 리소스에서 활성화 키를 검색 합니다.Retrieve an activation key from the Azure registration resource

인터넷에 연결 된 컴퓨터 와 동일한 PowerShell 콘솔 창을 사용 하 여 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.

활성화 키를 가져오려면 다음 PowerShell 명령을 실행 합니다.To get the activation key, run the following PowerShell commands. 이전 단계에서 Azure에 등록할 때 제공한 것과 동일한 고유한 등록 이름 값을 사용 합니다.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

Azure Stack에서 활성화 리소스 만들기Create an Activation Resource in Azure Stack

AzsActivationKey 에서 만든 활성화 키의 파일이 나 텍스트를 사용 하 여 Azure Stack 환경으로 돌아갑니다.Return to the Azure Stack environment with the file or text from the activation key created from Get-AzsActivationKey. 다음 PowerShell 명령을 실행 하 여 해당 활성화 키를 사용 하 Azure Stack에서 활성화 리소스를 만듭니다.Run the following PowerShell commands to create an activation resource in Azure Stack 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

또는 Get Content cmdlet을 사용 하 여 등록 토큰이 포함 된 파일을 가리킬 수 있습니다.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

활성화가 완료 되 면 환경에서 등록 및 활성화 프로세스를 완료 한 것과 유사한 메시지가 표시 됩니다.When activation is complete, you should see a message similar to: Your environment has finished the registration and activation process.

등록이 성공 했는지 확인Verify the registration was successful

지역 관리 타일을 사용 하 여 Azure Stack 등록에 성공 했는지 확인할 수 있습니다.You can use the Region management tile to verify that the Azure Stack registration was successful. 이 타일은 관리자 포털의 기본 대시보드에서 사용할 수 있습니다.This tile is available on the default dashboard in the administrator portal.

  1. Azure Stack 관리자 포털에 로그인 https://adminportal.local.azurestack.external 합니다.Sign in to the Azure Stack administrator portal https://adminportal.local.azurestack.external.

  2. 대시보드에서 지역 관리 를 선택 합니다.From the Dashboard, select Region management.

    Azure Stack 관리자 포털의 지역 관리 타일Region management tile in Azure Stack administrator portal

  3. 속성 을 선택합니다.Select Properties. 이 블레이드에서 사용자 환경의 상태 및 세부 정보를 표시 합니다.This blade shows the status and details of your environment. 상태를 등록 하거나 등록 하지 않을 수 있습니다.The status can be Registered or Not registered. 등록 된 경우 등록 리소스 그룹 및 이름과 함께 Azure Stack를 등록 하는 데 사용한 Azure 구독 ID도 표시 됩니다.If registered, it also shows the Azure subscription ID that you used to register your Azure Stack, along with the registration resource group and name.

등록 리소스 이동Move a registration resource

동일한 구독에서 리소스 그룹 간에 등록 리소스를 이동 하 는 것이 지원 됩니다 .Moving a registration resource between resource groups under the same subscription is supported. 리소스를 새 리소스 그룹으로 이동 하는 방법에 대 한 자세한 내용은 새 리소스 그룹 또는 구독으로 리소스 이동을 참조 하세요.For more info on moving resources to a new resource group, see Move resources to new resource group or subscription.

다음 단계Next steps