Partager via

Utiliser PowerShell pour gérer les abonnements, les plans et les offres dans Azure Stack Hub

  • Article

À l’aide de PowerShell, vous pouvez configurer et fournir des services en utilisant des offres, des plans et des abonnements. Pour obtenir des instructions sur la configuration de PowerShell sur Azure Stack Hub, consultez Installer le module PowerShell Az pour Azure Stack Hub. Pour des informations sur la connexion à Azure Stack Hub à l’aide de PowerShell, consultez Se connecter à Azure Stack Hub avec PowerShell.

Avant de commencer, vérifiez que le module PowerShell Azure Stack Hub est chargé. Dans une console PowerShell, tapez Import-Module AzureStack.

Créer un plan

Vous devez définir des quotas quand vous créez un plan. Vous pouvez choisir des quotas existants ou créer d’autres quotas. Par exemple, pour créer des quotas de stockage, de calcul et de réseau, utilisez les applets de commande New-AzsStorageQuota, New-AzsComputeQuota et 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

Pour créer ou mettre à jour un plan de base ou d’extension, utilisez New-AzsPlan.

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

Créer une offre

Pour créer une offre, utilisez New-AzsOffer.

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

Une fois que vous avez créé une offre, vous pouvez y ajouter des plans. Utilisez Add-AzsPlanToOffer. Le paramètre -PlanLinkType spécifie le type de plan.

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

Si vous souhaitez changer l’état d’une offre, utilisez l’applet de commande Set-AzsOffer.

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

Créer un abonnement à une offre

Après avoir créé une offre, les utilisateurs ont besoin d’un abonnement à cette offre pour pouvoir l’utiliser. Les utilisateurs peuvent s’abonner à une offre de deux façons :

  • En tant qu’opérateur cloud, vous pouvez créer un abonnement pour un utilisateur. Les abonnements créés peuvent être destinés à des offres publiques et privées.
  • En tant qu’utilisateur, vous pouvez vous abonner à une offre publique.

Pour créer un abonnement pour un utilisateur en tant qu’opérateur cloud, utilisez New-AzsUserSubscription.

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

Pour vous abonner à une offre publique en tant qu’utilisateur, utilisez New-AzsSubscription. New-AzsSubscription requiert une connexion à l’environnement Azure Resource Manager de l’utilisateur. Effectuez les étapes décrites dans Se connecter à Azure Stack Hub avec PowerShell, mais en utilisant le point de terminaison Azure Resource Manager de l’utilisateur. Par exemple : 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"

Supprimer des quotas, plans, offres et abonnements

Plusieurs applets de commande PowerShell sont fournies pour supprimer des quotas, plans, offres et abonnements dans Azure Stack Hub. Les exemples suivants illustrent chacune de ces applets.

Utilisez Remove-AzsUserSubscription pour supprimer un abonnement d’une offre.

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

Pour supprimer un plan d’une offre, utilisez Remove-AzsPlanFromOffer.

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

Utilisez Remove-AzsPlan pour supprimer un plan.

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

Utilisez Remove-AzsOffer pour supprimer une offre.

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

Pour supprimer des quotas, utilisez Remove-AzsStorageQuota, Remove-AzsComputeQuota et 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"

Étapes suivantes