Use o PowerShell para gerir subscrições, planos e ofertas no Azure Stack HubUse PowerShell to manage subscriptions, plans, and offers in Azure Stack Hub

Pode utilizar o PowerShell para configurar e fornecer serviços utilizando ofertas, planos e subscrições.You can use PowerShell to configure and deliver services by using offers, plans, and subscriptions. usando PowerShell.using PowerShell. Para obter instruções sobre a configuração com o PowerShell no Azure Stack Hub, consulte o módulo PowerShell Az para O Azure Stack Hub.For instructions on getting set up with PowerShell on Azure Stack Hub, see Install PowerShell Az module for Azure Stack Hub. Para obter informações sobre a ligação ao Azure Stack Hub utilizando o PowerShell, consulte Connect to Azure Stack Hub com PowerShell.For information on connecting to Azure Stack Hub using PowerShell, see Connect to Azure Stack Hub with PowerShell.

Antes de começar, verifique se o módulo PowerShell do Hub Azure Stack está carregado.Before you begin, verify the Azure Stack Hub PowerShell module is loaded. Numa consola PowerShell, escreva Import-Module AzureStack .In a PowerShell console, type Import-Module AzureStack.

Criar um planoCreate a plan

São necessárias quotas na criação de um plano.Quotas are required when creating a plan. Pode utilizar quotas existentes ou criar novas quotas.You can use an existing quotas or create new quotas. Por exemplo, para criar uma quota de armazenamento, cálculo e rede, pode utilizar os cmdlets New-AzsStorageQuota, New-AzsComputeQuotae New-AzsNetworkQuota:For example, to create a storage, compute and network quota, you can use the New-AzsStorageQuota, New-AzsComputeQuota, and New-AzsNetworkQuota cmdlets:

$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 de base ou de complemento, utilize o New-AzsPlan.To create or update a base or add-on plan, use New-AzsPlan.

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

Criar uma ofertaCreate an offer

Para criar uma oferta, utilize o New-AzsOffer.To create an offer, use New-AzsOffer.

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

Uma vez que você tem uma oferta, você pode adicionar planos à oferta.Once you have an offer, you can add plans to the offer. Utilize Add-AzsPlanToOffer.Use Add-AzsPlanToOffer. O parâmetro -PlanLinkType distingue o tipo de plano.The -PlanLinkType parameter distinguishes the plan type.

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.If you want to change the state of an offer, use the Set-AzsOffer cmdlet.

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

Criar subscrição a uma ofertaCreate subscription to an offer

Depois de criar uma oferta, os utilizadores necessitam de uma subscrição para essa oferta para a poderem utilizar.After you create an offer, users need a subscription to that offer before they can use it. Existem duas formas de os utilizadores subscreverem uma oferta:There are two ways that users can subscribe to an offer:

  • Como operador de nuvem, pode criar uma subscrição para um utilizador.As a cloud operator, you can create a subscription for a user. As subscrições que criar podem ser para ofertas públicas e privadas.Subscriptions you create can be for both public and private offers.
  • Como utilizador, pode subscrever uma oferta pública.As a user, you can subscribe to a public offer.

Para criar uma subscrição para um utilizador como operador de nuvem, utilize a subscrição new-AzsUserSubscription.To create a subscription for a user as a cloud operator, use 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 a Subscrição new-AzsSubscription.To subscribe to a public offer as a user, use New-AzsSubscription. A nova subscrição do AzsS requer ligação ao ambiente do Gestor de Recursos Azure do utilizador.New-AzsSubscription requires connection to the user Azure Resource Manager environment. Utilize os passos em Connect to Azure Stack Hub com PowerShell, mas utilize o ponto final do utilizador Azure Resource Manager.Use the steps in Connect to Azure Stack Hub with PowerShell but use the user Azure Resource Manager endpoint. Por exemplo, Add-AzEnvironment -Name "AzureStackUser" -ArmEndpoint "https://management.local.azurestack.external".For example, Add-AzEnvironment -Name "AzureStackUser" -ArmEndpoint "https://management.local.azurestack.external".

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

Eliminar quotas, planos, ofertas e subscriçõesDelete quotas, plans, offers, and subscriptions

Existem cmdlets powerShell para eliminar quotas, planos, ofertas e subscrições do Azure Stack Hub.There are companion PowerShell cmdlets to delete Azure Stack Hub quotas, plans, offers, and subscriptions. Os seguintes exemplos de espetáculo para cada um.The following show examples for each.

Utilize remove-AzsUserSubscription para remover uma subscrição de uma oferta.Use Remove-AzsUserSubscription to remove a subscription from an offer.

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

Para remover um plano de uma oferta, utilize Remove-AzsPlanFromOffer.To remove a plan from an offer, use 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.Use Remove-AzsPlan to remove a plan.

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

Utilize remove-AzsOffer para remover uma oferta.Use Remove-AzsOffer to remove an offer.

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

Para eliminar quotas, utilize Remove-AzsStorageQuota, Remove-AzsComputeQuota, Remove-AzsNetworkQuota .To remove quotas, use 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 seguintesNext steps