Azure Stack Hub を Azure に登録するRegister Azure Stack Hub with Azure

Azure Stack Hub を Azure に登録して、Azure から Azure Marketplace 項目をダウンロードしたり、Microsoft に報告を返すコマース データを設定したりできます。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 Hub を登録した後は、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 Hub 統合システムを登録する方法について説明します。The information in this article describes registering Azure Stack Hub integrated systems with Azure. Azure を使用して ASDK を登録する方法については、ASDK ドキュメントの Azure Stack Hub の登録に関するページを参照してください。For information about registering the ASDK with Azure, see Azure Stack Hub registration in the ASDK documentation.

重要

マーケットプレースのオファー項目を含む、Azure Stack Hub のすべての機能をサポートするには、登録が必要です。Registration is required to support full Azure Stack Hub functionality, including offering items in the marketplace. 従量制課金モデルを使用している場合、登録しないと、Azure Stack Hub のライセンス条項違反になります。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 Hub のライセンス モデルの詳細については、購入方法のページを参照してください。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.
  • PowerShell for Azure Stack Hub をインストールする。Install PowerShell for Azure Stack Hub.
  • Azure Stack Hub ツールをダウンロードする。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. 次に、 [一般] カテゴリの下で [サブスクリプション] を選び、使用するサブスクリプションをクリックすると、 [要点] の下にサブスクリプション 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 のサブスクリプションは現在サポートされていません。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 Stack Hub を Azure に登録することをお勧めします。We recommend that you register Azure Stack Hub with Azure using least-privilege administration. 登録のためのサブスクリプションへのアクセスを制限するカスタム ロール定義を作成する方法について詳しくは、Azure Stack Hub の登録ロールの作成に関するページを参照してください。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 Hub リソース プロバイダーを登録しました (詳細については、Azure Stack Hub リソース プロバイダーの登録に関する次のセクションを参照してください)。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 Hub を登録するユーザーは、Azure AD のサービス プリンシパルの所有者です。The user who registers Azure Stack Hub is the owner of the service principal in Azure AD. Azure Stack Hub の登録を変更できるのは、Azure Stack Hub を登録したユーザーのみです。Only the user who registered Azure Stack Hub can modify the Azure Stack Hub registration. 登録サービス プリンシパルの所有者ではない管理者以外のユーザーが Azure Stack Hub を登録または再登録しようとすると、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 Hub を登録しても、Azure サブスクリプションに課金されることはありません。Registering Azure Stack Hub incurs no cost on your Azure subscription.

注意

複数の Azure Stack Hub がある場合のベスト プラクティスは、各 Azure Stack Hub を専用のサブスクリプションに登録することです。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 Hub を正常に登録するには、PowerShell 言語モードを FullLanguageMode に設定する必要があります。To successfully register Azure Stack Hub, the PowerShell language mode must be set to FullLanguageMode. 現在の言語モードが完全に設定されていることを確認するには、PowerShell ウィンドウを管理者特権で開いて、次の PowerShell コマンドレットを実行します。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.

PowerShell for Azure Stack Hub をインストールするInstall PowerShell for Azure Stack Hub

Azure に登録するために、最新の PowerShell for Azure Stack Hub を使用します。Use the latest PowerShell for Azure Stack Hub to register with Azure.

最新バージョンがまだインストールされていない場合は、PowerShell for Azure Stack Hub のインストールに関するページを参照してください。If the latest version isn't already installed, see install PowerShell for Azure Stack Hub.

Azure Stack Hub ツールをダウンロードするDownload the Azure Stack Hub tools

Azure Stack Hub ツールの GitHub リポジトリには、Azure Stack Hub 機能 (登録機能を含む) をサポートする PowerShell モジュールが含まれています。The Azure Stack Hub tools GitHub repository contains PowerShell modules that support Azure Stack Hub functionality, including registration functionality. 登録プロセス中に、RegisterWithAzure.psm1 PowerShell モジュール (Azure Stack Hub ツール リポジトリにあります) をインポートおよび利用して、使用する Azure Stack Hub インスタンスを Azure に登録する必要があります。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.

課金モデルを決定するDetermine your billing model

接続されたデプロイでは、Azure Stack Hub はインターネットと Azure に接続できます。A connected deployment allows Azure Stack Hub to connect to the internet, and to Azure. また、ID ストアとして Azure AD または Active Directory フェデレーション サービス (AD FS) を使用して、従量課金制と容量ベースの 2 つの課金モデルのどちらかを選択することもできます。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 Hub を使用することができます。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 の登録に Azure Stack Hub サブスクリプションを関連付ける簡単な方法は、Azure Stack Hub のクラウド 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 Hub 登録では、期限切れの登録を削除して 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 Hub デプロイのクラウド ID を調べるには、特権エンドポイントにアクセスできるコンピューターで管理者として PowerShell を開き、次のコマンドを実行して、CloudID の値を書き留めます。To determine the Cloud ID for your Azure Stack Hub deployment, open PowerShell as an admin on a computer that can access the Privileged Endpoint, run the following commands, and then record the CloudID value:

Run: Enter-PSSession -ComputerName <privileged endpoint computer name> -ConfigurationName PrivilegedEndpoint
Run: Get-AzureStackStampInformation

従量課金制の課金で登録するRegister with pay-as-you-use billing

従量制課金モデルを使用して Azure Stack Hub を Azure に登録するには、次の手順を使用します。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 Hub での特権エンドポイントの使用に関するページを参照してください。For details about the PEP, see Using the privileged endpoint in Azure Stack Hub.

接続された環境では、インターネットと Azure にアクセスできます。Connected environments can access the internet and Azure. これらの環境では、Azure Stack Hub リソース プロバイダーを Azure に登録してから、課金モデルを構成する必要があります。For these environments, you need to register the Azure Stack Hub resource provider with Azure and then configure your billing model.

  1. Azure Stack Hub リソース プロバイダーを Azure に登録するには、PowerShell ISE を管理者として起動し、EnvironmentName パラメーターを適切な Azure サブスクリプション タイプ (以下のパラメーターを参照) に設定して、次の PowerShell コマンドレットを使用します。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 Hub を登録するために使用した Azure アカウントを追加します。Add the Azure account that you used to register Azure Stack Hub. アカウントを追加するには、Add-AzureRmAccount コマンドレットを実行します。To add the account, run the Add-AzureRmAccount 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.

    Add-AzureRmAccount -EnvironmentName "<environment name>"
    
    パラメーターParameter 説明Description
    EnvironmentNameEnvironmentName Azure クラウド サブスクリプション環境名。The Azure cloud subscription environment name. サポートされている環境名は AzureCloudAzureUSGovernment、または中国の Azure サブスクリプションを使用している場合は AzureChinaCloud です。Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure Subscription, AzureChinaCloud.

    注意

    ご自分のセッションの期限が切れたり、ご自分のパスワードが変更になったり、または単純にアカウントを切り替えたい場合は、サインイン前に次のコマンドレットを Add-AzureRmAccount: Remove-AzureRmAccount-Scope Process を使用して実行します。If your session expires, your password has changed, or you simply wish to switch accounts, run the following cmdlet before you sign in using Add-AzureRmAccount: Remove-AzureRmAccount-Scope Process

  3. 複数のサブスクリプションがある場合は、次のコマンドを実行して、使用するものを選択します。If you have multiple subscriptions, run the following command to select the one you want to use:

    Get-AzureRmSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzureRmSubscription
    
  4. Azure サブスクリプションで Azure Stack Hub リソース プロバイダーを登録するには、次のコマンドを実行します。Run the following command to register the Azure Stack Hub resource provider in your Azure subscription:

    Register-AzureRmResourceProvider -ProviderNamespace Microsoft.AzureStack
    
  5. 管理者として PowerShell ISE を起動し、Azure Stack Hub ツールをダウンロードしたときに作成された AzureStack-Tools-master ディレクトリ内の Registration フォルダーに移動します。Start PowerShell ISE as an administrator and navigate to the Registration folder in the AzureStack-Tools-master directory created when you downloaded the Azure Stack Hub tools. PowerShell を使用して RegisterWithAzure.psm1 モジュールをインポートします。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 Hub リソース プロバイダーを登録するために使用された 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-AzureRmAccount -Environment "<environment name>"
    
    パラメーターParameter 説明Description
    EnvironmentNameEnvironmentName Azure クラウド サブスクリプション環境名。The Azure cloud subscription environment name. サポートされている環境名は AzureCloudAzureUSGovernment、または中国の Azure サブスクリプションを使用している場合は AzureChinaCloud です。Supported environment names are AzureCloud, AzureUSGovernment, or if using a China Azure Subscription, AzureChinaCloud.
  7. 同じ PowerShell セッションで Set-AzsRegistration コマンドレットを実行します。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 コマンドレットの詳細については、「登録に関するリファレンス」を参照してください。For more information on the Set-AzsRegistration cmdlet, see Registration reference.

    このプロセスには 10 - 15 分かかります。The process takes between 10 and 15 minutes. コマンドが完了すると、「Your environment is now registered and activated using the provided parameters. (提供されたパラメーターを使用して環境が登録され、アクティブ化されました。) 」というメッセージが表示されます。When the command completes, you see the message "Your environment is now registered and activated using the provided parameters."

容量課金で登録するRegister with capacity billing

容量課金モデルを使用して Azure Stack Hub を Azure に登録するには、次の手順を使用します。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 Hub での特権エンドポイントの使用に関するページを参照してください。For details about the PEP, see Using the privileged endpoint in Azure Stack Hub.

接続された環境では、インターネットと Azure にアクセスできます。Connected environments can access the internet and Azure. これらの環境では、Azure Stack Hub リソース プロバイダーを Azure に登録してから、課金モデルを構成する必要があります。For these environments, you need to register the Azure Stack Hub resource provider with Azure and then configure your billing model.

  1. Azure Stack Hub リソース プロバイダーを Azure に登録するには、PowerShell ISE を管理者として起動し、EnvironmentName パラメーターを適切な Azure サブスクリプション タイプ (以下のパラメーターを参照) に設定して、次の PowerShell コマンドレットを使用します。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 Hub を登録するために使用した Azure アカウントを追加します。Add the Azure account that you used to register Azure Stack Hub. アカウントを追加するには、Add-AzureRmAccount コマンドレットを実行します。To add the account, run the Add-AzureRmAccount 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-AzureRmAccount -Environment "<environment name>"
    
    パラメーターParameter 説明Description
    EnvironmentNameEnvironmentName Azure クラウド サブスクリプション環境名。The Azure cloud subscription environment name. サポートされている環境名は AzureCloudAzureUSGovernment、または中国の 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-AzureRmSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzureRmSubscription
    
  4. Azure サブスクリプションで Azure Stack Hub リソース プロバイダーを登録するには、次のコマンドを実行します。Run the following command to register the Azure Stack Hub resource provider in your Azure subscription:

    Register-AzureRmResourceProvider -ProviderNamespace Microsoft.AzureStack
    
  5. 管理者として PowerShell ISE を起動し、Azure Stack Hub ツールをダウンロードしたときに作成された AzureStack-Tools-master ディレクトリ内の Registration フォルダーに移動します。Start PowerShell ISE as an administrator and navigate to the Registration folder in the AzureStack-Tools-master directory created when you downloaded the Azure Stack Hub tools. PowerShell を使用して RegisterWithAzure.psm1 モジュールをインポートします。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
    

    注意

    Set-AzsRegistration コマンドレットの UsageReportingEnabled パラメーターを false に設定することで、使用状況レポートを無効にすることができます。You can disable usage reporting with the UsageReportingEnabled parameter for the Set-AzsRegistration cmdlet by setting the parameter to false.

    Set-AzsRegistration コマンドレットの詳細については、「登録に関するリファレンス」を参照してください。For more information on the Set-AzsRegistration cmdlet, see Registration reference.

容量課金で登録するRegister with capacity billing

接続されていない環境 (インターネットに接続されていない環境) に Azure Stack Hub を登録する場合は、Azure Stack Hub 環境から登録トークンを取得する必要があります。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 Hub 環境から登録トークンを取得するGet a registration token from the Azure Stack Hub environment

  1. 管理者として PowerShell ISE を起動し、Azure Stack Hub ツールをダウンロードしたときに作成された AzureStack-Tools-master ディレクトリ内の Registration フォルダーに移動します。Start PowerShell ISE as an administrator and navigate to the Registration folder in the AzureStack-Tools-master directory created when you downloaded the Azure Stack Hub tools. RegisterWithAzure.psm1 モジュールをインポートします。Import the RegisterWithAzure.psm1 module:

    Import-Module .\RegisterWithAzure.psm1
    
  2. 登録トークンを取得するには、次の PowerShell コマンドレットを実行します。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 コマンドレットの詳細については、「登録に関するリファレンス」を参照してください。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.psm1 モジュールをインポートし、正しい 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. 次に、Register-AzsEnvironment を呼び出します。Then call Register-AzsEnvironment. Azure に登録する登録トークンを指定します。Specify the registration token to register with Azure. 同じ Azure サブスクリプション ID を利用して Azure Stack Hub の複数のインスタンスを登録している場合は、一意の登録名を指定します。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 Hub ツールをダウンロードしたときに作成された AzureStack-Tools-master ディレクトリ内の Registration フォルダーに移動します。Start PowerShell ISE as an administrator and navigate to the Registration folder in the AzureStack-Tools-master directory created when you downloaded the Azure Stack Hub tools. RegisterWithAzure.psm1 モジュールをインポートします。Import the RegisterWithAzure.psm1 module:

    Import-Module .\RegisterWithAzure.psm1
    
  2. その後、PowerShell コマンドレットを実行します。Then run the following PowerShell cmdlets:

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

オプションで、Get-Content コマンドレットを使用して、登録トークンが含まれているファイルを示すことができます。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 Hub ツールをダウンロードしたときに作成された AzureStack-Tools-master ディレクトリ内の Registration フォルダーに移動します。Start PowerShell ISE as an administrator and navigate to the Registration folder in the AzureStack-Tools-master directory created when you downloaded the Azure Stack Hub tools. RegisterWithAzure.psm1 モジュールをインポートします。Import the RegisterWithAzure.psm1 module:

    Import-Module .\RegisterWithAzure.psm1
    
  2. その後、PowerShell コマンドレットを実行します。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

次に、Register-AzsEnvironment 中に Azure で作成された登録リソースからアクティブ化キーを取得する必要があります。Next, you need to retrieve an activation key from the registration resource created in Azure during Register-AzsEnvironment.

アクティブ化キーを取得するには、次の PowerShell コマンドレットを実行します。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 Hub にアクティブ化リソースを作成するCreate an Activation Resource in Azure Stack Hub

Get-AzsActivationKey から作成されたアクティブ化キーのファイルまたはテキストを使用して Azure Stack Hub 環境に戻ります。Return to the Azure Stack Hub environment with the file or text from the activation key created from Get-AzsActivationKey. 次に、アクティブ化キーを使用して Azure Stack Hub にアクティブ化リソースを作成します。Next create an activation resource in Azure Stack Hub using that activation key. アクティブ化リソースを作成するには、次の PowerShell コマンドレットを実行します。To create an activation resource, run the following PowerShell cmdlets:

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

オプションで、Get-Content コマンドレットを使用して、登録トークンが含まれているファイルを示すことができます。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 Hub の登録を検証するVerify Azure Stack Hub registration

Azure Stack Hub の登録に成功したことは、 [Region management](リージョン管理) タイルを使用して確認できます。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 Hub の登録に使用した 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. ダッシュボードで、 [Region management](リージョン管理) を選択します。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 Hub 管理者ポータルの [リージョンの管理] タイルRegion management tile in Azure Stack Hub administrator portal

    登録した場合、プロパティには以下が含まれます。If registered, the properties include:

    • 登録サブスクリプション ID:登録され、Azure Stack Hub に関連付けられた Azure サブスクリプション ID。Registration subscription ID: The Azure subscription ID registered and associated to Azure Stack Hub.
    • 登録リソース グループ:Azure Stack Hub リソースを含む関連付けられているサブスクリプション内の 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 Hub の登録に使用したサブスクリプションに関連付けられているアカウントを使用して、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 management](Marketplace の管理) ブレードに Marketplace 項目の一覧が表示されれば、登録は成功しています。If you see a list of marketplace items in the Marketplace management blade, your registration was successful. ただし、切断されている環境では、[Marketplace management](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 Hub リリースの場合、接続されていないシナリオでは、正常に登録が完了しても、Azure Stack Hub を登録してアクティブ化するよう求めるメッセージが [Marketplace management](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 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.

前提条件Prerequisites

登録を更新または変更するには、管理者ポータルの次の情報が必要です。You need the following information from the administrator portal to renew or change registration:

管理者ポータルAdministrator portal コマンドレット パラメーターCmdlet parameter NotesNotes
登録サブスクリプション IDREGISTRATION SUBSCRIPTION ID サブスクリプションSubscription 以前の登録時に使用されたサブスクリプション 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

使用するサブスクリプションを変更する場合は、まず Remove-AzsRegistration コマンドレットを実行します。その後、正しい 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. 次に、<billing model> を含む変更されたパラメーターを使用して Set-AzsRegistration を実行します。Then run Set-AzsRegistration with any changed parameters, including <billing model>. Remove-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-AzureRmSubscription -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-AzureRmSubscription -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 にサインインし、RegistrationName パラメーターと ResourceGroupName パラメーターの値は管理者ポータルに表示された値のままで、新しい BillingModel の値を指定して登録を再実行します。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-AzureRmSubscription -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 Hub からアクティブ化リソースを削除するRemove the activation resource from Azure Stack Hub

最初に Azure Stack Hub からアクティブ化リソースを削除してから、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 Hub 環境で次の PowerShell コマンドレットを実行します。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 コマンドレットを実行します。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 ソースとして ADFS が引き続き使用されます。This does not change your identity model, only the billing mechanism, and you will still use ADFS as your identity source.

切り離された手順を使用して再登録するRe-register using disconnected steps

これで、接続が切断されたシナリオで登録が完全に解除されました。接続が切断されたシナリオで Azure Stack Hub 環境を登録する手順を繰り返す必要があります。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 Hub 環境では、Set-AzsRegistration または Get-AzsRegistrationToken コマンドレットのいずれかで 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 Hub では、既定で使用状況メトリックがレポートされます。Azure Stack Hub reports usage metrics by default. 容量モデルを使用するオペレーターまたは切断された環境をサポートするオペレーターは、使用状況レポートをオフにする必要があります。Operators with capacity uses or supporting a disconnected environment need to turn off usage reporting.

次の PowerShell コマンドレットを実行します。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 コマンドレットを実行します。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

Set-AzsRegistration を使用すると、Azure Stack Hub を Azure に登録し、マーケットプレースでの項目のオファーと使用状況レポートを有効または無効にすることができます。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.

コマンドレットを実行するには、以下が必要です。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 StringString ログ収集およびその他のデプロイ後タスクのような機能を提供する、あらかじめ構成されたリモート 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 StringString
ResourceGroupLocationResourceGroupLocation StringString
BillingModelBillingModel StringString 自分のサブスクリプションで使用する請求モデル。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. 切断された環境で登録した場合は、オフライン シンジケーション ツールを使用して、マーケットプレースの項目をダウンロードできます。For disconnected registrations, the offline syndication tool can be used for downloading marketplace items.
UsageReportingEnabledUsageReportingEnabled True または FalseTrue/False Azure Stack Hub では、既定で使用状況メトリックがレポートされます。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 StringString この Azure Stack の容量 SKU が注文された EA 契約の番号。The number of the EA agreement under which the Capacity SKU for this Azure Stack was ordered.
RegistrationNameRegistrationName StringString 同じ Azure サブスクリプション ID を利用し、複数の Azure Stack Hub インスタンスで登録スクリプトを実行している場合、登録に一意の名前を設定します。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 Hub インスタンスに同じ名前を使用すると、スクリプトは失敗します。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 StringString ログ収集およびその他のデプロイ後タスクのような機能を提供する、あらかじめ構成されたリモート 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 StringString
ResourceGroupLocationResourceGroupLocation StringString
BillingModelBillingModel StringString 自分のサブスクリプションで使用する請求モデル。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 Hub では、既定で使用状況メトリックがレポートされます。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 StringString

登録エラーRegistration failures

Azure Stack Hub の登録を試みている間に、次のエラーのいずれかが発生する可能性があります。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.

  • Cloud identifier [GUID] is already registered. (クラウド識別子 [GUID] は既に登録されています。)Cloud identifier [GUID] is already registered. Reusing cloud identifiers is not allowed. (クラウド識別子の再使用は許可されません。)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 Hub が登録リソースにアクセスできない場合に発生します。Cause: this usually happens when Azure Stack Hub is unable to access the registration resource. これに関する一般的な理由の 1 つとして、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 Hub の登録とアクティブ化を要求されます。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