Een Azure Portal gebruiken om een sjabloon te exporteren

Artikel
09/03/2021
5 minuten om te lezen

Als hulp bij het maken Azure Resource Manager sjablonen, kunt u een sjabloon exporteren uit bestaande resources. De geëxporteerde sjabloon helpt u inzicht te krijgen in de JSON-syntaxis en eigenschappen waarmee uw resources worden geïmplementeerd. Als u toekomstige implementaties wilt automatiseren, begint u met de geëxporteerde sjabloon en wijzigt u deze voor uw scenario.

Resource Manager kunt u een of meer resources kiezen voor het exporteren naar een sjabloon. U kunt zich richten op de resources die u nodig hebt in de sjabloon.

In dit artikel wordt beschreven hoe u sjablonen exporteert via de portal. Zie voor andere opties:

De juiste exportoptie kiezen

Er zijn twee manieren om een sjabloon te exporteren:

Export vanuit de resourcegroep of resource. Met deze optie wordt een nieuwe sjabloon gegenereerd op basis van bestaande resources. De geëxporteerde sjabloon is een 'momentopname' van de huidige status van de resourcegroep. U kunt een volledige resourcegroep of specifieke resources binnen die resourcegroep exporteren.
Sla op uit de geschiedenis. Met deze optie wordt een exacte kopie opgehaald van een sjabloon die wordt gebruikt voor implementatie. U geeft de implementatie op uit de implementatiegeschiedenis.

Afhankelijk van de optie die u kiest, hebben de geëxporteerde sjablonen verschillende eigenschappen.

Vanuit resourcegroep of resource	Vanuit de geschiedenis
Sjabloon wordt automatisch gegenereerd. Waarschijnlijk wilt u de code verbeteren voordat u deze implementeert.	Sjabloon is een exacte kopie van de kopie die is gemaakt door de auteur van de sjabloon. Het is klaar om opnieuw te worden geïmplementeerd zonder wijzigingen.
Sjabloon is een momentopname van de huidige status van de resources. Het bevat alle handmatige wijzigingen die u na de implementatie hebt aangebracht.	Sjabloon toont alleen de status van resources op het moment van implementatie. Handmatige wijzigingen die u na de implementatie hebt aangebracht, worden niet opgenomen.
U kunt selecteren welke resources uit een resourcegroep u wilt exporteren.	Alle resources voor een specifieke implementatie zijn opgenomen. U kunt geen subset van deze resources kiezen of resources toevoegen die op een ander moment zijn toegevoegd.
De sjabloon bevat alle eigenschappen voor de resources, inclusief enkele eigenschappen die u normaal gesproken niet zou instellen tijdens de implementatie. Mogelijk wilt u deze eigenschappen verwijderen of ops schonen voordat u de sjabloon opnieuw gebruikt.	De sjabloon bevat alleen de eigenschappen die nodig zijn voor de implementatie. De sjabloon is verspreider en gemakkelijker te lezen.
De sjabloon bevat waarschijnlijk niet alle parameters die u nodig hebt voor hergebruik. De meeste eigenschapswaarden zijn in code in de sjabloon gecodeerd. Als u de sjabloon opnieuw wilt toepassen in andere omgevingen, moet u parameters toevoegen die de mogelijkheid om de resources te configureren vergroten. U kunt de selectie van Include-parameters ongedaan maken, zodat u uw eigen parameters kunt maken.	De sjabloon bevat parameters die het eenvoudig maken om opnieuw te wordenploy in verschillende omgevingen.

Exporteert de sjabloon vanuit een resourcegroep of resource, wanneer:

U moet wijzigingen vastleggen in de resources die zijn aangebracht na de oorspronkelijke implementatie.
U wilt selecteren welke resources worden geëxporteerd.
De resources zijn niet gemaakt met een sjabloon.

Exporteert de sjabloon uit de geschiedenis wanneer:

U wilt een sjabloon die eenvoudig opnieuw kan worden gebruikt.
U hoeft geen wijzigingen op te nemen die u hebt aangebracht na de oorspronkelijke implementatie.

Beperkingen

Bij het exporteren vanuit een resourcegroep of resource wordt de geëxporteerde sjabloon gegenereerd op basis van de gepubliceerde schema's voor elk resourcetype. Af en toe heeft het schema niet de nieuwste versie voor een resourcetype. Controleer de geëxporteerde sjabloon om te controleren of deze de eigenschappen bevat die u nodig hebt. Bewerk indien nodig de geëxporteerde sjabloon om de api-versie te gebruiken die u nodig hebt.

De exportsjabloonfunctie biedt geen ondersteuning voor het exporteren Azure Data Factory resources. Zie Een data factory kopiëren of klonen in Azure Data Factory voor meer informatie over het exporteren van Data Factory resources.

Als u resources wilt exporteren die zijn gemaakt via het klassieke implementatiemodel, moet u ze migreren naar Resource Manager implementatiemodel.

Als u een waarschuwing krijgt bij het exporteren van een sjabloon die aangeeft dat een resourcetype niet is geëxporteerd, kunt u nog steeds de eigenschappen voor die resource vinden. Zie sjabloonverwijzing voor resource-eigenschappen. U kunt ook de Azure-REST API voor het resourcetype.

Er is een limiet van 200 resources in de resourcegroep waar u de geëxporteerde sjabloon voor maakt. Als u probeert een resourcegroep met meer dan 200 resources te exporteren, wordt het Export template is not supported for resource groups more than 200 resources foutbericht weergegeven.

Sjabloon exporteren vanuit een resourcegroep

Een of meer resources uit een resourcegroep exporteren:

Selecteer de resourcegroep die de resources bevat die u wilt exporteren.
Selecteer een of meer resources door de selectievakjes in te selecteren. Als u alles wilt selecteren, selecteert u het selectievakje aan de linkerkant van Naam. Het menu-item Sjabloon exporteren wordt alleen ingeschakeld nadat u ten minste één resource hebt geselecteerd.

Op de schermopname is alleen het opslagaccount geselecteerd.
Selecteer Sjabloon exporteren.
De geëxporteerde sjabloon wordt weergegeven en kan worden gedownload en geïmplementeerd.

Parameters opnemen is standaard geselecteerd. Wanneer u deze optie selecteert, worden alle sjabloonparameters opgenomen wanneer de sjabloon wordt gegenereerd. Als u uw eigen parameters wilt maken, schakelt u dit selectievakje in om ze niet op te nemen.

Sjabloon exporteren vanuit een resource

Eén resource exporteren:

Selecteer de resourcegroep met de resource die u wilt exporteren.
Selecteer de resource die u wilt exporteren om de resource te openen.
Voor die resource selecteert u Sjabloon exporteren in het linkerdeelvenster.
De geëxporteerde sjabloon wordt weergegeven en kan worden gedownload en geïmplementeerd. De sjabloon bevat slechts één resource. Parameters opnemen is standaard geselecteerd. Wanneer u deze optie selecteert, worden alle sjabloonparameters opgenomen wanneer de sjabloon wordt gegenereerd. Als u uw eigen parameters wilt maken, schakelt u dit selectievakje in om ze niet op te nemen.

Sjabloon downloaden vóór implementatie

In de portal kunt u een sjabloon downloaden voordat u deze implementeert. Deze optie is niet beschikbaar via PowerShell of Azure CLI.

Selecteer de Azure-service die u wilt implementeren.
Vul de waarden voor de nieuwe service in.
Nadat de validatie is uitgevoerd, maar voordat u met de implementatie begint, selecteert u Een sjabloon voor automatisering downloaden.
De sjabloon wordt weergegeven en kan worden gedownload en geïmplementeerd.

Sjabloon exporteren na implementatie

U kunt de sjabloon exporteren die is gebruikt voor het implementeren van bestaande resources. De sjabloon die u krijgt, is precies de sjabloon die is gebruikt voor implementatie.

Selecteer de resourcegroep die u wilt exporteren.
Selecteer de koppeling onder Implementaties.
Selecteer een van de implementaties uit de implementatiegeschiedenis.
Selecteer Sjabloon. De sjabloon die voor deze implementatie wordt gebruikt, wordt weergegeven en kan worden gedownload.

Volgende stappen

Meer informatie over het exporteren van sjablonen met Azure CLI, Azure PowerShellof REST API.
Zie Understand the structure and syntax of Resource Manager Azure Resource Manager templates (Inzicht in de structuur en syntaxis van Azure Resource Manager sjablonen) voor meer informatie over Azure Resource Manager sjabloonsyntaxis.
Zie de stapsgewijs zelfstudies voor meer informatie over het ontwikkelen van sjablonen.