Usare PowerShell per gestire sottoscrizioni, piani e offerte nell'hub Azure StackUse PowerShell to manage subscriptions, plans, and offers in Azure Stack Hub

È possibile usare PowerShell per configurare e distribuire i servizi usando le offerte, i piani e le sottoscrizioni.You can use PowerShell to configure and deliver services by using offers, plans, and subscriptions. tramite PowerShell.using PowerShell. Per istruzioni su come configurare con PowerShell nell'hub Azure Stack, vedere Install PowerShell AZ Module for Azure stack Hub.For instructions on getting set up with PowerShell on Azure Stack Hub, see Install PowerShell Az module for Azure Stack Hub. Per informazioni sulla connessione all'hub Azure Stack tramite PowerShell, vedere connettersi all'hub Azure stack con PowerShell.For information on connecting to Azure Stack Hub using PowerShell, see Connect to Azure Stack Hub with PowerShell.

Prima di iniziare, verificare che il modulo PowerShell dell'hub Azure Stack sia caricato.Before you begin, verify the Azure Stack Hub PowerShell module is loaded. In una console di PowerShell digitare Import-Module AzureStack .In a PowerShell console, type Import-Module AzureStack.

Creare un pianoCreate a plan

Le quote sono obbligatorie per la creazione di un piano.Quotas are required when creating a plan. È possibile utilizzare quote esistenti o creare nuove quote.You can use an existing quotas or create new quotas. Ad esempio, per creare una quota di archiviazione, calcolo e rete, è possibile usare i cmdlet 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

Per creare o aggiornare un piano base o aggiuntivo, usare 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"

Creare un'offertaCreate an offer

Per creare un'offerta, usare New-AzsOffer.To create an offer, use New-AzsOffer.

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

Una volta offerta, è possibile aggiungere piani all'offerta.Once you have an offer, you can add plans to the offer. Usare Add-AzsPlanToOffer.Use Add-AzsPlanToOffer. Il parametro -PlanLinkType distingue il tipo di piano.The -PlanLinkType parameter distinguishes the plan type.

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

Se si vuole modificare lo stato di un'offerta, usare il 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

Creare una sottoscrizione a un'offertaCreate subscription to an offer

Dopo aver creato un'offerta, gli utenti necessitano di una sottoscrizione per l'offerta prima di poterla usare.After you create an offer, users need a subscription to that offer before they can use it. Esistono due modi in cui gli utenti possono sottoscrivere un'offerta:There are two ways that users can subscribe to an offer:

  • Come operatore cloud, è possibile creare una sottoscrizione per un utente.As a cloud operator, you can create a subscription for a user. Le sottoscrizioni create possono essere per offerte pubbliche e private.Subscriptions you create can be for both public and private offers.
  • In qualità di utente, è possibile sottoscrivere un'offerta pubblica.As a user, you can subscribe to a public offer.

Per creare una sottoscrizione per un utente come operatore cloud, usare 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"

Per sottoscrivere un'offerta pubblica come utente, usare New-AzsSubscription.To subscribe to a public offer as a user, use New-AzsSubscription. New-AzsSubscription richiede la connessione all'ambiente Azure Resource Manager utente.New-AzsSubscription requires connection to the user Azure Resource Manager environment. Usare la procedura descritta in connettersi all'Hub Azure stack con PowerShell , ma usare l'endpoint utente Azure Resource Manager.Use the steps in Connect to Azure Stack Hub with PowerShell but use the user Azure Resource Manager endpoint. Ad esempio: 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"

Elimina quote, piani, offerte e sottoscrizioniDelete quotas, plans, offers, and subscriptions

Sono disponibili cmdlet di PowerShell complementari per eliminare le quote, i piani, le offerte e le sottoscrizioni dell'hub Azure Stack.There are companion PowerShell cmdlets to delete Azure Stack Hub quotas, plans, offers, and subscriptions. Gli esempi seguenti illustrano ogni.The following show examples for each.

Usare Remove-AzsUserSubscription per rimuovere una sottoscrizione da un'offerta.Use Remove-AzsUserSubscription to remove a subscription from an offer.

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

Per rimuovere un piano da un'offerta, usare 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"

Usare Remove-AzsPlan per rimuovere un piano.Use Remove-AzsPlan to remove a plan.

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

Usare Remove-AzsOffer per rimuovere un'offerta.Use Remove-AzsOffer to remove an offer.

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

Per rimuovere le quote, usare Remove-AzsStorageQuota, Remove-AzsComputeQuotae 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"

Passaggi successiviNext steps