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-Anbieter 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.