Azure Stack Hub で PowerShell を使用してサブスクリプション、プラン、およびオファーを管理する

  • [アーティクル]

オファー、プラン、およびサブスクリプションを使用することで、PowerShell でサービスを構成して提供できます。 Azure Stack Hub で PowerShell を使用してセットアップする手順については、「Azure Stack Hub 用の PowerShell Az モジュールをインストールする」を参照してください。 PowerShell を使用した Azure Stack Hub への接続に関する情報については、「PowerShell を使用して Azure Stack Hub に接続する」を参照してください。

開始する前に、Azure Stack Hub PowerShell モジュールが読み込まれていることを確認します。 PowerShell コンソールで、「Import-Module AzureStack」と入力します。

プランの作成

プランを作成する際は、クォータが必要です。 既存のクォータを使用することも、新しいクォータを作成することもできます。 たとえば、ストレージ、コンピューティング、およびネットワークのクォータを作成するには、New-AzsStorageQuota、New-AzsComputeQuota、および New-AzsNetworkQuota コマンドレットを使用できます。

$serviceQuotas  = @()
$serviceQuotas += (New-AzsStorageQuota -Name "Example storage quota with defaults").Id
$serviceQuotas += (New-AzsComputeQuota -Name "Example compute quota with defaults").Id
$serviceQuotas += (New-AzsNetworkQuota -Name "Example network quota with defaults").Id

基本またはアドオン プランを作成または更新するには、New-AzsPlan を使用します。

$testPlan = New-AzsPlan -Name "testplan" -ResourceGroupName "testrg" -QuotaIds $serviceQuotas -Description "Test plan"

オファーの作成

オファーを作成するには、New-AzsOffer を使用します。

New-AzsOffer -Name "testoffer" -ResourceGroupName "testrg" -BasePlanIds @($testPlan.Id)

オファーを作成したら、プランをオファーに追加できます。 Add-AzsPlanToOffer を使用します。 -PlanLinkType パラメーターによって、プランの種類が区別されます。

Add-AzsPlanToOffer -PlanName "addonplan" -PlanLinkType Addon -OfferName "testoffer" -ResourceGroupName "testrg" -MaxAcquisitionCount 18

オファーの状態を変更する場合は、Set-AzsOffer コマンドレットを使用します。

$offer = Get-AzsAdminManagedOffer -Name "testoffer" -ResourceGroupName "testrg"
$offer.state = "Public"
$offer | Set-AzsOffer -Confirm:$false

オファーに対するサブスクリプションを作成する

オファーを作成した後、ユーザーは、それを使用できるようにするために、そのオファーに対するサブスクリプションが必要になります。 ユーザーがオファーをサブスクライブできる方法は 2 つあります。

  • クラウド オペレーターとして、ユーザー用のサブスクリプションを作成できます。 作成したサブスクリプションは、パブリック オファーとプライベート オファーの両方に対応します。
  • ユーザーとして、パブリック オファーをサブスクライブできます。

クラウド オペレーターとしてユーザー用のサブスクリプションを作成するには、New-AzsUserSubscription を使用します。

New-AzsUserSubscription -Owner "user@contoso.com" -DisplayName "User subscription" -OfferId "/subscriptions/<Subscription ID>/resourceGroups/testrg/providers/Microsoft.Subscriptions.Admin/offers/testoffer"

ユーザーとしてパブリック オファーをサブスクライブするには、New-AzsSubscription を使用します。 New-AzsSubscription では、ユーザーの Azure Resource Manager 環境への接続が必要です。 「PowerShell を使用して Azure Stack Hub に接続する」の手順を使用しますが、ユーザーの Azure Resource Manager エンドポイントを使用します。 たとえば、「 Add-AzEnvironment -Name "AzureStackUser" -ArmEndpoint "https://management.local.azurestack.external" 」のように入力します。

$testOffer = Get-AzsOffer | Where-Object Name -eq "testoffer"
New-AzsSubscription -OfferId $testOffer.Id -DisplayName "My subscription"

クォータ、プラン、オファーおよびサブスクリプションの削除

Azure Stack Hub のクォータ、プラン、オファー、およびサブスクリプションを削除するためのコンパニオン PowerShell コマンドレットがあります。 それぞれの例を次に示します。

オファーからサブスクリプションを削除するには、Remove-AzsUserSubscription を使用します。

Remove-AzsUserSubscription -TargetSubscriptionId "c90173b1-de7a-4b1d-8600-b8325ca1eab1e"

オファーからプランを削除するには、Remove-AzsPlanFromOffer を使用します。

Remove-AzsPlanFromOffer -PlanName "addonplan" -PlanLinkType Addon -OfferName "testoffer" -ResourceGroupName "testrg"
Remove-AzsPlanFromOffer -PlanName "testplan" -PlanLinkType Base -OfferName "testoffer" -ResourceGroupName "testrg"

プランを削除するには、Remove-AzsPlan を使用します。

Remove-AzsPlan -Name "testplan" -ResourceGroupName "testrg"

オファーを削除するには、Remove-AzsOffer を使用します。

Remove-AzsOffer -Name "testoffer" -ResourceGroupName "testrg"

クォータを削除するには、Remove-AzsStorageQuota、Remove-AzsComputeQuota、Remove-AzsNetworkQuota を使用します。

Remove-AzsStorageQuota -Name "Example storage quota with defaults"
Remove-AzsComputeQuota -Name "Example compute quota with defaults"
Remove-AzsNetworkQuota -Name "Example network quota with defaults"

次のステップ