Verwenden von PowerShell zum Verwalten von Abonnements, Plänen und Angeboten in Azure Stack Hub

  • Artikel

Sie können PowerShell zum Konfigurieren und Bereitstellen von Diensten nutzen, indem Sie Angebote, Pläne und Abonnements verwenden. Eine Anleitung zum Einrichten von PowerShell in Azure Stack Hub finden Sie unter Installieren des PowerShell Az-Moduls für Azure Stack Hub. Informationen zum Herstellen einer Verbindung mit Azure Stack Hub über PowerShell finden Sie unter Herstellen einer Verbindung mit Azure Stack Hub über PowerShell.

Vergewissern Sie sich zunächst, dass das Azure Stack Hub-PowerShell-Modul geladen wurde. Geben Sie in einer PowerShell-Konsole Import-Module AzureStack ein.

Erstellen von Plänen

Beim Erstellen eines Plans werden Kontingente benötigt. Sie können vorhandene Kontingente verwenden oder neue Kontingente erstellen. Für die Erstellung eines Speicher-, Compute- bzw. Netzwerkkontingents können Sie beispielsweise die Cmdlets New-AzsStorageQuota, New-AzsComputeQuota und New-AzsNetworkQuota verwenden:

$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

Verwenden Sie New-AzsPlan, um einen Basis- oder Add-On-Plan zu erstellen oder zu aktualisieren.

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

Erstellen von Angeboten

Verwenden Sie New-AzsOffer, um ein Angebot zu erstellen.

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

Wenn Sie dann über ein Angebot verfügen, können Sie dafür Pläne hinzufügen. Verwenden Sie hierfür Add-AzsPlanToOffer. Der Parameter -PlanLinkType dient zum Angeben des Plantyps.

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

Verwenden Sie das Cmdlet Set-AzsOffer, wenn Sie den Status eines Angebots ändern möchten.

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

Erstellen eines Abonnements für ein Angebot

Nachdem Sie ein Angebot erstellt haben, benötigen Benutzer ein Abonnement für dieses Angebot, damit sie es nutzen können. Ein Benutzer kann auf zwei Arten ein Abonnement für ein Angebot erhalten:

  • Als Cloudbetreiber können Sie ein Abonnement für einen Benutzer erstellen. Von Ihnen erstellte Abonnements können für öffentliche und private Angebote verwendet werden.
  • Als Benutzer können Sie ein öffentliches Angebot abonnieren.

Verwenden Sie New-AzsUserSubscription, um als Cloudbetreiber ein Abonnement für einen Benutzer zu erstellen.

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

Verwenden Sie New-AzsSubscription, um als Benutzer ein öffentliches Angebot zu abonnieren. Für New-AzsSubscription wird eine Verbindung mit der Azure Resource Manager-Umgebung des Benutzers benötigt. Führen Sie die Schritte unter Herstellen einer Verbindung mit Azure Stack Hub über PowerShell aus, aber verwenden Sie dabei den Azure Resource Manager-Endpunkt des Benutzers. Beispiel: 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"

Löschen von Kontingenten, Plänen, Angeboten und Abonnements

Es sind zusätzliche PowerShell-Cmdlets zum Löschen von Azure Stack Hub-Kontingenten, -Plänen, -Angeboten und -Abonnements vorhanden. Unten sind hierfür jeweils Beispiele angegeben.

Verwenden Sie Remove-AzsUserSubscription, um ein Abonnement für ein Angebot zu entfernen.

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

Verwenden Sie Remove-AzsPlanFromOffer, um einen Plan für ein Angebot zu entfernen.

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

Verwenden Sie Remove-AzsPlan, um einen Plan zu entfernen.

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

Verwenden Sie Remove-AzsOffer, um ein Angebot zu entfernen.

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

Verwenden Sie Remove-AzsStorageQuota, Remove-AzsComputeQuota bzw. Remove-AzsNetworkQuota, um Kontingente zu entfernen.

Remove-AzsStorageQuota -Name "Example storage quota with defaults"
Remove-AzsComputeQuota -Name "Example compute quota with defaults"
Remove-AzsNetworkQuota -Name "Example network quota with defaults"

Nächste Schritte