Läs på engelska

Dela via

Snabbstart: Skapa en anpassad Azure-resursprovider med Azure PowerShell

  • Artikel

I den här snabbstarten får du lära dig hur du skapar en egen anpassad Azure-resursprovider med hjälp av PowerShell-modulen Az.CustomProviders .

Varning

Azure Custom Resource Providers finns för närvarande i offentlig förhandsversion. Förhandsversionen tillhandahålls utan serviceavtal. Den rekommenderas inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Krav

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Om du väljer att använda PowerShell lokalt kräver den här artikeln att du installerar Az PowerShell-modulen och ansluter till ditt Azure-konto med hjälp av cmdleten Anslut-AzAccount. Mer information om hur du installerar Az PowerShell-modulen finns i Installera Azure PowerShell. Om du väljer att använda Cloud Shell kan du läsa Översikt över Azure Cloud Shell för mer information.

Viktigt

Även om PowerShell-modulen Az.CustomProviders är i förhandsversion måste du installera den separat med hjälp av cmdleten Install-Module . När den här PowerShell-modulen blir allmänt tillgänglig blir den en del av framtida Az PowerShell-modulversioner och är tillgänglig internt inifrån Azure Cloud Shell.

Azure PowerShell 
Install-Module -Name Az.CustomProviders

Om du har flera Azure-prenumerationer väljer du den prenumeration där resurserna ska faktureras. Välj en specifik prenumeration med hjälp av cmdleten Set-AzContext .

Azure PowerShell 
Set-AzContext -SubscriptionId aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e

Skapa en resursgrupp

Skapa en Azure-resursgrupp med cmdleten New-AzResourceGroup . En resursgrupp är en logisk container där Azure-resurser distribueras och hanteras som en grupp.

I följande exempel skapas en resursgrupp med det angivna namnet och på den angivna platsen.

Azure PowerShell 
New-AzResourceGroup -Name myResourceGroup -Location westus2

Skapa en anpassad resursprovider

Om du vill skapa eller uppdatera en anpassad resursprovider använder du cmdleten New-AzCustomProvider enligt följande exempel.

Azure PowerShell 
New-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type -Location westus2 -ResourceType @{Name='CustomRoute1'; Endpoint='https://www.contoso.com/'}

Hämta manifestet för den anpassade resursprovidern

Om du vill hämta information om manifestet för den anpassade resursprovidern använder du cmdleten Get-AzCustomProvider enligt följande exempel.

Azure PowerShell 
Get-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type | Format-List

Skapa en association

Om du vill skapa eller uppdatera en association använder du cmdleten New-AzCustomProviderAssociation enligt följande exempel.

Azure PowerShell 
$provider = Get-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type
New-AzCustomProviderAssociation -Scope $resourceId -Name MyAssoc -TargetResourceId $provider.Id

Hämta en association

Om du vill hämta information om en association använder du cmdleten Get-AzCustomProviderAssociation enligt följande exempel.

Azure PowerShell 
Get-AzCustomProviderAssociation -Scope $resourceId -Name MyAssoc

Rensa resurser

Om resurserna som skapas i den här artikeln inte behövs kan du ta bort dem genom att köra följande exempel.

Ta bort en association

Om du vill ta bort en association använder du cmdleten Remove-AzCustomProviderAssociation . I följande exempel tas en association bort.

Azure PowerShell 
Remove-AzCustomProviderAssociation -Scope $id -Name Namespace.Type

Ta bort en anpassad resursprovider

Om du vill ta bort en anpassad resursprovider använder du cmdleten Remove-AzCustomProvider . I följande exempel tas en anpassad resursprovider bort.

Azure PowerShell 
Remove-AzCustomProvider -ResourceGroupName myResourceGroup -Name Namespace.Type

Ta bort resursgruppen

Varning

I följande exempel tas den angivna resursgruppen och alla resurser som ingår i den bort. Om det finns resurser utanför omfånget för den här artikeln i den angivna resursgruppen tas de också bort.

Azure PowerShell 
Remove-AzResourceGroup -Name myResourceGroup

Nästa steg

Läs mer om anpassade Azure-resursprovidrar.