Azure를 사용 하 여 Azure Stack 허브 등록Register Azure Stack Hub with Azure

Azure에서 Azure Marketplace 항목을 다운로드 하 고 상거래 데이터 보고를 Microsoft에 다시 설정할 수 있도록 Azure에 Azure Stack 허브를 등록 합니다.Register Azure Stack Hub with Azure so you can download Azure Marketplace items from Azure and set up commerce data reporting back to Microsoft. Azure Stack 허브를 등록 한 후에는 Azure 상거래에 사용량이 보고 되며 등록에 사용 되는 Azure 청구 구독 ID에서 볼 수 있습니다.After you register Azure Stack Hub, usage is reported to Azure commerce and you can see it under the Azure billing Subscription ID used for registration.

이 문서의 정보는 Azure에 허브 통합 시스템 Azure Stack 등록 하는 방법을 설명 합니다.The information in this article describes registering Azure Stack Hub integrated systems with Azure. Asasin Azure를 등록 하는 방법에 대 한 자세한 내용은 ASDK 설명서에서 Azure Stack 허브 등록 을 참조 하세요.For information about registering the ASDK with Azure, see Azure Stack Hub registration in the ASDK documentation.

중요

Marketplace에 항목을 제공 하는 것을 포함 하 여 전체 Azure Stack 허브 기능을 지원 하려면 등록 해야 합니다.Registration is required to support full Azure Stack Hub functionality, including offering items in the marketplace. 종 량 제 청구 모델을 사용 하는 경우 등록 하지 않는 경우 Azure Stack 허브 라이선스 용어를 위반 하 게 됩니다.You'll be in violation of Azure Stack Hub licensing terms if you don't register when using the pay-as-you-use billing model. Azure Stack 허브 라이선스 모델에 대해 자세히 알아보려면 구입 방법 페이지를 참조 하세요.To learn more about Azure Stack Hub licensing models, see the How to buy page.

전제 조건Prerequisites

등록 하기 전에 다음 필수 구성 요소를 완료 합니다.Complete the following prerequisites before you register:

  • 자격 증명을 확인하십시오.Verify your credentials.
  • PowerShell 언어 모드를 설정 합니다.Set the PowerShell language mode.
  • Azure Stack 허브 용 PowerShell을 설치 합니다.Install PowerShell for Azure Stack Hub.
  • Azure Stack 허브 도구를 다운로드 합니다.Download the Azure Stack Hub tools.
  • 청구 모델을 결정 합니다.Determine your billing model.
  • 고유한 등록 이름을 결정 합니다.Determine your unique registration name.

자격 증명 확인Verify your credentials

Azure에 Azure Stack Hub를 등록 하려면 먼저 다음이 있어야 합니다.Before registering Azure Stack Hub with Azure, you must have:

  • Azure 구독에 대 한 구독 ID입니다.The subscription ID for an Azure subscription. EA, CSP 또는 CSP 공유 서비스 구독만 등록을 지원 합니다.Only EA, CSP, or CSP shared services subscriptions are supported for registration. Csp 는 csp 또는 APSS 구독의 사용여부를 결정 해야 합니다.CSPs need to decide whether to use a CSP or APSS subscription.

    ID를 가져오려면 Azure에 로그인 하 고 모든 서비스 를 클릭 합니다.To get the ID, sign in to Azure, click All services. 그런 다음 일반 범주에서 구독 을 선택 하 고, 사용 하려는 구독을 클릭 하 고, Essentials 아래에서 구독 ID를 찾을 수 있습니다.Then, under the GENERAL category, select Subscriptions, click the subscription you want to use, and under Essentials you can find the Subscription ID. 프로덕션 및 개발 또는 테스트 환경에 대해 별도의 구독을 사용 하는 것이 가장 좋습니다.As a best practice, use separate subscriptions for production and dev or test environments.
  • Azure 구독에 대 한 구독 ID입니다.The subscription ID for an Azure subscription. EA 구독만 등록을 지원 합니다.Only EA subscriptions are supported for registration.

    ID를 가져오려면 Azure에 로그인 하 고 모든 서비스 를 클릭 합니다.To get the ID, sign in to Azure, click All services. 그런 다음 일반 범주에서 구독 을 선택 하 고, 사용 하려는 구독을 클릭 하 고, Essentials 아래에서 구독 ID를 찾을 수 있습니다.Then, under the GENERAL category, select Subscriptions, click the subscription you want to use, and under Essentials you can find the Subscription ID. 프로덕션 및 개발 또는 테스트 환경에 대해 별도의 구독을 사용 하는 것이 가장 좋습니다.As a best practice, use separate subscriptions for production and dev or test environments.

참고

독일 클라우드 구독은 현재 지원 되지 않습니다.Germany cloud subscriptions aren't currently supported.

  • 구독의 소유자 인 계정의 사용자 이름 및 암호입니다.The username and password for an account that's an owner for the subscription.

  • 사용자 계정에는 Azure 구독에 대 한 액세스 권한이 있어야 하 고 해당 구독과 연결 된 디렉터리에서 id 앱 및 서비스 주체를 만들 수 있는 권한이 있어야 합니다.The user account 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 that you register Azure Stack Hub with Azure using least-privilege administration. 등록에 대 한 구독에 대 한 액세스를 제한 하는 사용자 지정 역할 정의를 만드는 방법에 대 한 자세한 내용은 Azure Stack 허브에 대 한 등록 역할 만들기를 참조 하세요.For more information on how to create a custom role definition that limits access to your subscription for registration, see create a registration role for Azure Stack Hub.

  • Azure Stack 허브 리소스 공급자를 등록 했습니다 (자세한 내용은 다음 Azure Stack 허브 리소스 공급자 등록 섹션 참조).Registered the Azure Stack Hub resource provider (see the following Register Azure Stack Hub Resource Provider section for details).

등록 후에는 Azure Active Directory (Azure AD) 전역 관리자 권한이 필요 하지 않습니다.After registration, Azure Active Directory (Azure AD) global administrator permission isn't required. 그러나 일부 작업에는 전역 관리자 자격 증명이 필요할 수 있습니다 (예: 리소스 공급자 설치 관리자 스크립트 또는 권한을 부여 해야 하는 새 기능).However, some operations may require the global admin credential (for example, a resource provider installer script or a new feature requiring a permission to be granted). 일시적으로 계정의 전역 관리자 권한을 복원 하거나 기본 공급자 구독의 소유자 인 별도의 전역 관리자 계정을 사용할 수 있습니다.You can either temporarily reinstate the account's global admin permissions or use a separate global admin account that's an owner of the default provider subscription.

Azure Stack 허브를 등록 하는 사용자는 Azure AD의 서비스 사용자 소유자입니다.The user who registers Azure Stack Hub is the owner of the service principal in Azure AD. Azure Stack 허브를 등록 한 사용자만 Azure Stack 허브 등록을 수정할 수 있습니다.Only the user who registered Azure Stack Hub can modify the Azure Stack Hub registration. 등록 서비스 사용자의 소유자가 아닌 관리자가 Azure Stack 허브를 등록 하거나 다시 등록 하려고 시도 하는 경우 403 응답을 통해 제공 될 수 있습니다.If a non-admin user that's not an owner of the registration service principal attempts to register or re-register Azure Stack Hub, they may come across a 403 response. 403 응답은 사용자에 게 작업을 완료할 수 있는 충분 한 권한이 없음을 나타냅니다.A 403 response indicates the user has insufficient permissions to complete the operation.

이러한 요구 사항을 충족 하는 Azure 구독이 없는 경우 여기에서 무료 azure 계정을 만들수 있습니다.If you don't have an Azure subscription that meets these requirements, you can create a free Azure account here. Azure Stack 허브를 등록 하면 Azure 구독에 대 한 비용이 발생 하지 않습니다.Registering Azure Stack Hub incurs no cost on your Azure subscription.

참고

둘 이상의 Azure Stack 허브가 있는 경우 각 Azure Stack 허브를 자체 구독에 등록 하는 것이 가장 좋습니다.If you have more than one Azure Stack Hub, a best practice is to register each Azure Stack Hub to its own subscription. 이렇게 하면 사용을 보다 쉽게 추적할 수 있습니다.This makes it easier for you to track usage.

PowerShell 언어 모드 설정Set the PowerShell language mode

Azure Stack 허브를 성공적으로 등록 하려면 PowerShell 언어 모드를 FullLanguageMode 로 설정 해야 합니다.To successfully register Azure Stack Hub, the PowerShell language mode must be set to FullLanguageMode. 현재 언어 모드가 full로 설정 되어 있는지 확인 하려면 관리자 권한 PowerShell 창을 열고 다음 PowerShell cmdlet을 실행 합니다.To verify that the current language mode is set to full, open an elevated PowerShell window and run the following PowerShell cmdlets:

$ExecutionContext.SessionState.LanguageMode

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

Azure Stack 허브 용 PowerShell 설치Install PowerShell for Azure Stack Hub

Azure Stack 허브에 최신 PowerShell을 사용 하 여 Azure에 등록 합니다.Use the latest PowerShell for Azure Stack Hub to register with Azure.

최신 버전이 아직 설치 되지 않은 경우 Azure Stack 허브에 대 한 PowerShell 설치를 참조 하세요.If the latest version isn't already installed, see install PowerShell for Azure Stack Hub.

Azure Stack 허브 도구 다운로드Download the Azure Stack Hub tools

Azure Stack Hub tools GitHub 리포지토리에는 등록 기능을 포함 하 여 Azure Stack 허브 기능을 지 원하는 PowerShell 모듈이 포함 되어 있습니다.The Azure Stack Hub tools GitHub repository contains PowerShell modules that support Azure Stack Hub functionality, including registration functionality. 등록 프로세스 중에 Azure Stack 허브 인스턴스를 Azure에 등록 하려면 .Psm1 PowerShell 모듈 (Azure Stack 허브 도구 리포지토리에 있음)을 가져와서 사용 해야 합니다.During the registration process, you need to import and use the RegisterWithAzure.psm1 PowerShell module (found in the Azure Stack Hub tools repository) to register your Azure Stack Hub instance with Azure.

최신 버전을 사용 하 고 있는지 확인 하려면 Azure에 등록 하기 전에 기존 버전의 Azure Stack Hub 도구를 삭제 하 고 GitHub에서 최신 버전을 다운로드 합니다.To ensure you're using the latest version, delete any existing versions of the Azure Stack Hub tools and download the latest version from GitHub before registering with Azure.

참고

또한 OAW (Operator Access Workstation)를 사용 하 여 권한 있는 끝점 (PEP), 지원 시나리오에 대 한 관리자 포털 및 Azure Stack 허브 GitHub 도구에 액세스할 수 있습니다.You can also use the The Operator Access Workstation (OAW) to access the privileged endpoint (PEP), the Administrator portal for support scenarios, and Azure Stack Hub GitHub Tools. 자세한 내용은 Azure Stack 허브 운영자 액세스 워크스테이션을 참조 하세요.For more information see Azure Stack Hub Operator Access Workstation.

청구 모델 결정Determine your billing model

연결 된 배포를 통해 Azure Stack 허브에서 인터넷 및 Azure에 연결할 수 있습니다.A connected deployment allows Azure Stack Hub to connect to the internet, and to Azure. 또한 Azure AD 또는 Active Directory Federation Services (AD FS)를 id 저장소로 사용 하 고 종 량 제 또는 용량 기반의 두 청구 모델 중에서 선택할 수 있습니다.You can also use either Azure AD or Active Directory Federation Services (AD FS) as your identity store, and choose from two billing models: pay-as-you-use or capacity-based. 등록 스크립트를 실행 하는 동안 나중에 대금 청구 모델을 지정 합니다.You specify the billing model later, while running the registration script.

연결이 끊어진 배포를 사용 하면 인터넷에 연결 하지 않고 Azure Stack 허브를 사용할 수 있습니다.A disconnected deployment allows you to use Azure Stack Hub without a connection to the internet. 연결 되지 않은 배포를 사용 하면 AD FS id 저장소 및 용량 기반 청구 모델로 제한 됩니다.With a disconnected deployment, you're limited to an AD FS identity store and the capacity-based billing model. 등록 스크립트를 실행 하는 동안 나중에 대금 청구 모델을 지정 합니다.You specify the billing model later, while running the registration script.

고유한 등록 이름 확인Determine your unique registration name

등록 스크립트를 실행 하는 경우 고유한 등록 이름을 제공 해야 합니다.When you run the registration script, you must provide a unique registration name. Azure Stack Hub 구독을 Azure 등록과 연결 하는 쉬운 방법은 Azure Stack 허브 클라우드 ID 를 사용 하는 것입니다.An easy way to associate your Azure Stack Hub subscription with an Azure registration is to use your Azure Stack Hub Cloud ID.

참고

용량 기반 청구 모델을 사용 하는 Azure Stack 허브 등록은 만료 된 등록을 삭제 하 고 Azure에 다시 등록 하는 경우를 제외 하 고 연간 구독이 만료 된 후에 다시 등록할 때 고유 이름을 변경 해야 합니다.Azure Stack Hub registrations using the capacity-based billing model will need to change the unique name when re-registering after those yearly subscriptions expire unless you delete the expired registration and re-register with Azure.

Azure Stack 허브 배포에 대 한 클라우드 ID를 확인 하려면 클라우드 Id 찾기를 참조 하세요.To determine the Cloud ID for your Azure Stack Hub deployment, see Find your cloud ID.

종 량 제 청구로 등록Register with pay-as-you-use billing

이러한 단계를 사용 하 여 종 량 제 청구 모델을 사용 하 여 Azure에 Azure Stack 허브를 등록 합니다.Use these steps to register Azure Stack Hub with Azure using the pay-as-you-use billing model.

참고

이러한 모든 단계는 PEP (권한 있는 끝점)에 액세스할 수 있는 컴퓨터에서 실행 해야 합니다.All these steps must be run from a computer that has access to the privileged endpoint (PEP). PEP에 대 한 자세한 내용은 Azure Stack 허브에서 권한 있는 끝점 사용을 참조 하세요.For details about the PEP, see Using the privileged endpoint in Azure Stack Hub.

연결 된 환경에서 인터넷 및 Azure에 액세스할 수 있습니다.Connected environments can access the internet and Azure. 이러한 환경에서는 Azure에 Azure Stack Hub 리소스 공급자를 등록 한 다음 청구 모델을 구성 해야 합니다.For these environments, you need to register the Azure Stack Hub resource provider with Azure and then configure your billing model.

  1. Azure Stack 허브 리소스 공급자를 Azure에 등록 하려면 관리자 권한으로 PowerShell ISE를 시작 하 고 환경 이름 매개 변수를 적절 한 Azure 구독 유형으로 설정 하 여 다음 powershell cmdlet을 사용 합니다 (아래 매개 변수 참조).To register the Azure Stack Hub resource provider with Azure, start PowerShell ISE as an administrator and use the following PowerShell cmdlets with the EnvironmentName parameter set to the appropriate Azure subscription type (see parameters below).

  2. Azure Stack 허브를 등록 하는 데 사용한 Azure 계정을 추가 합니다.Add the Azure account that you used to register Azure Stack Hub. 계정을 추가 하려면 AzAccount cmdlet을 실행 합니다.To add the account, run the Connect-AzAccount cmdlet. Azure 계정 자격 증명을 입력 하 라는 메시지가 표시 되며 계정 구성에 따라 2 단계 인증을 사용 해야 할 수 있습니다.You're prompted to enter your Azure account credentials and you may have to use two-factor authentication based on your account's configuration.

    Connect-AzAccount -EnvironmentName "<environment name>"
    
    매개 변수Parameter 설명Description
    EnvironmentNameEnvironmentName Azure 클라우드 구독 환경 이름입니다.The Azure cloud subscription environment name. 지원 되는 환경 이름은 Azurecloud, Azureus정부 또는 중국 Azure 구독을 사용 하는 경우 AzureChinaCloud 입니다.Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure Subscription, AzureChinaCloud.

    참고

    세션이 만료 되거나 암호가 변경 되었거나 단순히 계정을 전환 하려는 경우 AzAccount를 사용 하 여 로그인 하기 전에 다음 cmdlet을 실행 합니다. Remove-AzAccount-Scope ProcessIf your session expires, your password has changed, or you simply wish to switch accounts, run the following cmdlet before you sign in using Connect-AzAccount: Remove-AzAccount-Scope Process

  3. 구독이 여러 개인 경우 다음 명령을 실행 하 여 사용 하려는 구독을 선택 합니다.If you have multiple subscriptions, run the following command to select the one you want to use:

    Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription
    
  4. 다음 명령을 실행 하 여 Azure 구독에 Azure Stack Hub 리소스 공급자를 등록 합니다.Run the following command to register the Azure Stack Hub resource provider in your Azure subscription:

    Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack
    
  5. 관리자 권한으로 PowerShell ISE를 시작 하 고 Azure Stack 허브 도구를 다운로드할 때 생성 된 Azurestack-Tools-az Directory에서 등록 폴더로 이동 합니다.Start PowerShell ISE as an administrator and navigate to the Registration folder in the AzureStack-Tools-az directory created when you downloaded the Azure Stack Hub tools. PowerShell을 사용 하 여 Registerwithazure 모듈을 가져옵니다.Import the RegisterWithAzure.psm1 module using PowerShell:

    Import-Module .\RegisterWithAzure.psm1
    
  6. 다음으로, 동일한 PowerShell 세션에서 올바른 Azure PowerShell 컨텍스트에 로그인 했는지 확인 합니다.Next, in the same PowerShell session, ensure you're signed in to the correct Azure PowerShell context. 이 컨텍스트는 이전에 Azure Stack 허브 리소스 공급자를 등록 하는 데 사용 된 Azure 계정입니다.This context would be the Azure account that was used to register the Azure Stack Hub resource provider previously. 실행할 PowerShell:PowerShell to run:

    Connect-AzAccount -Environment "<environment name>"
    
    매개 변수Parameter 설명Description
    EnvironmentNameEnvironmentName Azure 클라우드 구독 환경 이름입니다.The Azure cloud subscription environment name. 지원 되는 환경 이름은 Azurecloud, Azureus정부 또는 중국 Azure 구독을 사용 하는 경우 AzureChinaCloud 입니다.Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure Subscription, AzureChinaCloud.
  7. 동일한 PowerShell 세션에서 AzsRegistration cmdlet을 실행 합니다.In the same PowerShell session, run the Set-AzsRegistration cmdlet. 실행할 PowerShell:PowerShell to run:

    $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
    

    Set-AzsRegistration cmdlet에 대 한 자세한 내용은 등록 참조를 참조 하세요.For more information on the Set-AzsRegistration cmdlet, see Registration reference.

이 프로세스는 10 ~ 15 분 정도 걸립니다.The process takes between 10 and 15 minutes. 명령이 완료 되 면 "제공 된 매개 변수를 사용 하 여 현재 환경이 등록 및 활성화 되었습니다." 라는 메시지가 표시 됩니다.When the command completes, you see the message "Your environment is now registered and activated using the provided parameters."

용량 청구에 등록Register with capacity billing

용량 청구 모델을 사용 하 여 Azure에 Azure Stack 허브를 등록 하려면 다음 단계를 따르세요.Use these steps to register Azure Stack Hub with Azure using the capacity billing model.

참고

이러한 모든 단계는 PEP (권한 있는 끝점)에 액세스할 수 있는 컴퓨터에서 실행 해야 합니다.All these steps must be run from a computer that has access to the privileged endpoint (PEP). PEP에 대 한 자세한 내용은 Azure Stack 허브에서 권한 있는 끝점 사용을 참조 하세요.For details about the PEP, see Using the privileged endpoint in Azure Stack Hub.

연결 된 환경에서 인터넷 및 Azure에 액세스할 수 있습니다.Connected environments can access the internet and Azure. 이러한 환경에서는 Azure에 Azure Stack Hub 리소스 공급자를 등록 한 다음 청구 모델을 구성 해야 합니다.For these environments, you need to register the Azure Stack Hub resource provider with Azure and then configure your billing model.

  1. Azure Stack 허브 리소스 공급자를 Azure에 등록 하려면 관리자 권한으로 PowerShell ISE를 시작 하 고 환경 이름 매개 변수를 적절 한 Azure 구독 유형으로 설정 하 여 다음 powershell cmdlet을 사용 합니다 (아래 매개 변수 참조).To register the Azure Stack Hub resource provider with Azure, start PowerShell ISE as an administrator and use the following PowerShell cmdlets with the EnvironmentName parameter set to the appropriate Azure subscription type (see parameters below).

  2. Azure Stack 허브를 등록 하는 데 사용한 Azure 계정을 추가 합니다.Add the Azure account that you used to register Azure Stack Hub. 계정을 추가 하려면 AzAccount cmdlet을 실행 합니다.To add the account, run the Connect-AzAccount cmdlet. Azure 계정 자격 증명을 입력 하 라는 메시지가 표시 되며 계정 구성에 따라 2 단계 인증을 사용 해야 할 수 있습니다.You're prompted to enter your Azure account credentials and you may have to use two-factor authentication based on your account's configuration.

    Connect-AzAccount -Environment "<environment name>"
    
    매개 변수Parameter 설명Description
    EnvironmentNameEnvironmentName Azure 클라우드 구독 환경 이름입니다.The Azure cloud subscription environment name. 지원 되는 환경 이름은 Azurecloud, Azureus정부 또는 중국 Azure 구독을 사용 하는 경우 AzureChinaCloud 입니다.Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure Subscription, AzureChinaCloud.
  3. 구독이 여러 개인 경우 다음 명령을 실행 하 여 사용 하려는 구독을 선택 합니다.If you have multiple subscriptions, run the following command to select the one you want to use:

    Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription
    
  4. 다음 명령을 실행 하 여 Azure 구독에 Azure Stack Hub 리소스 공급자를 등록 합니다.Run the following command to register the Azure Stack Hub resource provider in your Azure subscription:

    Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack
    
  5. 관리자 권한으로 PowerShell ISE를 시작 하 고 Azure Stack 허브 도구를 다운로드할 때 생성 된 Azurestack-Tools-az Directory에서 등록 폴더로 이동 합니다.Start PowerShell ISE as an administrator and navigate to the Registration folder in the AzureStack-Tools-az directory created when you downloaded the Azure Stack Hub tools. PowerShell을 사용 하 여 Registerwithazure 모듈을 가져옵니다.Import the RegisterWithAzure.psm1 module using 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> `
       -AgreementNumber <EA agreement number> `
       -BillingModel Capacity `
       -RegistrationName $RegistrationName
    

    참고

    매개 변수를 false로 설정 하 여 AzsRegistration cmdlet에 대 한 UsageReportingEnabled 매개 변수로 사용 보고를 사용 하지 않도록 설정할 수 있습니다.You can disable usage reporting with the UsageReportingEnabled parameter for the Set-AzsRegistration cmdlet by setting the parameter to false.

    Set-AzsRegistration cmdlet에 대 한 자세한 내용은 등록 참조를 참조 하세요.For more information on the Set-AzsRegistration cmdlet, see Registration reference.

용량 청구에 등록Register with capacity billing

인터넷에 연결 되지 않은 연결 되지 않은 환경에서 Azure Stack 허브를 등록 하는 경우 Azure Stack 허브 환경에서 등록 토큰을 가져와야 합니다.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. 그런 다음 Azure에 연결할 수 있는 컴퓨터에서 해당 토큰을 사용 하 고 PowerShell for Azure Stack Hub를 설치 합니다.Then use that token on a computer that can connect to Azure and has PowerShell for Azure Stack Hub installed.

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

  1. 관리자 권한으로 PowerShell ISE를 시작 하 고 Azure Stack 허브 도구를 다운로드할 때 생성 된 Azurestack-Tools-az Directory에서 등록 폴더로 이동 합니다.Start PowerShell ISE as an administrator and navigate to the Registration folder in the AzureStack-Tools-az directory created when you downloaded the Azure Stack Hub tools. Registerwithazure 모듈을 가져옵니다.Import the RegisterWithAzure.psm1 module:

    Import-Module .\RegisterWithAzure.psm1
    
  2. 등록 토큰을 가져오려면 다음 PowerShell cmdlet을 실행 합니다.To get the registration token, run the following PowerShell cmdlets:

    $FilePathForRegistrationToken = "$env:SystemDrive\RegistrationToken.txt"
    $RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $YourCloudAdminCredential -UsageReportingEnabled:$False -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel Capacity -AgreementNumber '<EA agreement number>' -TokenOutputFilePath $FilePathForRegistrationToken
    

    Get-AzsRegistrationToken cmdlet에 대 한 자세한 내용은 등록 참조를 참조 하세요.For more information on the Get-AzsRegistrationToken cmdlet, see Registration reference.

    등록 토큰은 $FilePathForRegistrationToken 에 대해 지정 된 파일에 저장 됩니다.The registration token is saved in the file specified for $FilePathForRegistrationToken. 임의로 파일 경로 또는 파일 이름을 변경할 수 있습니다.You can change the filepath or filename at your discretion.

  3. Azure에 연결 된 컴퓨터에서 사용 하기 위해이 등록 토큰을 저장 합니다.Save this registration token for use on the Azure-connected machine. $FilePathForRegistrationToken 에서 파일 또는 텍스트를 복사할 수 있습니다.You can copy the file or the text from $FilePathForRegistrationToken.

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

인터넷에 연결 된 컴퓨터에서 동일한 단계를 수행 하 여 RegisterWithAzure 모듈을 가져오고 올바른 Azure PowerShell 컨텍스트에 로그인 합니다.On the computer that is connected to the internet, do the same steps to import the RegisterWithAzure.psm1 module and sign in to the correct Azure PowerShell context. 그런 다음 AzsEnvironment를 호출 합니다.Then call Register-AzsEnvironment. Azure에 등록할 등록 토큰을 지정 합니다.Specify the registration token to register with Azure. 동일한 Azure 구독 ID를 사용 하 여 둘 이상의 Azure Stack 허브 인스턴스를 등록 하는 경우 고유한 등록 이름을 지정 합니다.If you're registering more than one instance of Azure Stack Hub using the same Azure Subscription ID, specify a unique registration name.

등록 토큰 및 고유한 토큰 이름이 필요 합니다.You need your registration token and a unique token name.

  1. 관리자 권한으로 PowerShell ISE를 시작 하 고 Azure Stack 허브 도구를 다운로드할 때 생성 된 Azurestack-Tools-az Directory에서 등록 폴더로 이동 합니다.Start PowerShell ISE as an administrator and navigate to the Registration folder in the AzureStack-Tools-az directory created when you downloaded the Azure Stack Hub tools. Registerwithazure 모듈을 가져옵니다.Import the RegisterWithAzure.psm1 module:

    Import-Module .\RegisterWithAzure.psm1
    
  2. 그런 후 다음 PowerShell cmdlet을 실행 합니다.Then run the following PowerShell cmdlets:

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

필요에 따라 Get-Content cmdlet을 사용 하 여 등록 토큰이 포함 된 파일을 가리킬 수 있습니다.Optionally, you can use the Get-Content cmdlet to point to a file that contains your registration token.

등록 토큰 및 고유한 토큰 이름이 필요 합니다.You need your registration token and a unique token name.

  1. 관리자 권한으로 PowerShell ISE를 시작 하 고 Azure Stack 허브 도구를 다운로드할 때 생성 된 Azurestack-Tools-az Directory에서 등록 폴더로 이동 합니다.Start PowerShell ISE as an administrator and navigate to the Registration folder in the AzureStack-Tools-az directory created when you downloaded the Azure Stack Hub tools. Registerwithazure 모듈을 가져옵니다.Import the RegisterWithAzure.psm1 module:

    Import-Module .\RegisterWithAzure.psm1
    
  2. 그런 후 다음 PowerShell cmdlet을 실행 합니다.Then run the following PowerShell cmdlets:

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

참고

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

Azure 등록 리소스에서 활성화 키를 검색 합니다.Retrieve an Activation Key from Azure Registration Resource

다음으로, AzsEnvironment 중에 Azure에서 만든 등록 리소스에서 활성화 키를 검색 해야 합니다.Next, you need to retrieve an activation key from the registration resource created in Azure during Register-AzsEnvironment.

정품 인증 키를 가져오려면 다음 PowerShell cmdlet을 실행 합니다.To get the activation key, run the following PowerShell cmdlets:

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

활성화 키는 $KeyOutputFilePath 에 대해 지정 된 파일에 저장 됩니다.The activation key is saved in the file specified for $KeyOutputFilePath. 임의로 파일 경로 또는 파일 이름을 변경할 수 있습니다.You can change the filepath or filename at your discretion.

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

AzsActivationKey에서 만든 활성화 키의 파일이 나 텍스트를 사용 하 여 Azure Stack 허브 환경으로 돌아갑니다.Return to the Azure Stack Hub environment with the file or text from the activation key created from Get-AzsActivationKey. 그런 다음 해당 정품 인증 키를 사용 하 여 Azure Stack 허브에 활성화 리소스를 만듭니다.Next create an activation resource in Azure Stack Hub using that activation key. 활성화 리소스를 만들려면 다음 PowerShell cmdlet을 실행 합니다.To create an activation resource, run the following PowerShell cmdlets:

$ActivationKey = "<activation key>"
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey

필요에 따라 Get-Content cmdlet을 사용 하 여 등록 토큰이 포함 된 파일을 가리킬 수 있습니다.Optionally, you can use the Get-Content cmdlet to point to a file that contains your registration token:

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

허브 등록 Azure Stack 확인Verify Azure Stack Hub registration

지역 관리 타일을 사용 하 여 Azure Stack 허브 등록이 성공 했는지 확인할 수 있습니다.You can use the Region management tile to verify that the Azure Stack Hub registration was successful. 이 타일은 관리자 포털의 기본 대시보드에서 사용할 수 있습니다.This tile is available on the default dashboard in the administrator portal. 상태를 등록 하거나 등록 하지 않을 수 있습니다.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 Hub along with the registration resource group and name.

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

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

  3. 속성 을 선택합니다.Select Properties. 이 블레이드에서 사용자 환경의 상태 및 세부 정보를 표시 합니다.This blade shows the status and details of your environment. 상태는 등록 되지 않았거나 등록 되지 않았거나 만료 될 수 있습니다.The status can be Registered, Not registered, or Expired.

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

    등록 된 경우 속성은 다음과 같습니다.If registered, the properties include:

    • 등록 구독 id: AZURE 구독 id를 등록 하 고 Azure Stack 허브에 연결 했습니다.Registration subscription ID: The Azure subscription ID registered and associated to Azure Stack Hub.
    • 등록 리소스 그룹: 연결 된 구독에서 Azure Stack 허브 리소스를 포함 하는 Azure 리소스 그룹입니다.Registration resource group: The Azure resource group in the associated subscription containing the Azure Stack Hub resources.
  4. Azure Portal를 사용 하 여 Azure Stack Hub 등록 리소스를 확인 한 후 등록에 성공 했는지 확인할 수 있습니다.You can use the Azure portal to view Azure Stack Hub registration resources, and then verify that the registration succeeded. Azure Stack 허브를 등록 하는 데 사용한 구독과 연결 된 계정을 사용 하 여 Azure Portal 에 로그인 합니다.Sign in to the Azure portal using an account associated to the subscription you used to register Azure Stack Hub. 모든 리소스 를 선택 하 고, 숨겨진 유형 표시 확인란을 사용 하도록 설정 하 고, 등록 이름을 선택 합니다.Select All resources, enable the Show hidden types checkbox, and select the registration name.

  5. 등록에 실패 한 경우 문제를 해결 하려면 여기에 나와 있는 단계 를 수행 하 여 다시 등록 해야 합니다.If the registration didn't succeed, you must re-register by following the steps here to resolve the issue.

또는 Marketplace 관리 기능을 사용 하 여 등록에 성공 했는지 확인할 수 있습니다.Alternatively, you can verify if your registration was successful by using the Marketplace management feature. Marketplace 관리 블레이드에서 marketplace 항목의 목록이 표시 되 면 등록에 성공 했습니다.If you see a list of marketplace items in the Marketplace management blade, your registration was successful. 그러나 연결 되지 않은 환경에서는 Marketplace 관리에서 marketplace 항목을 볼 수 없습니다.However, in disconnected environments, you can't see marketplace items in Marketplace management.

참고

등록이 완료 되 면 등록 하지 않은에 대 한 활성 경고가 더 이상 표시 되지 않습니다.After registration is complete, the active warning for not registering will no longer appear. 1904 이전의 Azure Stack 허브 릴리스에서는 연결 되지 않은 경우에도 Azure Stack 허브를 등록 하 고 활성화 하 라는 메시지가 Marketplace 관리에 표시 됩니다.In Azure Stack Hub releases before 1904, in disconnected scenarios, you see a message in Marketplace management asking you to register and activate your Azure Stack Hub, even if you have registered successfully. 이 메시지는 릴리스 1904 이상에 표시 되지 않습니다.This message doesn't appear in release 1904 and later.

갱신 또는 변경 등록Renew or change registration

다음과 같은 상황에서 등록을 업데이트 해야 합니다.You need to update your registration in the following circumstances:

  • 용량 기반 매년 구독을 갱신 한 후After you renew your capacity-based yearly subscription.
  • 청구 모델을 변경 하는 경우When you change your billing model.
  • 용량 기반 청구를 위해 변경 (노드 추가/제거)을 확장 하는 경우When you scale changes (add/remove nodes) for capacity-based billing.

전제 조건Prerequisites

등록을 갱신 하거나 변경 하려면 관리자 포털 에서 다음 정보가 필요 합니다.You need the following information from the administrator portal to renew or change registration:

관리자 포털Administrator portal Cmdlet 매개 변수Cmdlet parameter 참고Notes
등록 구독 IDREGISTRATION SUBSCRIPTION ID SubscriptionSubscription 이전 등록 중에 사용 되는 구독 IDSubscription ID used during previous registration
등록 리소스 그룹REGISTRATION RESOURCE GROUP ResourceGroupNameResourceGroupName 이전 등록 리소스가 있는 리소스 그룹Resource group under which the previous registration resource exists
등록 이름REGISTRATION NAME RegistrationNameRegistrationName 이전 등록 중에 사용 되는 등록 이름Registration name used during previous registration

사용 하는 구독 변경Change the subscription you use

사용 하는 구독을 변경 하려면 먼저 AzsRegistration cmdlet을 실행 한 다음 올바른 Azure PowerShell 컨텍스트에 로그인 했는지 확인 해야 합니다.If you want to change the subscription you use, you must first run the Remove-AzsRegistration cmdlet, then ensure you're signed in to the correct Azure PowerShell context. 그런 다음를 포함 하 여 변경 된 매개 변수와 함께 AzsRegistration 를 실행 <billing model> 합니다.Then run Set-AzsRegistration with any changed parameters, including <billing model>. AzsRegistration 를 실행 하는 동안 등록 중에 사용 되는 구독에 로그인 하 고 RegistrationName ResourceGroupName 관리자 포털과같이 및 매개 변수의 값을 사용 해야 합니다.While running Remove-AzsRegistration, you must be signed in to the subscription used during the registration and use values of the RegistrationName and ResourceGroupName parameters as shown in the administrator portal:

# select the subscription used during the registration (shown in portal)
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
# 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>'

청구 모델 변경, 기능 제공 방법 또는 인스턴스 다시 등록Change billing model, how features are offered, or re-register your instance

이 섹션은 청구 모델을 변경 하거나, 기능을 제공 하거나, 인스턴스를 다시 등록 하려는 경우에 적용 됩니다.This section applies if you want to change the billing model, how features are offered, or you want to re-register your instance. 이러한 모든 경우에 대해 등록 함수를 호출 하 여 새 값을 설정 합니다.For all of these cases, you call the registration function to set the new values. 먼저 현재 등록을 제거할 필요가 없습니다.You don't need to first remove the current registration. 관리자 포털에 표시 된 구독 ID에 로그인 한 다음 BillingModel RegistrationName , 및 ResourceGroupName 매개 변수 값을 관리자 포털에 표시 된 것과 동일 하 게 유지 하면서 새 값으로 등록을 다시 실행 합니다.Sign in to the subscription ID shown in the administrator portal, and then rerun registration with a new BillingModel value while keeping the RegistrationName and ResourceGroupName parameters values same as shown in the administrator portal:

# select the subscription used during the registration
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
# 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>'

다음과 같은 상황에서 등록을 업데이트 하거나 갱신 해야 합니다.You need to update or renew your registration in the following circumstances:

  • 용량 기반 매년 구독을 갱신 한 후After you renew your capacity-based yearly subscription.
  • 청구 모델을 변경 하는 경우When you change your billing model.
  • 용량 기반 청구를 위해 변경 (노드 추가/제거)을 확장 하는 경우When you scale changes (add/remove nodes) for capacity-based billing.

Azure Stack 허브에서 활성화 리소스를 제거 합니다.Remove the activation resource from Azure Stack Hub

먼저 Azure Stack 허브에서 활성화 리소스를 제거 하 고 Azure에서 등록 리소스를 제거 해야 합니다.You first need to remove the activation resource from Azure Stack Hub, and then the registration resource in Azure.

Azure Stack Hub에서 활성화 리소스를 제거 하려면 Azure Stack 허브 환경에서 다음 PowerShell cmdlet을 실행 합니다.To remove the activation resource in Azure Stack Hub, run the following PowerShell cmdlets in your Azure Stack Hub environment:

Remove-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint

그런 다음 Azure에서 등록 리소스를 제거 하려면 Azure에 연결 된 컴퓨터에 있는지 확인 하 고 올바른 Azure PowerShell 컨텍스트에 로그인 한 다음 아래 설명 된 대로 적절 한 PowerShell cmdlet을 실행 합니다.Next, to remove the registration resource in Azure, ensure you're on an Azure-connected computer, sign in to the correct Azure PowerShell context, and run the appropriate PowerShell cmdlets as described below.

리소스를 만드는 데 사용 되는 등록 토큰을 사용할 수 있습니다.You can use the registration token used to create the resource:

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

또는 관리자 포털에서 등록 이름 및 등록 리소스 그룹 이름을 사용할 수 있습니다.Or you can use the registration name and registration resource group name from the administrator portal:

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

연결 된 단계를 사용 하 여 다시 등록Re-register using connected steps

연결 된 상태에서 연결이 끊어진 상태에서 청구 모델을 용량 청구에서 사용량 청구로 변경 하는 경우 연결 된 모델 단계를 따라 다시 등록 합니다.If changing your billing model from capacity billing in a disconnected state to consumption billing in a connected state, you will re-register following the connected model steps.

참고

이렇게 해도 id 모델은 변경 되지 않고 청구 메커니즘도 변경 되며 id 원본으로 AD FS을 계속 사용 합니다.This does not change your identity model, only the billing mechanism, and you will still use AD FS as your identity source.

연결 되지 않은 단계를 사용 하 여 다시 등록Re-register using disconnected steps

이제 연결 되지 않은 시나리오에서 완전히 등록 취소 되었으며, 연결 되지 않은 시나리오에서 Azure Stack 허브 환경을 등록 하는 단계를 반복 해야 합니다.You've now completely unregistered in a disconnected scenario and must repeat the steps for registering an Azure Stack Hub environment in a disconnected scenario.

사용량 보고 사용 또는 사용 안 함Disable or enable usage reporting

용량 청구 모델을 사용 하는 Azure Stack 허브 환경의 경우 AzsRegistration 또는 AzsRegistrationToken cmdlet을 사용 하 여 Usagereportingenabled 매개 변수로 사용 보고를 해제 합니다.For Azure Stack Hub environments that use a capacity billing model, turn off usage reporting with the UsageReportingEnabled parameter using either the Set-AzsRegistration or the Get-AzsRegistrationToken cmdlets. Azure Stack 허브는 기본적으로 사용 메트릭을 보고 합니다.Azure Stack Hub reports usage metrics by default. 용량이 사용 되거나 연결 되지 않은 환경을 지 원하는 연산자는 사용 현황 보고를 해제 해야 합니다.Operators with capacity uses or supporting a disconnected environment need to turn off usage reporting.

다음 PowerShell cmdlet을 실행 합니다.Run the following PowerShell cmdlets:

$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. 등록 토큰을 변경 하려면 다음 PowerShell cmdlet을 실행 합니다.To change the registration token, run the following PowerShell cmdlets:

    $FilePathForRegistrationToken = $env:SystemDrive\RegistrationToken.txt
    $RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential -UsageReportingEnabled:$False
    $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel Capacity -AgreementNumber '<EA agreement number>' -TokenOutputFilePath $FilePathForRegistrationToken
    

    등록 토큰은 $FilePathForRegistrationToken 에 대해 지정 된 파일에 저장 됩니다.The registration token is saved in the file specified for $FilePathForRegistrationToken. 임의로 파일 경로 또는 파일 이름을 변경할 수 있습니다.You can change the filepath or filename at your discretion.

  2. Azure 연결 된 컴퓨터에서 사용 하기 위해이 등록 토큰을 저장 합니다.Save this registration token for use on the Azure connected machine. $FilePathForRegistrationToken 에서 파일 또는 텍스트를 복사할 수 있습니다.You can copy the file or the text from $FilePathForRegistrationToken.

등록 리소스 이동Move a registration resource

동일한 구독에서 리소스 그룹 간에 등록 리소스를 이동 하 는 것은 모든 환경에서 지원 됩니다.Moving a registration resource between resource groups under the same subscription is supported for all environments. 그러나 구독 간에 등록 리소스를 이동 하는 것은 두 구독이 동일한 파트너 ID로 확인 되는 경우에만 Csp에 대해 지원 됩니다.However, moving a registration resource between subscriptions is only supported for CSPs when both subscriptions resolve to the same Partner ID. 리소스를 새 리소스 그룹으로 이동 하는 방법에 대 한 자세한 내용은 새 리소스 그룹 또는 구독으로 리소스 이동을 참조 하세요.For more information about moving resources to a new resource group, see Move resources to new resource group or subscription.

중요

포털에서 실수로 인 한 등록 리소스 삭제를 방지 하기 위해 등록 스크립트는 자동으로 리소스에 대 한 잠금을 추가 합니다.To prevent accidental deletion of registration resources on the portal, the registration script automatically adds a lock to the resource. 이 잠금을 이동 하거나 삭제 하기 전에 제거 해야 합니다.You must remove this lock before moving or deleting it. 실수로 인 한 삭제를 방지 하기 위해 등록 리소스에 잠금을 추가 하는 것이 좋습니다.It's recommended that you add a lock to your registration resource to prevent accidental deletion.

등록 참조Registration reference

Set-AzsRegistrationSet-AzsRegistration

AzsRegistration 를 사용 하 여 Azure에 Azure Stack 허브를 등록 하 고 marketplace 및 사용 보고에서 항목 제안을 사용 하거나 사용 하지 않도록 설정할 수 있습니다.You can use Set-AzsRegistration to register Azure Stack Hub with Azure and enable or disable the offer of items in the marketplace and usage reporting.

Cmdlet을 실행 하려면 다음이 필요 합니다.To run the cmdlet, you need:

  • 모든 형식의 글로벌 Azure 구독.A global Azure subscription of any type.
  • 해당 구독에 대 한 소유자 또는 참가자 계정으로 Azure PowerShell에 로그인 합니다.To be signed in to Azure PowerShell with an account that's an owner or contributor to that subscription.
Set-AzsRegistration [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String> [[-AzureContext]
    <PSObject>] [[-ResourceGroupName] <String>] [[-ResourceGroupLocation] <String>] [[-BillingModel] <String>]
    [-MarketplaceSyndicationEnabled] [-UsageReportingEnabled] [[-AgreementNumber] <String>] [[-RegistrationName]
    <String>] [<CommonParameters>]
매개 변수Parameter TypeType 설명Description
PrivilegedEndpointCredentialPrivilegedEndpointCredential PSCredentialPSCredential 권한 있는 끝점에 액세스하는 데 사용 되는 자격 증명입니다.The credentials used to access the privileged endpoint. 사용자 이름은 Azurestackdomain\cloudadmin 형식으로 되어 있습니다.The username is in the format AzureStackDomain\CloudAdmin.
PrivilegedEndpointPrivilegedEndpoint 문자열String 로그 수집 및 기타 배포 후 태스크와 같은 기능을 제공 하는 미리 구성 된 원격 PowerShell 콘솔입니다.A pre-configured remote PowerShell console that provides you with capabilities like log collection and other post deployment tasks. 자세히 알아보려면 권한 있는 끝점 사용 문서를 참조 하세요.To learn more, refer to the using the privileged endpoint article.
AzureContextAzureContext PSObjectPSObject
ResourceGroupNameResourceGroupName 문자열String
ResourceGroupLocationResourceGroupLocation 문자열String
BillingModelBillingModel 문자열String 구독에서 사용 하는 청구 모델The billing model that your subscription uses. 이 매개 변수에 허용 되는 값은 Capacity, PayAsYouUse 및 Development입니다.Allowed values for this parameter are: Capacity, PayAsYouUse, and Development.
MarketplaceSyndicationEnabledMarketplaceSyndicationEnabled True/FalseTrue/False 포털에서 marketplace 관리 기능을 사용할 수 있는지 여부를 확인 합니다.Determines if the marketplace management feature is available in the portal. 인터넷 연결을 사용 하 여 등록 하는 경우 true로 설정 합니다.Set to true if registering with internet connectivity. 연결 되지 않은 환경에서 등록 하는 경우 false로 설정 합니다.Set to false if registering in disconnected environments. 연결 끊김 등록의 경우 오프 라인 배포 도구 를 사용 하 여 marketplace 항목을 다운로드할 수 있습니다.For disconnected registrations, the offline syndication tool can be used for downloading marketplace items.
UsageReportingEnabledUsageReportingEnabled True/FalseTrue/False Azure Stack 허브는 기본적으로 사용 메트릭을 보고 합니다.Azure Stack Hub reports usage metrics by default. 용량이 사용 되거나 연결 되지 않은 환경을 지 원하는 연산자는 사용 현황 보고를 해제 해야 합니다.Operators with capacity uses or supporting a disconnected environment need to turn off usage reporting. 이 매개 변수에 허용 되는 값은 True, False입니다.Allowed values for this parameter are: True, False.
AgreementNumberAgreementNumber 문자열String 이 Azure Stack의 용량 SKU가 주문 된 EA 규약의 수입니다.The number of the EA agreement under which the Capacity SKU for this Azure Stack was ordered.
RegistrationNameRegistrationName 문자열String 동일한 Azure 구독 ID를 사용 하 Azure Stack 허브의 둘 이상의 인스턴스에서 등록 스크립트를 실행 하는 경우 등록에 대 한 고유한 이름을 설정 합니다.Set a unique name for the registration if you're running the registration script on more than one instance of Azure Stack Hub using the same Azure Subscription ID. 매개 변수에는 Azurestackregistration 의 기본값이 있습니다.The parameter has a default value of AzureStackRegistration. 그러나 Azure Stack 허브의 둘 이상의 인스턴스에서 동일한 이름을 사용 하는 경우 스크립트가 실패 합니다.However, if you use the same name on more than one instance of Azure Stack Hub, the script fails.

Get-AzsRegistrationTokenGet-AzsRegistrationToken

Get-AzsRegistrationToken은 입력 매개 변수에서 등록 토큰을 생성 합니다.Get-AzsRegistrationToken generates a registration token from the input parameters.

Get-AzsRegistrationToken [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String>
    [-BillingModel] <String> [[-TokenOutputFilePath] <String>] [-UsageReportingEnabled] [[-AgreementNumber] <String>]
    [<CommonParameters>]
매개 변수Parameter TypeType 설명Description
PrivilegedEndpointCredentialPrivilegedEndpointCredential PSCredentialPSCredential 권한 있는 끝점에 액세스하는 데 사용 되는 자격 증명입니다.The credentials used to access the privileged endpoint. 사용자 이름은 Azurestackdomain\cloudadmin 형식으로 되어 있습니다.The username is in the format AzureStackDomain\CloudAdmin.
PrivilegedEndpointPrivilegedEndpoint 문자열String 로그 수집 및 기타 배포 후 태스크와 같은 기능을 제공 하는 미리 구성 된 원격 PowerShell 콘솔입니다.A pre-configured remote PowerShell console that provides you with capabilities like log collection and other post deployment tasks. 자세히 알아보려면 권한 있는 끝점 사용 문서를 참조 하세요.To learn more, refer to the using the privileged endpoint article.
AzureContextAzureContext PSObjectPSObject
ResourceGroupNameResourceGroupName 문자열String
ResourceGroupLocationResourceGroupLocation 문자열String
BillingModelBillingModel 문자열String 구독에서 사용 하는 청구 모델The billing model that your subscription uses. 이 매개 변수에 허용 되는 값은 Capacity, PayAsYouUse 및 Development입니다.Allowed values for this parameter are: Capacity, PayAsYouUse, and Development.
MarketplaceSyndicationEnabledMarketplaceSyndicationEnabled True/FalseTrue/False
UsageReportingEnabledUsageReportingEnabled True/FalseTrue/False Azure Stack 허브는 기본적으로 사용 메트릭을 보고 합니다.Azure Stack Hub reports usage metrics by default. 용량이 사용 되거나 연결 되지 않은 환경을 지 원하는 연산자는 사용 현황 보고를 해제 해야 합니다.Operators with capacity uses or supporting a disconnected environment need to turn off usage reporting. 이 매개 변수에 허용 되는 값은 True, False입니다.Allowed values for this parameter are: True, False.
AgreementNumberAgreementNumber 문자열String

등록 오류Registration failures

Azure Stack 허브를 등록 하는 동안 아래 오류 중 하나가 표시 될 수 있습니다.You might see one of the errors below while attempting to register your Azure Stack Hub:

  • 에 대 한 필수 하드웨어 정보를 검색할 수 없습니다 $hostName .Could not retrieve mandatory hardware info for $hostName. 실제 호스트 및 연결을 확인 한 후 등록을 다시 실행 하십시오.Check physical host and connectivity, then try to rerun registration.

  • 하드웨어 정보를 가져오기 위해에 연결할 수 없습니다 $hostName .Cannot connect to $hostName to get hardware info. 실제 호스트 및 연결을 확인 한 후 등록을 다시 실행 하십시오.Check physical host and connectivity, then try to rerun registration.

    원인:이는 일반적으로 호스트에서 UUID, Bios, CPU와 같은 하드웨어 세부 정보를 가져와 활성화 하려고 시도 하 고 실제 호스트에 연결할 수 없기 때문입니다.Cause: this is typically because we try to obtain hardware details such as UUID, Bios, and CPU from the hosts to attempt activation and weren't able to due to the inability to connect to the physical host.

  • 클라우드 식별자 [ GUID ]가 이미 등록 되어 있습니다.Cloud identifier [GUID] is already registered. 클라우드 식별자를 재사용할 수 없습니다.Reusing cloud identifiers is not allowed.

    원인: Azure Stack 환경이 이미 등록 되어 있는 경우에 발생 합니다.Cause: this happens if your Azure Stack environment is already registered. 다른 구독 또는 청구 모델을 사용 하 여 환경을 다시 등록 하려면 갱신 또는 변경 등록 단계를 따르세요.If you want to re-register your environment with a different subscription or billing model, follow the Renew or change registration steps.

  • Marketplace 관리에 액세스 하려고 할 때 제품을 게시 하려고 하면 오류가 발생 합니다.When trying to access Marketplace management, an error occurs when trying to syndicate products.

    원인:이는 일반적으로 Azure Stack 허브가 등록 리소스에 액세스할 수 없는 경우에 발생 합니다.Cause: this usually happens when Azure Stack Hub is unable to access the registration resource. 한 가지 일반적인 이유는 Azure 구독의 디렉터리 테 넌 트가 변경 될 때 등록을 다시 설정 한다는 것입니다.One common reason for this is that when an Azure subscription's directory tenant changes, it resets the registration. 구독의 디렉터리 테 넌 트를 변경한 경우 Azure Stack Hub Marketplace 또는 보고서 사용에 액세스할 수 없습니다.You can't access the Azure Stack Hub Marketplace or report usage if you've changed the subscription's directory tenant. 이 문제를 해결 하려면 다시 등록 해야 합니다.You need to re-register to fix this issue.

  • 아직 연결 되지 않은 프로세스를 사용 하 여 스탬프를 이미 등록 했더라도 Marketplace 관리에서 Azure Stack 허브를 등록 하 고 활성화 하 라는 메시지를 표시 합니다.Marketplace management still asks you to register and activate your Azure Stack Hub even when you've already registered your stamp using the disconnected process.

    원인: 연결이 끊어진 환경에 대 한 알려진 문제 이며 등록 상태를 확인해야 합니다.Cause: this is a known issue for disconnected environments, and requires you to verify your registration status. Marketplace 관리를 사용 하려면 오프 라인 도구를 사용 합니다.In order to use Marketplace management, use the offline tool.

다음 단계Next steps

Azure에서 marketplace 항목 다운로드Download marketplace items from Azure