Utilizar o PowerShell para gerir subscrições, planos e ofertas no Azure Stack Hub

  • Artigo

Pode utilizar o PowerShell para configurar e fornecer serviços através de ofertas, planos e subscrições. Para obter instruções sobre como configurar o PowerShell no Azure Stack Hub, veja Instalar o módulo Az do PowerShell para o Azure Stack Hub. Para obter informações sobre como ligar ao Azure Stack Hub com o PowerShell, veja Ligar ao Azure Stack Hub com o PowerShell.

Antes de começar, verifique se o módulo do PowerShell do Azure Stack Hub está carregado. Numa consola do PowerShell, escreva Import-Module AzureStack.

Criar um plano

As quotas são necessárias ao criar um plano. Pode utilizar quotas existentes ou criar novas quotas. Por exemplo, para criar uma quota de armazenamento, computação e rede, pode utilizar os cmdlets New-AzsStorageQuota, New-AzsComputeQuota e 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

Para criar ou atualizar um plano base ou de suplemento, utilize New-AzsPlan.

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

Criar uma oferta

Para criar uma oferta, utilize New-AzsOffer.

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

Assim que tiver uma oferta, pode adicionar planos à oferta. Utilize Add-AzsPlanToOffer. O parâmetro -PlanLinkType distingue o tipo de plano.

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

Se quiser alterar o estado de uma oferta, utilize o cmdlet Set-AzsOffer .

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

Criar uma subscrição para uma oferta

Depois de criar uma oferta, os utilizadores necessitam de uma subscrição para essa oferta para a poderem utilizar. Existem duas formas de os utilizadores subscreverem uma oferta:

  • Como operador da cloud, pode criar uma subscrição para um utilizador. As subscrições que criar podem ser para ofertas públicas e privadas.
  • Como utilizador, pode subscrever uma oferta pública.

Para criar uma subscrição para um utilizador como operador de cloud, utilize New-AzsUserSubscription.

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

Para subscrever uma oferta pública como utilizador, utilize New-AzsSubscription. New-AzsSubscription requer ligação ao ambiente Resource Manager do utilizador. Utilize os passos em Ligar ao Azure Stack Hub com o PowerShell, mas utilize o utilizador Azure Resource Manager ponto final. Por exemplo, 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"

Eliminar quotas, planos, ofertas e subscrições

Existem cmdlets complementares do PowerShell para eliminar quotas, planos, ofertas e subscrições do Azure Stack Hub. Os exemplos seguintes mostram exemplos para cada um.

Utilize Remove-AzsUserSubscription para remover uma subscrição de uma oferta.

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

Para remover um plano de uma oferta, utilize Remove-AzsPlanFromOffer.

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

Utilize Remove-AzsPlan para remover um plano.

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

Utilize Remove-AzsOffer para remover uma oferta.

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

Para remover quotas, utilize 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"

Passos seguintes