Utilizar o PowerShell para gerir subscrições, planos e ofertas no Azure Stack Hub
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"