Schnellstart: Erstellen eines benutzerdefinierten Azure-Ressourcenanbieters mit Azure PowerShell
In dieser Schnellstartanleitung erfahren Sie, wie Sie mit dem PowerShell-Modul Az.CustomProviders einen eigenen benutzerdefinierten Azure-Ressourcenanbieter erstellen.
Achtung
Benutzerdefinierte Azure-Ressourcenanbieter sind derzeit als öffentliche Vorschauversion verfügbar. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt. Für Produktionsworkloads wird sie nicht empfohlen. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.
Requirements (Anforderungen)
Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
Falls Sie PowerShell lokal verwenden möchten, müssen Sie für diesen Artikel das Az PowerShell-Modul installieren und mit dem Cmdlet Connect-AzAccount eine Verbindung mit Ihrem Azure-Konto herstellen. Weitere Informationen zum Installieren des Az PowerShell-Moduls finden Sie unter Installieren von Azure PowerShell. Wenn Sie sich für die Verwendung von Cloud Shell entscheiden, finden Sie unter Übersicht über Azure Cloud Shell weitere Informationen.
Wichtig
Solange nur eine Vorschauversion des PowerShell-Moduls Az.CustomProviders verfügbar ist, müssen Sie es separat mithilfe des Cmdlets Install-Module
installieren. Sobald dieses PowerShell-Modul allgemein verfügbar ist, wird es in die zukünftigen Releases des Az PowerShell-Moduls integriert und in Azure Cloud Shell nativ zur Verfügung gestellt.
Install-Module -Name Az.CustomProviders
Wenn Sie über mehrere Azure-Abonnements verfügen, müssen Sie das entsprechende Abonnement auswählen, in dem die Ressourcen fakturiert werden sollen. Wählen Sie mit dem Cmdlet Set-AzContext ein bestimmtes Abonnement aus.
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
Erstellen einer Ressourcengruppe
Erstellen Sie mit dem Cmdlet New-AzResourceGroup eine Azure-Ressourcengruppe. Eine Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen als Gruppe bereitgestellt und verwaltet werden.
Im folgenden Beispiel wird eine Ressourcengruppe mit dem angegebenen Namen am angegebenen Standort erstellt.
New-AzResourceGroup -Name myResourceGroup -Location westus2
Erstellen eines benutzerdefinierten Ressourcenanbieters
Zum Erstellen oder Aktualisieren eines benutzerdefinierten Ressourcenanbieters verwenden Sie das Cmdlet New-AzCustomProvider, wie im folgenden Beispiel gezeigt:
New-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type -Location westus2 -ResourceType @{Name='CustomRoute1'; Endpoint='https://www.contoso.com/'}
Abrufen des Manifests für benutzerdefinierte Ressourcenanbieter
Zum Abrufen von Informationen zum Manifest für benutzerdefinierte Ressourcenanbieter verwenden Sie das Cmdlet Get-AzCustomProvider, wie im folgenden Beispiel gezeigt:
Get-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type | Format-List
Erstellen einer Zuordnung
Verwenden Sie zum Erstellen oder Aktualisieren einer Zuordnung das Cmdlet New-AzCustomProviderAssociation, wie im folgenden Beispiel gezeigt:
$provider = Get-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type
New-AzCustomProviderAssociation -Scope $resourceId -Name MyAssoc -TargetResourceId $provider.Id
Abrufen einer Zuordnung
Verwenden Sie zum Abrufen von Informationen zu einer Zuordnung das Cmdlet Get-AzCustomProviderAssociation, wie im folgenden Beispiel gezeigt:
Get-AzCustomProviderAssociation -Scope $resourceId -Name MyAssoc
Bereinigen von Ressourcen
Wenn die in diesem Artikel erstellten Ressourcen nicht benötigt werden, können Sie sie löschen, indem Sie die folgenden Beispiele ausführen.
Löschen einer Zuordnung
Um eine Zuordnung zu entfernen, verwenden Sie das Cmdlet Remove-AzCustomProviderAssociation. Im folgenden Beispiel wird eine Zuordnung gelöscht:
Remove-AzCustomProviderAssociation -Scope $id -Name Namespace.Type
Löschen eines benutzerdefinierten Ressourcenanbieters
Zum Entfernen eines benutzerdefinierten Ressourcenanbieters verwenden Sie das Cmdlet Remove-AzCustomProvider. Im folgenden Beispiel wird ein benutzerdefinierter Ressourcenanbieter gelöscht:
Remove-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type
Löschen der Ressourcengruppe
Achtung
Im folgenden Beispiel werden die angegebene Ressourcengruppe und alle darin enthaltenen Ressourcen gelöscht. Falls in der angegebenen Ressourcengruppe Ressourcen enthalten sind, die nicht zum Umfang dieses Artikels gehören, werden sie ebenfalls gelöscht.
Remove-AzResourceGroup -Name myResourceGroup
Nächste Schritte
Informieren Sie sich ausführlicher über benutzerdefinierte Azure-Ressourcenanbieter.