Blauwdrukdefinities importeren en exporteren met PowerShell

Important

Azure Blueprints (preview) wordt op 31 januari 2027 buiten gebruik gesteld met een gefaseerde buitengebruikstelling vanaf 31 juli 2026. Migreer uw bestaande blauwdrukdefinities en -toewijzingen naar implementatiestacks (aanbevolen) en sjabloonspecificaties. Blueprint-artefacten worden omgezet in ARM JSON-sjablonen of Bicep-bestanden die worden gebruikt om deploymentstacks te definiëren. Zie voor de volledige gefaseerde tijdlijn, impact en veelgestelde vragen Azure Blueprints buitengebruikstelling of https://aka.ms/AzureBlueprintsRetirement. Voor instructies over het opstellen van een artefact als een ARM-resource, zie:

Azure Blueprints kan volledig worden beheerd via Azure portal. Naarmate organisaties verdergaan met het gebruik van Azure Blueprints, moeten ze beginnen met het bedenken van blauwdrukdefinities als beheerde code. Dit concept wordt vaak aangeduid als Infrastructure as Code (IaC). Het behandelen van uw blauwdrukdefinities als code biedt extra voordelen dan wat Azure portal biedt. Dit zijn enkele voordelen:

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

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

Vereiste voorwaarden

In dit artikel wordt uitgegaan van een gematigde werkkennis van Azure Blueprints. Als u dit nog niet hebt gedaan, neem dan de volgende artikelen door:

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 u blauwdrukken exporteert en importeert, gaan we kijken hoe de bestanden waaruit de blauwdrukdefinitie bestaat, zijn gestructureerd. Een blauwdrukdefinitie moet worden opgeslagen in een eigen map.

Important

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

Samen met de blauwdrukdefinitie, die een naam blueprint.jsonmoet hebben, zijn de artefacten waarvan de blauwdrukdefinitie bestaat. Elk artefact moet zich in de submap met de naam artifactsbevinden. Samen moeten de structuur van uw blauwdrukdefinitie als JSON-bestanden in mappen 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

Uw blauwdrukdefinitie exporteren

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

  • Blauwdruk [vereist]
    • Hiermee geeft u de blauwdrukdefinitie op
    • Gebruiken Get-AzBlueprint om het referentieobject op te halen
  • OutputPath [vereist]
    • Hiermee geeft u het pad op waar de JSON-bestanden voor de blauwdrukdefinitie worden opgeslagen.
    • De uitvoerbestanden bevinden zich in een submap met de naam van de blauwdrukdefinitie
  • Versie (optioneel)
    • Hiermee wordt opgegeven welke versie moet worden weergegeven als het Blueprint-referentieobject verwijzingen naar meer dan één versie bevat.

  1. Haal een verwijzing naar de blauwdrukdefinitie op om te exporteren uit het abonnement dat wordt 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'

Uw blauwdrukdefinitie importeren

Zodra u een geëxporteerde blauwdrukdefinitie hebt of een handmatig gemaakte blauwdrukdefinitie hebt in de vereiste mapstructuur, 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
  • InputPath [vereist]
    • Hiermee geeft u het pad op waaruit de blauwdrukdefinitie moet worden gemaakt
    • Moet overeenkomen met de vereiste mapstructuur
  • ManagementGroupId (optioneel)
    • De id van de beheergroep waarin de blueprintdefinitie moet worden opgeslagen als dit niet de huidige standaardcontext is
    • ManagementGroupId of SubscriptionId moet worden opgegeven
  • SubscriptionId (optioneel)
    • De abonnements-id waarnaar de blauwdrukdefinitie moet worden opgeslagen als deze niet de huidige contextstandaard is
    • 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 meer informatie over het maken van geavanceerde blauwdrukdefinities:

Volgende stappen 

  • Last updated on