Compartir a través de

Uso de PowerShell para administrar suscripciones, planes y ofertas en Azure Stack Hub

  • Artículo

Puede usar PowerShell para configurar y entregar servicios por medio de ofertas, planes y suscripciones. Para obtener instrucciones sobre cómo configurar PowerShell en Azure Stack Hub, consulte Instalación del módulo Az de PowerShell para Azure Stack Hub. Para más información sobre cómo conectarse a Azure Stack Hub con PowerShell, consulte Conexión a Azure Stack Hub con PowerShell.

Antes de empezar, compruebe que el módulo de PowerShell para Azure Stack Hub está cargado. En una consola de PowerShell, escriba Import-Module AzureStack.

Creación de un plan

Las cuotas son necesarias al crear un plan. Puede usar las cuotas existentes o crear unas nuevas. Por ejemplo, para crear una cuota de almacenamiento, proceso y red, puede usar los cmdlets New-AzsStorageQuota, New-AzsComputeQuota y 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 crear o actualizar una base o un plan complementario, use New-AzsPlan.

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

Creación de una oferta

Para crear una oferta, use New-AzsOffer.

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

Una vez que tenga una oferta, puede agregarle planes. Use Add-AzsPlanToOffer. El parámetro -PlanLinkType distingue el tipo de plan.

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

Si desea cambiar el estado de una oferta, use el cmdlet Set-AzsOffer.

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

Creación de una suscripción a una oferta

Después de crear una oferta, los usuarios necesitan una suscripción a dicha oferta antes de que puedan utilizarla. Hay dos formas en las que los usuarios pueden suscribirse a una oferta:

  • Como operador de nube, puede crear una suscripción para un usuario. Las suscripciones que cree pueden ser para ofertas tanto públicas como privadas.
  • Como usuario, puede suscribirse a una oferta pública.

Para crear una suscripción para un usuario como operador de nube, 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 suscribirse a una oferta pública como usuario, utilice New-AzsSubscription. New-AzsSubscription requiere una conexión al entorno de Azure Resource Manager del usuario. Siga los pasos descritos en Conexión a Azure Stack Hub con PowerShell, pero utilice el punto de conexión de Azure Resource Manager del usuario. Por ejemplo, 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"

Eliminación de cuotas, planes, ofertas y suscripciones

Hay cmdlets de PowerShell complementarios para eliminar suscripciones, planes, ofertas y cuotas de Azure Stack Hub. A continuación, se muestran ejemplos de cada uno.

Use Remove-AzsUserSubscription para quitar una suscripción de una oferta.

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

Para quitar un plan de una oferta, utilice Remove-AzsPlanFromOffer.

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

Use Remove-AzsPlan para quitar un plan.

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

Use Remove-AzsOffer para quitar una oferta.

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

Para quitar cuotas, 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"

Pasos siguientes