Blauwdrukdefinities importeren en exporteren met PowerShell

  • Artikel

Belangrijk

Op 11 juli 2026 worden blauwdrukken (preview) afgeschaft. Migreer uw bestaande blauwdrukdefinities en -toewijzingen naar sjabloonspecificaties en implementatiestacks. Blauwdrukartefacten moeten worden geconverteerd naar ARM JSON-sjablonen of Bicep-bestanden die worden gebruikt om implementatiestacks te definiëren. Zie voor meer informatie over het ontwerpen van een artefact als een ARM-resource:

Azure Blueprints kunnen volledig worden beheerd via Azure Portal. Naarmate organisaties verdergaan met het gebruik van Azure Blueprints, moeten ze blauwdrukdefinities gaan zien als beheerde code. Dit concept wordt vaak aangeduid als Infrastructuur als Code (IaC). Het behandelen van uw blauwdrukdefinities als code biedt meer voordelen dan wat Azure Portal biedt. Dit zijn enkele voordelen:

  • Blauwdrukdefinities delen
  • Een back-up maken van uw blauwdrukdefinities
  • Blauwdrukdefinities in verschillende tenants of abonnementen opnieuw gebruiken
  • De blauwdrukdefinities in broncodebeheer plaatsen
    • Geautomatiseerd testen van blauwdrukdefinities in testomgevingen
    • Ondersteuning van CI/CD-pijplijnen (continue integratie en continue implementatie)

Wat uw redenen ook zijn, het beheren van uw blauwdrukdefinities als code heeft voordelen. In dit artikel leest u hoe u de Import-AzBlueprintWithArtifact opdrachten en Export-AzBlueprintWithArtifact gebruikt in de module Az.Blueprint .

Vereisten

In dit artikel wordt ervan uitgegaan dat u een gematigde werkkennis van Azure Blueprints hebt. Als u dit nog niet hebt gedaan, leest u de volgende artikelen:

Als deze nog niet is geïnstalleerd, volgt u de instructies in De module Az.Blueprint toevoegen om de module Az.Blueprint van de PowerShell Gallery te installeren en te valideren.

Mapstructuur van een blauwdrukdefinitie

Voordat we gaan kijken naar het exporteren en importeren van blauwdrukken, gaan we kijken hoe de bestanden waaruit de blauwdrukdefinitie bestaat, zijn gestructureerd. Een blauwdrukdefinitie moet worden opgeslagen in een eigen map.

Belangrijk

Als er geen waarde wordt doorgegeven aan de parameter Name van de Import-AzBlueprintWithArtifact cmdlet, wordt de naam gebruikt van de map waarin de blauwdrukdefinitie is opgeslagen.

Samen met de blauwdrukdefinitie, die de naam blueprint.jsonmoet hebben, zijn de artefacten waaruit de blauwdrukdefinitie bestaat. Elk artefact moet zich in de submap met de naam bevinden artifacts. De structuur van uw blauwdrukdefinitie als JSON-bestanden in mappen moet er als volgt uitzien:

.
|
|- MyBlueprint/  _______________ # Root folder name becomes default name of blueprint definition
|  |- blueprint.json  __________ # The blueprint definition. Fixed name.
|
|  |- artifacts/  ______________ # Subfolder for all blueprint artifacts. Fixed name.
|     |- artifact.json  ________ # Blueprint artifact as JSON file. Artifact named from file.
|     |- ...
|     |- more-artifacts.json

De blauwdrukdefinitie exporteren

De stappen voor het exporteren van uw blauwdrukdefinitie zijn eenvoudig. Het exporteren van de blauwdrukdefinitie kan handig zijn voor het delen, maken van back-ups of plaatsen in broncodebeheer.

  • Blauwdruk [vereist]
    • Hiermee geeft u de blauwdrukdefinitie op
    • Gebruik Get-AzBlueprint om het referentieobject op te halen
  • OutputPath [vereist]
    • Hiermee geeft u het pad op om de JSON-bestanden van de blauwdrukdefinitie op te slaan in
    • De uitvoerbestanden bevinden zich in een submap met de naam van de blauwdrukdefinitie
  • Versie (optioneel)
    • Hiermee geeft u de versie op die moet worden uitgevoerd als het blauwdrukverwijzingsobject verwijzingen naar meer dan één versie bevat.

  1. Haal een verwijzing op naar de blauwdrukdefinitie die u wilt exporteren vanuit het abonnement, weergegeven als {subId}:

    # Login first with Connect-AzAccount if not using Cloud Shell

# Get version '1.1' of the blueprint definition in the specified subscription
$bpDefinition = Get-AzBlueprint -SubscriptionId '{subId}' -Name 'MyBlueprint' -Version '1.1'

  2. Gebruik de Export-AzBlueprintWithArtifact cmdlet om de opgegeven blauwdrukdefinitie te exporteren:

    Export-AzBlueprintWithArtifact -Blueprint $bpDefinition -OutputPath 'C:\Blueprints'

De blauwdrukdefinitie importeren

Zodra u een geëxporteerde blauwdrukdefinitie hebt of een handmatig gemaakte blauwdrukdefinitie in de vereiste mapstructuur hebt, kunt u die blauwdrukdefinitie importeren in een andere beheergroep of een ander abonnement.

Zie de Azure Blueprints GitHub-opslagplaats voor voorbeelden van ingebouwde blauwdrukdefinities.

  • Naam [vereist]
    • Hiermee geeft u de naam voor de nieuwe blauwdrukdefinitie op
  • InputPath [vereist]
    • Hiermee geeft u het pad op voor het maken van de blauwdrukdefinitie van
    • Moet overeenkomen met de vereiste mapstructuur
  • ManagementGroupId (optioneel)
    • De beheergroep-id om de blauwdrukdefinitie op te slaan in, indien niet de huidige context
    • ManagementGroupId of SubscriptionId moet worden opgegeven
  • SubscriptionId (optioneel)
    • De abonnements-id om de blauwdrukdefinitie op te slaan in, indien niet de huidige standaardcontext
    • ManagementGroupId of SubscriptionId moet worden opgegeven

  1. Gebruik de Import-AzBlueprintWithArtifact cmdlet om de opgegeven blauwdrukdefinitie te importeren:

    # Login first with Connect-AzAccount if not using Cloud Shell

Import-AzBlueprintWithArtifact -Name 'MyBlueprint' -ManagementGroupId 'DevMG' -InputPath 'C:\Blueprints\MyBlueprint'

Zodra de blauwdrukdefinitie is geïmporteerd, wijst u deze toe met PowerShell.

Zie de volgende artikelen voor informatie over het maken van geavanceerde blauwdrukdefinities:

Volgende stappen