Azure Stack Hub を Azure に登録する
Azure Stack Hub を Azure に登録して、Azure から Azure Marketplace 項目をダウンロードしたり、Microsoft に報告を返すコマース データを設定したりできます。 Azure Stack Hub を登録した後は、Azure コマースに使用状況が報告され、登録に使用した Azure 課金サブスクリプション ID で確認できます。
この記事では、Azure を使用して Azure Stack Hub 統合システムを登録する方法について説明します。 Azure を使用して ASDK を登録する方法については、ASDK ドキュメントの Azure Stack Hub の登録に関するページを参照してください。
重要
マーケットプレースのオファー項目を含む、Azure Stack Hub のすべての機能をサポートするには、登録が必要です。 従量制課金モデルを使用している場合、登録しないと、Azure Stack Hub のライセンス条項違反になります。 Azure Stack Hub のライセンス モデルの詳細については、購入方法のページを参照してください。
注意
接続された登録の場合、Microsoft Entra アプリケーションと関連付けられたサービス プリンシパルが、登録に関連付けられている Active Directory ディレクトリに作成されます。 このサービス プリンシパルは、Azure Stack Hub Marketplace のシナリオ (Azure Marketplace 項目の表示とダウンロード)、使用状況データのアップロード (使用状況レポートが有効な場合)、診断ログの収集、リモート サポートに使用されます。 このアプリケーションまたはサービス プリンシパルを削除または変更すると、これらのシナリオが機能しなくなり、アラートが発生します。 削除された場合は、Azure Stack Hub の Azure への登録を解除してから再登録することで、再作成できます。
注意
オンライン マーケットプレース シンジケーション、診断ログの収集、リモート サポートは、切断された環境で登録した場合は使用できません。 オフライン マーケットプレイス シンジケーションを使用する必要があります。
前提条件
登録する前に、次の前提条件セクションを完了してください。
- 資格情報を確認する。
- PowerShell 言語モードを設定する。
- PowerShell for Azure Stack Hub をインストールする。
- Azure Stack Hub ツールをダウンロードする。
- 課金モデルを決定する。
- 一意の登録名を決定する。
資格情報を確認する
Azure を使用して Azure Stack Hub を登録する前に、以下のものが必要です。
- Azure サブスクリプションのサブスクリプション ID。 登録には、EA、CSP、CSP 共有サービス サブスクリプションだけがサポートされています。 CSP では、CSP サブスクリプションまたは APSS サブスクリプションのどちらを使用するかを決める必要があります。
ID を取得するには、Azure portal に移動し、[すべてのサービス] > [全般] > [サブスクリプション] の順に選択し、一覧から使用するサブスクリプションを選択します。 [Essentials] セクション内でサブスクリプション ID を見つけます。 ベスト プラクティスとして、運用環境と開発環境またはテスト環境には、異なるサブスクリプションを使用してください。
Azure サブスクリプションのサブスクリプション ID。 登録には、EA サブスクリプションだけがサポートされています。
ID を取得するには、Azure portal に移動し、[すべてのサービス] > [全般] > [サブスクリプション] の順に選択し、一覧から使用するサブスクリプションを選択します。 [Essentials] セクション内でサブスクリプション ID を見つけます。 ベスト プラクティスとして、運用環境と開発環境またはテスト環境には、異なるサブスクリプションを使用してください。
注意
Germany Cloud のサブスクリプションは現在サポートされていません。
サブスクリプションの所有者であるアカウントのユーザー名とパスワード。
ユーザー アカウントは Azure サブスクリプションにアクセスできなければならず、そのサブスクリプションに関連付けられているディレクトリで ID アプリとサービス プリンシパルを作成するアクセス許可を持つ必要があります。 最低限の特権による管理を使用し、Azure Stack Hub を Azure に登録することをお勧めします。 登録のためのサブスクリプションへのアクセスを制限するカスタム ロール定義を作成する方法について詳しくは、Azure Stack Hub の登録ロールの作成に関するページを参照してください。
Azure Stack Hub リソース プロバイダーを登録しました (詳細については、Azure Stack Hub リソース プロバイダーの登録に関する次のセクションを参照してください)。
登録後、Microsoft Entraグローバル管理者のアクセス許可は必要ありません。 ただし、一部の操作では、全体管理者の資格情報が必要な場合があります (たとえば、リソース プロバイダーのインストーラー スクリプトや、アクセス許可の付与を必要とする新機能です)。 アカウントの全体管理者のアクセス許可を一時的に復元するか、既定のプロバイダー サブスクリプションの所有者である別の全体管理者アカウントを使用します。
Azure Stack Hub を登録するユーザーは、Microsoft Entra ID のサービス プリンシパルの所有者です。 Azure Stack Hub の登録を変更できるのは、Azure Stack Hub を登録したユーザーのみです。 他のすべてのユーザーは、グローバル管理者であっても、"アクセス制御 (IAM)" を使用して "既定のプロバイダー サブスクリプション" に追加する必要があります。 登録サービス プリンシパルの所有者ではない管理者以外のユーザーが Azure Stack Hub を登録または再登録しようとすると、403 応答が発生する可能性があります。 403 応答は、操作を完了するための十分な権限がユーザーにないことを示します。
これらの要件を満たす Azure サブスクリプションがない場合は、ここで無料の Azure アカウントを作成できます。 Azure Stack Hub を登録しても、Azure サブスクリプションに課金されることはありません。
注意
複数の Azure Stack Hub がある場合のベスト プラクティスは、各 Azure Stack Hub を専用のサブスクリプションに登録することです。 これにより、使用状況の追跡が容易になります。
PowerShell 言語モードを設定する
Azure Stack Hub を正常に登録するには、PowerShell 言語モードを FullLanguage に設定する必要があります。 現在の言語モードが完全に設定されていることを確認するには、PowerShell ウィンドウを管理者特権で開いて、次の PowerShell コマンドレットを実行します。
$ExecutionContext.SessionState.LanguageMode
出力で FullLanguage が確実に返されるようにします。 その他の言語モードが返される場合は、別のマシン上で登録を実行するか、言語モードを FullLanguage に設定してから作業を続行する必要があります。
PowerShell for Azure Stack Hub をインストールする
Azure に登録するために、最新の PowerShell for Azure Stack Hub を使用します。
最新バージョンがまだインストールされていない場合は、PowerShell for Azure Stack Hub のインストールに関するページを参照してください。
Azure Stack Hub ツールをダウンロードする
Azure Stack Hub ツールの GitHub リポジトリには、Azure Stack Hub 機能 (登録機能を含む) をサポートする PowerShell モジュールが含まれています。 登録プロセス中に、RegisterWithAzure.psm1 PowerShell モジュール (Azure Stack Hub ツール リポジトリにあります) をインポートおよび利用して、使用する Azure Stack Hub インスタンスを Azure に登録する必要があります。
最新バージョンを使用していることを確認するには、Azure に登録する前に、既存のバージョンの Azure Stack Hub ツールをすべて削除し、GitHub から最新バージョンをダウンロードします。
Note
また、オペレーター アクセス ワークステーション (OAW) を使用して、特権エンドポイント (PEP)、サポート シナリオの管理者ポータル、Azure Stack Hub GitHub ツールにアクセスすることもできます。 詳細については、「Azure Stack Hub オペレーター アクセス ワークステーション」を参照してください。
課金モデルを決定する
接続されたデプロイでは、Azure Stack Hub はインターネットと Azure に接続できます。 ID ストアとして Microsoft Entra ID または Active Directory フェデレーション サービス (AD FS) (AD FS) を使用し、従量課金制または容量ベースの 2 つの課金モデルから選択することもできます。 課金モデルは、後で登録スクリプトの実行中に指定します。
切断されたデプロイでは、インターネットに接続していなくても、Azure Stack Hub を使用することができます。 切断されたデプロイでは、AD FS ID ストアおよび容量ベースの課金モデルに制限されます。 課金モデルは、後で登録スクリプトの実行中に指定します。
一意の登録名を決定する
登録スクリプトを実行するときに、一意の登録名を指定する必要があります。 Azure の登録に Azure Stack Hub サブスクリプションを関連付ける簡単な方法は、Azure Stack Hub のクラウド ID を使用することです。
注意
容量ベースの課金モデルを使用している Azure Stack Hub 登録では、期限切れの登録を削除して Azure に再登録するのでない限り、年単位のサブスクリプションの期限が切れた後の再登録で一意の名前を変更する必要があります。
Azure Stack Hub デプロイのクラウド ID を確認する場合は、「クラウド ID を検索する」をご覧ください。
従量課金制の課金で登録する
従量制課金モデルを使用して Azure Stack Hub を Azure に登録するには、次の手順を使用します。
Note
これらのすべての手順は、特権エンドポイント (PEP) にアクセスできるコンピューターから実行する必要があります。 PEP の詳細については、Azure Stack Hub での特権エンドポイントの使用に関するページを参照してください。
接続された環境では、インターネットと Azure にアクセスできます。 これらの環境では、Azure Stack Hub リソース プロバイダーを Azure に登録してから、課金モデルを構成する必要があります。
Azure Stack Hub リソース プロバイダーを Azure に登録するには、PowerShell ISE を管理者として起動し、EnvironmentName パラメーターを適切な Azure サブスクリプション タイプ (以下のパラメーターを参照) に設定して、次の PowerShell コマンドレットを使用します。
Azure Stack Hub を登録するために使用した Azure アカウントを追加します。 アカウントを追加するには、Connect-AzAccount コマンドレットを実行します。 Azure アカウント資格情報の入力を求められ、お使いのアカウントの構成によっては 2 要素認証を使用する必要があります。
Connect-AzAccount -EnvironmentName "<environment name>"
パラメーター 説明 EnvironmentName Azure クラウド サブスクリプション環境名。 サポートされている環境名は AzureCloud、AzureUSGovernment、または中国の Azure サブスクリプションを使用している場合は AzureChinaCloud です。 Note
セッションの有効期限が切れた、パスワードが変更された、または単にアカウントを切り替えたい場合は、Connect-AzAccount を使用してサインインする前に、次のコマンドレットを実行します:
Remove-AzAccount-Scope Process
複数のサブスクリプションがある場合は、次のコマンドを実行して、使用するものを選択します。
Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription
Azure サブスクリプションで Azure Stack Hub リソース プロバイダーを登録するには、次のコマンドを実行します。
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack
管理者として PowerShell ISE を起動し、Azure Stack Hub ツールをダウンロードしたときに作成された AzureStack-Tools-az ディレクトリ内の Registration フォルダーに移動します。 PowerShell を使用して RegisterWithAzure.psm1 モジュールをインポートします。
Import-Module .\RegisterWithAzure.psm1
続行する前に、同じ PowerShell セッションで、正しい Azure PowerShell コンテキストにサインインしていることをもう一度確認します (そうでない場合は、手順 2 と 3 を繰り返します)。このコンテキストとは、以前に Azure Stack Hub リソース プロバイダーを登録するために使用された Azure アカウントです。 同じ PowerShell セッションで Set-AzsRegistration コマンドレットを実行します。
$CloudAdminCred = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint." $RegistrationName = "<unique-registration-name>" Set-AzsRegistration ` -PrivilegedEndpointCredential $CloudAdminCred ` -PrivilegedEndpoint <PrivilegedEndPoint computer name> ` -BillingModel PayAsYouUse ` -RegistrationName $RegistrationName
Set-AzsRegistration コマンドレットの詳細については、「登録に関するリファレンス」を参照してください。
このプロセスには 10 - 15 分かかります。 コマンドが完了すると、「Your environment is now registered and activated using the provided parameters. (提供されたパラメーターを使用して環境が登録され、アクティブ化されました。) 」というメッセージが表示されます。
容量課金で登録する
容量課金モデルを使用して Azure Stack Hub を Azure に登録するには、次の手順を使用します。
Note
これらのすべての手順は、特権エンドポイント (PEP) にアクセスできるコンピューターから実行する必要があります。 PEP の詳細については、Azure Stack Hub での特権エンドポイントの使用に関するページを参照してください。
接続された環境では、インターネットと Azure にアクセスできます。 これらの環境では、Azure Stack Hub リソース プロバイダーを Azure に登録してから、課金モデルを構成する必要があります。
Azure Stack Hub リソース プロバイダーを Azure に登録するには、PowerShell ISE を管理者として起動し、EnvironmentName パラメーターを適切な Azure サブスクリプション タイプ (以下のパラメーターを参照) に設定して、次の PowerShell コマンドレットを使用します。
Azure Stack Hub を登録するために使用した Azure アカウントを追加します。 アカウントを追加するには、Connect-AzAccount コマンドレットを実行します。 Azure アカウント資格情報の入力を求められ、お使いのアカウントの構成によっては 2 要素認証を使用する必要があります。
Connect-AzAccount -Environment "<environment name>"
パラメーター 説明 EnvironmentName Azure クラウド サブスクリプション環境名。 サポートされている環境名は AzureCloud、AzureUSGovernment、または中国の Azure サブスクリプションを使用している場合は AzureChinaCloud です。 複数のサブスクリプションがある場合は、次のコマンドを実行して、使用するものを選択します。
Get-AzSubscription -SubscriptionID '<Your Azure Subscription GUID>' | Select-AzSubscription
Azure サブスクリプションで Azure Stack Hub リソース プロバイダーを登録するには、次のコマンドを実行します。
Register-AzResourceProvider -ProviderNamespace Microsoft.AzureStack
管理者として PowerShell ISE を起動し、Azure Stack Hub ツールをダウンロードしたときに作成された AzureStack-Tools-az ディレクトリ内の Registration フォルダーに移動します。 PowerShell を使用して RegisterWithAzure.psm1 モジュールをインポートします。
Import-Module .\RegisterwithAzure.psm1
続行する前に、同じ PowerShell セッションで、正しい Azure PowerShell コンテキストにサインインしていることをもう一度確認します (そうでない場合は、手順 2 と 3 を繰り返します)。このコンテキストとは、Azure Stack Hub リソース プロバイダーを登録するために使用された Azure アカウントです。 同じ PowerShell セッションで Set-AzsRegistration コマンドレットを実行します。
$CloudAdminCred = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint." $RegistrationName = "<unique-registration-name>" Set-AzsRegistration ` -PrivilegedEndpointCredential $CloudAdminCred ` -PrivilegedEndpoint <PrivilegedEndPoint computer name> ` -AgreementNumber <EA agreement number> ` -BillingModel Capacity ` -RegistrationName $RegistrationName
容量 SKU ライセンスを購入したときの "EA 契約番号" を使用します。
注意
Set-AzsRegistration コマンドレットの UsageReportingEnabled パラメーターを false に設定することで、使用状況レポートを無効にすることができます。
Set-AzsRegistration コマンドレットの詳細については、「登録に関するリファレンス」を参照してください。
容量課金で登録する
接続されていない環境 (インターネットに接続されていない環境) に Azure Stack Hub を登録する場合は、Azure Stack Hub 環境から登録トークンを取得する必要があります。 次に、Azure に接続でき、PowerShell for Azure Stack Hub がインストールされているコンピューターでそのトークンを使用します。
Azure Stack Hub 環境から登録トークンを取得する
管理者として PowerShell ISE を起動し、Azure Stack Hub ツールをダウンロードしたときに作成された AzureStack-Tools-az ディレクトリ内の Registration フォルダーに移動します。 RegisterWithAzure.psm1 モジュールをインポートします。
Import-Module .\RegisterWithAzure.psm1
登録トークンを取得するには、次の PowerShell コマンドレットを実行します。
$FilePathForRegistrationToken = "$env:SystemDrive\RegistrationToken.txt" $YourCloudAdminCredential = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint." $RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $YourCloudAdminCredential ` -UsageReportingEnabled:$false ` -PrivilegedEndpoint <PrivilegedEndPoint computer name> ` -BillingModel Capacity ` -AgreementNumber '<EA agreement number>' ` -TokenOutputFilePath $FilePathForRegistrationToken
容量 SKU ライセンスを購入したときの "EA 契約番号" を使用します。
Get-AzsRegistrationToken コマンドレットの詳細については、「登録に関するリファレンス」を参照してください。
ヒント
登録トークンは、 $FilePathForRegistrationToken に指定されたファイルに保存されます。 ファイル パスまたはファイル名は任意に変更できます。
接続された Azure マシンで使用するためにこの登録トークンを保存します。 $FilePathForRegistrationToken からファイルまたはテキストをコピーできます。
Azure に接続して登録する
インターネットに接続されたコンピューターで同じ手順を実行して、RegisterWithAzure.psm1 モジュールをインポートし、正しい Azure PowerShell コンテキストにサインインします。 次に、Register-AzsEnvironment を呼び出します。 Azure に登録する登録トークンを指定します。 同じ Azure サブスクリプション ID を利用して Azure Stack Hub の複数のインスタンスを登録している場合は、一意の登録名を指定します。
自分の登録トークンと、一意のトークン名が必要です。
管理者として PowerShell ISE を起動し、Azure Stack Hub ツールをダウンロードしたときに作成された AzureStack-Tools-az ディレクトリ内の Registration フォルダーに移動します。 RegisterWithAzure.psm1 モジュールをインポートします。
Import-Module .\RegisterWithAzure.psm1
その後、PowerShell コマンドレットを実行します。
$RegistrationToken = "<Your Registration Token>" $RegistrationName = "<unique-registration-name>" Register-AzsEnvironment -RegistrationToken $RegistrationToken -RegistrationName $RegistrationName
オプションで、Get-Content コマンドレットを使用して、登録トークンが含まれているファイルを示すことができます。
自分の登録トークンと、一意のトークン名が必要です。
管理者として PowerShell ISE を起動し、Azure Stack Hub ツールをダウンロードしたときに作成された AzureStack-Tools-az ディレクトリ内の Registration フォルダーに移動します。 RegisterWithAzure.psm1 モジュールをインポートします。
Import-Module .\RegisterWithAzure.psm1
その後、PowerShell コマンドレットを実行します。
$RegistrationToken = Get-Content -Path '<Path>\<Registration Token File>' Register-AzsEnvironment -RegistrationToken $RegistrationToken -RegistrationName $RegistrationName
Note
後で参照できるように登録リソース名および登録トークンを保存します。
Azure の登録リソースからアクティブ化キーを取得する
次に、Register-AzsEnvironment 中に Azure で作成された登録リソースからアクティブ化キーを取得する必要があります。
アクティブ化キーを取得するには、次の PowerShell コマンドレットを実行します。
$RegistrationResourceName = "<unique-registration-name>"
$KeyOutputFilePath = "$env:SystemDrive\ActivationKey.txt"
$ActivationKey = Get-AzsActivationKey -RegistrationName $RegistrationResourceName -KeyOutputFilePath $KeyOutputFilePath
ヒント
アクティブ化キーは $KeyOutputFilePath に指定されたファイルに保存されます。 ファイル パスまたはファイル名は任意に変更できます。
Azure Stack Hub にアクティブ化リソースを作成する
Get-AzsActivationKey から作成されたアクティブ化キーのファイルまたはテキストを使用して Azure Stack Hub 環境に戻ります。 次に、アクティブ化キーを使用して Azure Stack Hub にアクティブ化リソースを作成します。 アクティブ化リソースを作成するには、次の PowerShell コマンドレットを実行します。
# Open the file that contains the activation key (from Azure), copy the entire contents into your clipboard, then within your PowerShell session (that will communicate with the PEP), paste the activation key contents into a string variable, enclosed by quotation marks:
$ActivationKey = "<paste activation key here>"
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey
オプションで、Get-Content コマンドレットを使用して、登録トークンが含まれているファイルを示すことができます。
$ActivationKey = Get-Content -Path '<Path>\<Activation Key File>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
New-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -ActivationKey $ActivationKey
Azure Stack Hub の登録を検証する
Azure Stack Hub の登録に成功したことは、 [Region management](リージョン管理) タイルを使用して確認できます。 このタイルは、管理者ポータルの既定のダッシュボードにあります。 状態には、登録済みと未登録とがあります。 登録済みである場合は、Azure Stack Hub の登録に使用した Azure サブスクリプション ID が、登録のリソース グループおよび名前と共に表示されます。
Azure Stack Hub 管理者ポータル
https://adminportal.local.azurestack.external
にサインインします。ダッシュボードで、 [Region management](リージョン管理) を選択します。
[プロパティ] を選択します。 このブレードには、環境の状態と詳細が表示されます。 状態には、 [登録済み] 、 [未登録] または [有効期限切れ] があります。
登録した場合、プロパティには以下が含まれます。
- 登録サブスクリプション ID:登録され、Azure Stack Hub に関連付けられた Azure サブスクリプション ID。
- 登録リソース グループ:Azure Stack Hub リソースを含む関連付けられているサブスクリプション内の Azure リソース グループ。
Azure portal を使用して Azure Stack Hub 登録リソースを表示し、登録が成功したことを確認できます。 Azure Stack Hub の登録に使用したサブスクリプションに関連付けられているアカウントを使用して、Azure portal にサインインします。 [すべてのリソース] を選択し、 [非表示の型の表示] チェックボックスをオンにして、登録名を選択します。
登録が成功しなかった場合、この問題を解決するには、こちらの手順に従って再登録する必要があります。
また、登録が成功したかどうかは、Marketplace の管理機能を使用して確認することもできます。 [Marketplace management](Marketplace の管理) ブレードに Marketplace 項目の一覧が表示されれば、登録は成功しています。 ただし、切断されている環境では、[Marketplace management](Marketplace の管理) に Marketplace 項目は表示されません。
登録を更新または変更する
次の状況では、登録を更新する必要があります。
- 容量ベースの年単位サブスクリプションを更新した後。
- 課金モデルを変更したとき。
- 容量ベースの課金のためにスケールが変更されたとき (ノードの追加と削除)。
注意
プロアクティブ ログ収集が有効になっており、Azure Stack Hub の登録を更新または変更する場合は、プロアクティブ ログ収集を再度有効にする必要があります。 プロアクティブ ログ収集の詳細については、「 診断ログの収集」を参照してください。
前提条件
登録を更新または変更するには、管理者ポータルの次の情報が必要です。
管理者ポータル | コマンドレット パラメーター | Notes |
---|---|---|
登録サブスクリプション ID | サブスクリプション | 以前の登録時に使用されたサブスクリプション ID |
登録リソース グループ | ResourceGroupName | 以前の登録リソースが存在するリソース グループ |
登録名 | RegistrationName | 以前の登録時に使用された登録名 |
使用するサブスクリプションを変更する
使用するサブスクリプションを変更する場合は、まず Remove-AzsRegistration コマンドレットを実行します。その後、正しい Azure PowerShell コンテキストにサインインしていることを確認します。 次に、<billing model>
を含む変更されたパラメーターを使用して Set-AzsRegistration を実行します。
Remove-AzsRegistration の実行中、登録時に使用したサブスクリプションにサインインし、管理者ポータルに表示された RegistrationName
パラメーターと ResourceGroupName
パラメーターの値を使用する必要があります。
# select the subscription used during the registration (shown in portal)
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
# unregister using the parameter values from portal
Remove-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'
# switch to new subscription id
Select-AzSubscription -Subscription '<New subscription ID>'
# register
Set-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel '<Billing model>' -RegistrationName '<Registration name>' -ResourceGroupName '<Registration resource group name>'
課金モデルと機能の提供方法の変更、インスタンスの再登録
このセクションは、課金モデルや機能を提供する方法を変更する場合、またはインスタンスを再登録する場合に適用されます。 これらのすべてのケースで、登録関数を呼び出して新しい値を設定します。 最初に現在の登録を削除する必要はありません。
管理者ポータルに表示されているサブスクリプション ID にサインインし、RegistrationName
パラメーターと ResourceGroupName
パラメーターの値は管理者ポータルに表示された値のままで、新しい BillingModel
の値を指定して登録を再実行します。
# select the subscription used during the registration
Select-AzSubscription -Subscription '<Registration subscription ID from portal>'
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
# rerun registration with new BillingModel (or same billing model in case of re-registration) but using other parameters values from portal
Set-AzsRegistration -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel '<New billing model>' -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'
次の状況では、登録を更新または変更する必要があります。
- 容量ベースの年単位サブスクリプションを更新した後。
- 課金モデルを変更したとき。
- 容量ベースの課金のために変更を調整したとき (ノードの追加/削除)。
Azure Stack Hub からアクティブ化リソースを削除する
最初に Azure Stack Hub からアクティブ化リソースを削除してから、Azure の登録リソースを削除する必要があります。
Azure Stack Hub のアクティブ化リソースを削除するには、Azure Stack Hub 環境で次の PowerShell コマンドレットを実行します。
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>"
Remove-AzsActivationResource -PrivilegedEndpointCredential $YourCloudAdminCredential -PrivilegedEndpoint $YourPrivilegedEndpoint
次に、Azure の登録リソースを削除するには、Azure に接続されたコンピューターを使用していることを確認して、正しい Azure PowerShell コンテキストにサインインし、以下の説明に従って、適切な PowerShell コマンドレットを実行します。
リソースの作成に使用した登録トークンを使用できます。
$RegistrationToken = "<registration token>"
Unregister-AzsEnvironment -RegistrationToken $RegistrationToken
または、管理者ポータルの登録名と登録リソース グループ名を使用することもできます。
Unregister-AzsEnvironment -RegistrationName '<Registration name from portal>' -ResourceGroupName '<Registration resource group from portal>'
接続された手順を使用して再登録する
接続状態の容量課金から、接続状態の従量課金に課金モデルを変更する場合は、 接続されたモデルの手順に従って再登録します。
注意
これによって ID モデルが変更されるわけではなく、課金メカニズムのみが変更されます。ID ソースとして AD FS が引き続き使用されます。
切り離された手順を使用して再登録する
これで、接続が切断されたシナリオで登録が完全に解除されました。接続が切断されたシナリオで Azure Stack Hub 環境を登録する手順を繰り返す必要があります。
使用状況レポートを無効または有効にする
容量課金モデルを使用する Azure Stack Hub 環境では、Set-AzsRegistration または Get-AzsRegistrationToken コマンドレットのいずれかで UsageReportingEnabled パラメーターを使用して使用状況レポートをオフにします。 Azure Stack Hub では、既定で使用状況メトリックがレポートされます。 容量モデルを使用するオペレーターまたは切断された環境をサポートするオペレーターは、使用状況レポートをオフにする必要があります。
次の PowerShell コマンドレットを実行します。
$CloudAdminCred = Get-Credential -UserName <Privileged endpoint credentials> -Message "Enter the cloud domain credentials to access the privileged endpoint."
$RegistrationName = "<unique-registration-name>"
Set-AzsRegistration `
-PrivilegedEndpointCredential $CloudAdminCred `
-PrivilegedEndpoint <PrivilegedEndPoint computer name> `
-BillingModel Capacity
-RegistrationName $RegistrationName
-UsageReportingEnabled:$false
登録トークンを変更するには、次の PowerShell コマンドレットを実行します。
$YourPrivilegedEndpoint = "<privileged_endpoint_computer_name>" $FilePathForRegistrationToken = $env:SystemDrive\RegistrationToken.txt $RegistrationToken = Get-AzsRegistrationToken -PrivilegedEndpointCredential $YourCloudAdminCredential -UsageReportingEnabled:$false -PrivilegedEndpoint $YourPrivilegedEndpoint -BillingModel Capacity -AgreementNumber '<EA agreement number>' -TokenOutputFilePath $FilePathForRegistrationToken
容量 SKU ライセンスを購入したときの "EA 契約番号" を使用します。
ヒント
登録トークンは、 $FilePathForRegistrationToken に指定されたファイルに保存されます。 ファイル パスまたはファイル名は任意に変更できます。
接続された Azure マシンで使用するためにこの登録トークンを保存します。 $FilePathForRegistrationToken からファイルまたはテキストをコピーできます。
登録リソースを移動する
同じサブスクリプションのリソース グループ間における登録リソースの移動は、すべての環境でサポートされています。 ただし、サブスクリプションをまたがる登録リソースの移動がサポートされるのは、両方のサブスクリプションで同じパートナー ID が解決される場合の CSP のみです。 新しいリソース グループへのリソースの移動については、「新しいリソース グループまたはサブスクリプションへのリソースの移動」を参照してください。
重要
ポータルで登録リソースが誤って削除されないように、登録スクリプトではリソースに自動的にロックが追加されます。 移動または削除する前に、このロックを解除する必要があります。 誤って削除されないように、登録リソースにロックを追加することをお勧めします。
登録に関するリファレンス
Set-AzsRegistration
Set-AzsRegistration を使用すると、Azure Stack Hub を Azure に登録し、マーケットプレースでの項目のオファーと使用状況レポートを有効または無効にすることができます。
コマンドレットを実行するには、以下が必要です。
- 任意の種類のグローバルな Azure サブスクリプション。
- そのサブスクリプションの所有者または共同作成者であるアカウントを使用して Azure PowerShell にログインします。
Set-AzsRegistration [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String> [[-AzureContext]
<PSObject>] [[-ResourceGroupName] <String>] [[-ResourceGroupLocation] <String>] [[-BillingModel] <String>]
[-MarketplaceSyndicationEnabled] [-UsageReportingEnabled] [[-AgreementNumber] <String>] [[-RegistrationName]
<String>] [<CommonParameters>]
パラメーター | Type | 説明 |
---|---|---|
PrivilegedEndpointCredential | PSCredential | 特権エンドポイントへのアクセスに使用する資格情報。 ユーザー名は、AzureStackDomain\CloudAdmin の形式です。 |
PrivilegedEndpoint | String | ログ収集およびその他のデプロイ後タスクのような機能を提供する、あらかじめ構成されたリモート PowerShell コンソール。 詳細については、特権エンドポイントの使用の記事を参照してください。 |
AzureContext | PSObject | |
ResourceGroupName | String | |
ResourceGroupLocation | String | |
BillingModel | String | 自分のサブスクリプションで使用する請求モデル。 このパラメーターの有効値は、Capacity、PayAsYouUse、および Development です。 |
MarketplaceSyndicationEnabled | True または False | ポータル内で Marketplace 管理機能を使用できるようにするかどうかを決定します。 インターネット接続を使用して登録している場合は true に設定します。 切断された環境で登録している場合は false に設定します。 切断された環境で登録した場合は、オフライン シンジケーション ツールを使用して、マーケットプレースの項目をダウンロードできます。 |
UsageReportingEnabled | True または False | Azure Stack Hub では、既定で使用状況メトリックがレポートされます。 容量モデルを使用するオペレーターまたは切断された環境をサポートするオペレーターは、使用状況レポートをオフにする必要があります。 このパラメーターの有効値は、True、False。 |
AgreementNumber | String | この Azure Stack の容量 SKU が注文された EA 契約の番号。 |
RegistrationName | String | 同じ Azure サブスクリプション ID を利用し、複数の Azure Stack Hub インスタンスで登録スクリプトを実行している場合、登録に一意の名前を設定します。 このパラメーターの既定値は AzureStackRegistration です。 ただし、複数の Azure Stack Hub インスタンスに同じ名前を使用すると、スクリプトは失敗します。 |
Get-AzsRegistrationToken
Get-AzsRegistrationToken は、入力パラメーターから登録トークンを生成します。
Get-AzsRegistrationToken [-PrivilegedEndpointCredential] <PSCredential> [-PrivilegedEndpoint] <String>
[-BillingModel] <String> [[-TokenOutputFilePath] <String>] [-UsageReportingEnabled] [[-AgreementNumber] <String>]
[<CommonParameters>]
パラメーター | Type | 説明 |
---|---|---|
PrivilegedEndpointCredential | PSCredential | 特権エンドポイントへのアクセスに使用する資格情報。 ユーザー名は、AzureStackDomain\CloudAdmin の形式です。 |
PrivilegedEndpoint | String | ログ収集およびその他のデプロイ後タスクのような機能を提供する、あらかじめ構成されたリモート PowerShell コンソール。 詳細については、特権エンドポイントの使用の記事を参照してください。 |
AzureContext | PSObject | |
ResourceGroupName | String | |
ResourceGroupLocation | String | |
BillingModel | String | 自分のサブスクリプションで使用する請求モデル。 このパラメーターに使用できる値は、Capacity、Custom、Development です。 |
MarketplaceSyndicationEnabled | True または False | |
UsageReportingEnabled | True または False | Azure Stack Hub では、既定で使用状況メトリックがレポートされます。 容量モデルを使用するオペレーターまたは切断された環境をサポートするオペレーターは、使用状況レポートをオフにする必要があります。 このパラメーターの有効値は、True、False。 |
AgreementNumber | String |
登録エラー
Azure Stack Hub の登録を試みている間に、次のエラーのいずれかが発生する可能性があります。
の必須ハードウェア情報を
$hostName
取得できませんでした。 物理ホストと接続を確認してから、登録を再実行してください。に接続
$hostName
してハードウェア情報を取得できません。 物理ホストと接続を確認してから、登録を再実行してください。原因: UUID、Bios、CPU などのハードウェアの詳細をホストから取得してアクティブ化を試みましたが、物理ホストに接続できないためにできませんでした。
Cloud identifier [
GUID
] is already registered. (クラウド識別子 [GUID
] は既に登録されています。) クラウド識別子の再利用は許可されません。原因: これは、Azure Stack 環境が既に登録されている場合に発生します。 別のサブスクリプションまたは課金モデルを使用して環境を再登録する場合は、登録を更新または変更する手順に従ってください。
Marketplace の管理にアクセスしして、製品を配信しようとするとエラーが発生します。
原因: これは通常、Azure Stack Hub が登録リソースにアクセスできない場合に発生します。 これに関する一般的な理由の 1 つとして、Azure サブスクリプションのディレクトリ テナントが変更されると登録がリセットされることがあげられます。 サブスクリプションのディレクトリ テナントを変更した場合、Azure Stack Hub Marketplace へのアクセスおよび使用状況のレポートを行うことはできません。 この問題を解決するには再登録する必要があります。