Importieren und Exportieren von Blaupausendefinitionen mit PowerShell

  • Artikel

Wichtig

Am 11. Juli 2026 läuft Blueprints (Vorschau) aus. Migrieren Sie Ihre vorhandenen Blaupausendefinitionen und -zuweisungen zu Vorlagenspezifikationen und Bereitstellungsstapeln. Blaupausenartefakte müssen in ARM-JSON-Vorlagen oder Bicep-Dateien konvertiert werden, die zum Definieren von Bereitstellungsstapeln verwendet werden. Informationen zum Erstellen eines Artefakts als ARM-Ressource finden Sie unter:

Azure Blueprints kann vollständig über das Azure-Portal verwaltet werden. Mit dem fortschreitenden Einsatz von Azure Blueprints sollten Organisationen damit beginnen, Blaupausendefinitionen als verwalteten Code zu betrachten. Dieses Konzept wird häufig als Infrastructure-as-Code (IaC) bezeichnet. Das Behandeln von Blaupausendefinitionen als Code bietet Vorteile, die über die Möglichkeiten im Azure-Portal hinausgehen. Zu diesen Vorteilen zählen:

  • Freigeben von Blaupausendefinitionen
  • Sichern von Blaupausendefinitionen
  • Wiederverwenden von Blaupausendefinitionen für verschiedene Mandanten oder Abonnements
  • Übernehmen von Blaupausendefinitionen in die Quellcodeverwaltung
    • Automatisches Testen von Blaupausendefinitionen in Testumgebungen
    • Unterstützung von Continuous Integration- und Continuous Deployment-Pipelines (CI/CD)

Ungeachtet Ihrer Gründe bietet die Verwaltung von Blaupausendefinitionen als Code stets Vorteile. In diesem Artikel wird gezeigt, wie Sie im Modul AZ.Blueprint die Befehle Import-AzBlueprintWithArtifact und Export-AzBlueprintWithArtifact verwenden.

Voraussetzungen

In diesem Artikel wird davon ausgegangen, dass Sie über angemessene Grundkenntnisse von Azure Blueprints verfügen. Arbeiten Sie, falls noch nicht geschehen, folgende Artikel durch:

Falls das Modul AZ.Blueprint nicht bereits installiert ist, befolgen Sie die Anweisungen unter Hinzufügen des Moduls „AZ.Blueprint“, um das Modul aus dem PowerShell-Katalog zu installieren und zu überprüfen.

Ordnerstruktur einer Blaupausendefinition

Bevor wir uns mit dem Exportieren und Importieren von Blaupausen befassen, sehen wir uns an, wie die Dateien strukturiert sind, aus denen die Blaupausendefinition besteht. Eine Blaupausendefinition sollte in einem eigenen Ordner gespeichert werden.

Wichtig

Wird an den Parameter Name des Cmdlets Import-AzBlueprintWithArtifact kein Wert übergeben, wird der Name des Ordners verwendet, in dem die Blaupausendefinition gespeichert ist.

Neben der Blaupausendefinition, die den Namen blueprint.json erhalten muss, gibt es die Artefakte, aus denen sich die Blaupausendefinition zusammensetzt. Jedes Artefakt muss sich im Unterordner namens artifacts befinden. Insgesamt sollte die Struktur Ihrer Blaupausendefinition als JSON-Dateien in Ordnern wie folgt aussehen:

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

Exportieren der Blaupausendefinition

Die Schritte zum Exportieren Ihrer Blaupausendefinition sind ganz einfach. Das Exportieren von Blaupausendefinitionen kann nützlich sein, um diese freizugeben, zu sichern oder in die Quellcodeverwaltung zu übernehmen.

  • Blaupause [erforderlich]
    • Gibt die Blaupausendefinition an.
    • Verwenden Sie Get-AzBlueprint, um das Verweisobjekt abzurufen.
  • OutputPath [erforderlich]
    • Gibt den Pfad an, in dem die JSON-Dateien der Blaupausendefinition gespeichert werden sollen.
    • Die Ausgabedateien befinden sich in einem Unterordner mit dem Namen der Blaupausendefinition.
  • Version (optional)
    • Gibt die Version an, die ausgegeben werden soll, wenn das Verweisobjekt Blueprint Verweise auf mehr als eine Version enthält.

  1. Rufen Sie einen Verweis auf die Blaupausendefinition ab, die aus dem als {subId} dargestellten Abonnement exportiert werden soll:

    # 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. Verwenden Sie das Cmdlet Export-AzBlueprintWithArtifact, um die angegebene Blaupausendefinition zu exportieren:

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

Importieren der Blaupausendefinition

Wenn Sie entweder eine exportierte Blaupausendefinition oder eine manuell erstellte Blaupausendefinition in der erforderlichen Ordnerstruktur haben, können Sie diese Blaupausendefinition in eine andere Verwaltungsgruppe oder ein anderes Abonnement importieren.

Beispiele für integrierte Blaupausendefinitionen finden Sie im GitHub-Repository „Azure Blueprints“.

  • Name [erforderlich]
    • Gibt den Namen für die neue Blaupausendefinition an.
  • InputPath [erforderlich]
  • ManagementGroupId (optional)
    • Die Verwaltungsgruppen-ID, unter der die Blaupausendefinition gespeichert werden soll, wenn nicht der Standardwert für den aktuellen Kontext verwendet wird.
    • Angegeben werden muss entweder ManagementGroupId oder SubscriptionID.
  • SubscriptionId (optional)
    • Die ID des Abonnements, in dem die Blaupausendefinition gespeichert werden soll, wenn nicht der Standardwert für den aktuellen Kontext verwendet wird.
    • Angegeben werden muss entweder ManagementGroupId oder SubscriptionID.

  1. Verwenden Sie das Cmdlet Import-AzBlueprintWithArtifact, um die angegebene Blaupausendefinition zu importieren:

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

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

Nach dem Import der Blaupausendefinition weisen Sie sie mit PowerShell zu.

Informationen zum Erstellen erweiterter Blaupausendefinitionen finden Sie in den folgenden Artikeln:

Nächste Schritte