Import a export definic podrobných plánů pomocí PowerShellu

  • Článek

Důležité

11. července 2026 budou podrobné plány (Preview) zastaralé. Migrujte existující definice a přiřazení podrobných plánů do specifikací šablon a zásobníků nasazení. Artefakty podrobného plánu se mají převést na šablony JSON ARM nebo soubory Bicep, které se používají k definování zásobníků nasazení. Informace o tom, jak vytvořit artefakt jako prostředek ARM, najdete tady:

Azure Blueprints je možné plně spravovat prostřednictvím Azure Portal. S tím, jak organizace postupují v používání Azure Blueprints, by měly začít uvažovat o definicích podrobných plánů jako o spravovaném kódu. Tento koncept se často označuje jako infrastruktura jako kód (IaC). Zacházení s definicemi podrobného plánu jako s kódem nabízí další výhody nad rámec toho, co nabízí Azure Portal. Mezi tyto výhody patří:

  • Sdílení definic podrobných plánů
  • Zálohování definic podrobného plánu
  • Opakované nasazení definic podrobných plánů v různých tenantech nebo předplatných
  • Umístění definic podrobného plánu do správy zdrojového kódu
    • Automatizované testování definic podrobného plánu v testovacích prostředích
    • Podpora kanálů kontinuální integrace a průběžného nasazování (CI/CD)

Bez ohledu na vaše důvody má správa definic podrobného plánu jako kódu výhody. Tento článek ukazuje, jak používat Import-AzBlueprintWithArtifact příkazy a Export-AzBlueprintWithArtifact v modulu Az.Blueprint .

Požadavky

Tento článek předpokládá středně dobré znalosti azure Blueprints. Pokud jste to ještě neudělali, projděte si následující články:

Pokud ještě není nainstalovaný, podle pokynů v tématu Přidání modulu Az.Blueprint nainstalujte a ověřte modul Az.Blueprint z Galerie prostředí PowerShell.

Struktura složek definice podrobného plánu

Než se podíváme na export a import podrobných plánů, podívejme se, jak jsou strukturovány soubory, které tvoří definici podrobného plánu. Definice podrobného plánu by měla být uložena ve vlastní složce.

Důležité

Pokud parametru Name rutiny Import-AzBlueprintWithArtifact není předána žádná hodnota, použije se název složky, ve které je uložená definice podrobného plánu.

Spolu s definicí podrobného plánu, která musí mít název blueprint.json, jsou artefakty, ze kterých se definice podrobného plánu skládá. Každý artefakt musí být v podsložce s názvem artifacts. Struktura definice podrobného plánu jako souborů JSON ve složkách by měla vypadat takto:

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

Export definice podrobného plánu

Postup exportu definice podrobného plánu je jednoduchý. Export definice podrobného plánu může být užitečný pro sdílení, zálohování nebo umístění do správy zdrojového kódu.

  • Podrobný plán [povinný]
    • Určuje definici podrobného plánu.
    • Slouží k získání referenčního objektu.Get-AzBlueprint
  • OutputPath [povinné]
    • Určuje cestu, do které se mají uložit soubory JSON definice podrobného plánu.
    • Výstupní soubory jsou v podsložce s názvem definice podrobného plánu.
  • Verze (volitelné)
    • Určuje verzi pro výstup, pokud referenční objekt podrobného plánu obsahuje odkazy na více než jednu verzi.

  1. Získejte odkaz na definici podrobného plánu, která se má exportovat z předplatného reprezentované jako {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. Pomocí rutiny Export-AzBlueprintWithArtifact exportujte zadanou definici podrobného plánu:

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

Import definice podrobného plánu

Jakmile máte exportovanou definici podrobného plánu nebo máte ručně vytvořenou definici podrobného plánu v požadované struktuře složek, můžete tuto definici podrobného plánu importovat do jiné skupiny pro správu nebo předplatného.

Příklady předdefinovaných definic podrobných plánů najdete v úložišti Azure Blueprints na GitHubu.

  • Název [povinné]
    • Určuje název definice nového podrobného plánu.
  • InputPath [povinné]
  • ManagementGroupId (volitelné)
    • ID skupiny pro správu pro uložení definice podrobného plánu do aktuálního výchozího kontextu
    • Musí být zadáno Id skupiny správy nebo ID předplatného .
  • Id předplatného (volitelné)
    • ID předplatného pro uložení definice podrobného plánu do aktuálního výchozího kontextu
    • Musí být zadáno Id skupiny správy nebo ID předplatného .

  1. Pomocí rutiny Import-AzBlueprintWithArtifact naimportujte zadanou definici podrobného plánu:

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

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

Po importu definice podrobného plánu ji přiřaďte pomocí PowerShellu.

Informace o vytváření pokročilých definic podrobných plánů najdete v následujících článcích:

Další kroky