Uso de PowerShell para administrar suscripciones, planes y ofertas en Azure Stack Hub
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"