Tervdefiníciók importálása és exportálása a PowerShell-lel

  • Cikk

Fontos

2026. július 11-én a Tervek (előzetes verzió) elavult. Migrálja a meglévő tervdefiníciókat és -hozzárendeléseket sablonspecifikációkba és üzembehelyezési vermekbe. A tervösszetevőket ARM JSON-sablonokká vagy Bicep-fájlokká kell konvertálni, amelyek az üzembehelyezési vermek meghatározására szolgálnak. Ha meg szeretné tudni, hogyan hozhat létre összetevőt ARM-erőforrásként, tekintse meg az alábbiakat:

Az Azure Blueprints teljes mértékben felügyelhető Azure Portal keresztül. Ahogy a szervezetek előrelépnek az Azure Blueprints használatában, a tervdefiníciók felügyelt kódként való használatára kell gondolniuk. Ezt a fogalmat gyakran infrastruktúra, mint kód (IaC) néven is emlegetik. A tervdefiníciók kódként való kezelése további előnyöket kínál azon túl, amit Azure Portal kínál. Ilyen előnyök például a következők:

  • Tervdefiníciók megosztása
  • A tervdefiníciók biztonsági mentése
  • Tervdefiníciók újrafelhasználása különböző bérlőkben vagy előfizetésekben
  • A tervdefiníciók elhelyezése a verziókövetésben
    • Tervdefiníciók automatizált tesztelése tesztkörnyezetekben
    • Folyamatos integrációs és folyamatos üzembehelyezési (CI/CD) folyamatok támogatása

Bármi is az oka, a tervdefiníciók kódként való kezelése előnyökkel jár. Ez a cikk bemutatja, hogyan használható a és Export-AzBlueprintWithArtifact a Import-AzBlueprintWithArtifact parancs az Az.Blueprint modulban.

Előfeltételek

Ez a cikk az Azure Blueprints mérsékelt munkamódszerét feltételezi. Ha még nem tette meg, az alábbi cikkekben találhatja meg a következőket:

Ha még nincs telepítve, kövesse az Az.Blueprint modul hozzáadása című cikk utasításait az Az.Blueprint modul telepítéséhez és érvényesítéséhez a PowerShell-galéria.

Tervdefiníció mappaszerkezete

A tervek exportálása és importálása előtt nézzük meg, hogyan vannak strukturálva a tervdefiníciót alkotó fájlok. A tervdefiníciót a saját mappájában kell tárolni.

Fontos

Ha a rendszer nem ad át értéket a Import-AzBlueprintWithArtifact parancsmag Name paraméterének, a rendszer annak a mappának a nevét használja, amelyben a tervdefiníció található.

A tervdefiníció mellett , amelynek neve el kell nevezni blueprint.json, azok az összetevők, amelyekből a tervdefiníció áll. Minden összetevőnek a nevű artifactsalmappában kell lennie. A tervdefiníció JSON-fájlokként való struktúrájának a mappákban a következőképpen kell kinéznie:

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

Tervdefiníció exportálása

A tervdefiníció exportálásának lépései egyszerűek. A tervdefiníció exportálása hasznos lehet megosztáshoz, biztonsági mentéshez vagy a verziókövetésbe való helyezéshez.

  • Terv [kötelező]
    • Meghatározza a tervdefiníciót
    • A hivatkozási objektum lekérése a paranccsal Get-AzBlueprint
  • OutputPath [kötelező]
    • Megadja a tervdefiníció JSON-fájljainak mentési útvonalát
    • A kimeneti fájlok a tervdefiníció nevével rendelkező almappában találhatók
  • Verzió (nem kötelező)
    • Megadja a kimenet verzióját, ha a Terv referenciaobjektum több verzióra mutató hivatkozásokat tartalmaz.

  1. Az előfizetésből {subId}exportálandó tervdefinícióra mutató hivatkozás lekérése:

    # 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. Export-AzBlueprintWithArtifact A parancsmaggal exportálhatja a megadott tervdefiníciót:

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

Tervdefiníció importálása

Miután exportált tervdefinícióval rendelkezik, vagy manuálisan létrehozott tervdefinícióval rendelkezik a szükséges mappastruktúrában, importálhatja ezt a tervdefiníciót egy másik felügyeleti csoportba vagy előfizetésbe.

A beépített tervdefiníciókra példákat az Azure Blueprints GitHub-adattárban talál.

  • Név [kötelező]
    • Megadja az új tervdefiníció nevét
  • InputPath [kötelező]
  • ManagementGroupId (nem kötelező)
    • A felügyeleti csoport azonosítója a tervdefiníció mentéséhez, ha nem az aktuális környezet alapértelmezett értéke
    • Meg kell adni a ManagementGroupId vagy a SubscriptionId azonosítót
  • SubscriptionId (nem kötelező)
    • A tervdefiníció mentéséhez használt előfizetés-azonosító, ha nem az aktuális környezet alapértelmezett értéke
    • Meg kell adni a ManagementGroupId vagy a SubscriptionId azonosítót

  1. Import-AzBlueprintWithArtifact A parancsmaggal importálja a megadott tervdefiníciót:

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

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

A tervdefiníció importálása után rendelje hozzá a PowerShell-lel.

További információ a speciális tervdefiníciók létrehozásáról:

További lépések