Importowanie i eksportowanie definicji strategii za pomocą programu PowerShell

  • Artykuł

Ważne

11 lipca 2026 r. usługa Blueprints (wersja zapoznawcza) zostanie wycofana. Migrowanie istniejących definicji strategii i przypisań do specyfikacji szablonu i stosów wdrażania. Artefakty strategii mają być konwertowane na szablony JSON usługi ARM lub pliki Bicep używane do definiowania stosów wdrażania. Aby dowiedzieć się, jak utworzyć artefakt jako zasób usługi ARM, zobacz:

Usługa Azure Blueprints może być w pełni zarządzana za pośrednictwem Azure Portal. W miarę postępu organizacji w korzystaniu z usługi Azure Blueprints powinni zacząć myśleć o definicjach strategii jako kodu zarządzanego. Ta koncepcja jest często określana jako infrastruktura jako kod (IaC). Traktowanie definicji strategii jako kodu zapewnia dodatkowe korzyści poza ofertami Azure Portal. Te korzyści obejmują między innymi:

  • Udostępnianie definicji strategii
  • Tworzenie kopii zapasowych definicji strategii
  • Ponowne użycie definicji strategii w różnych dzierżawach lub subskrypcjach
  • Umieszczanie definicji strategii w kontroli źródła
    • Zautomatyzowane testowanie definicji strategii w środowiskach testowych
    • Obsługa potoków ciągłej integracji i ciągłego wdrażania (CI/CD)

Niezależnie od powodów zarządzanie definicjami strategii jako kodem przynosi korzyści. W tym artykule pokazano, jak używać Import-AzBlueprintWithArtifact poleceń i Export-AzBlueprintWithArtifact w module Az.Blueprint .

Wymagania wstępne

W tym artykule przyjęto założenie, że średnio działa wiedza na temat usługi Azure Blueprints. Jeśli jeszcze tego nie zrobiono, zapoznaj się z następującymi artykułami:

Jeśli jeszcze go nie zainstalowano, postępuj zgodnie z instrukcjami w temacie Dodawanie modułu Az.Blueprint, aby zainstalować i zweryfikować moduł Az.Blueprint z Galeria programu PowerShell.

Struktura folderów definicji strategii

Przed rozpoczęciem eksportowania i importowania strategii przyjrzyjmy się strukturze plików tworzących definicję strategii. Definicja strategii powinna być przechowywana we własnym folderze.

Ważne

Jeśli do parametru Import-AzBlueprintWithArtifactName polecenia cmdlet nie zostanie przekazana żadna wartość, używana jest nazwa folderu, w której jest przechowywana definicja strategii.

Wraz z definicją strategii, która musi mieć nazwę blueprint.json, są artefaktami, które składają się z definicji strategii. Każdy artefakt musi znajdować się w podfolderze o nazwie artifacts. Po połączeniu struktura definicji strategii jako pliki JSON w folderach powinna wyglądać następująco:

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

Eksportowanie definicji strategii

Kroki eksportowania definicji strategii są proste. Eksportowanie definicji strategii może być przydatne do udostępniania, tworzenia kopii zapasowych lub umieszczania w kontroli źródła.

  • Strategia [wymagana]
    • Określa definicję strategii
    • Użyj Get-AzBlueprint polecenia , aby uzyskać obiekt referencyjny
  • OutputPath [required]
    • Określa ścieżkę do zapisania plików JSON definicji strategii
    • Pliki wyjściowe znajdują się w podfolderze o nazwie definicji strategii
  • Wersja (opcjonalnie)
    • Określa wersję do danych wyjściowych, jeśli obiekt referencyjny strategii zawiera odwołania do więcej niż jednej wersji.

  1. Pobierz odwołanie do definicji strategii w celu wyeksportowania z subskrypcji reprezentowanej 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. Export-AzBlueprintWithArtifact Użyj polecenia cmdlet , aby wyeksportować określoną definicję strategii:

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

Importowanie definicji strategii

Po utworzeniu wyeksportowanej definicji strategii lub ręcznie utworzonej definicji strategii w wymaganej strukturze folderów możesz zaimportować ją do innej grupy zarządzania lub subskrypcji.

Przykłady wbudowanych definicji strategii można znaleźć w repozytorium GitHub usługi Azure Blueprints.

  • Nazwa [wymagane]
    • Określa nazwę nowej definicji strategii
  • InputPath [wymagane]
  • ManagementGroupId (opcjonalnie)
    • Identyfikator grupy zarządzania, aby zapisać definicję strategii, jeśli nie jest to bieżący kontekst domyślny
    • Należy określić wartość ManagementGroupId lub SubscriptionId .
  • SubscriptionId (opcjonalnie)
    • Identyfikator subskrypcji do zapisania definicji strategii, jeśli nie jest to ustawienie domyślne bieżącego kontekstu
    • Należy określić wartość ManagementGroupId lub SubscriptionId .

  1. Import-AzBlueprintWithArtifact Za pomocą polecenia cmdlet zaimportuj określoną definicję strategii:

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

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

Po zaimportowaniu definicji strategii przypisz ją za pomocą programu PowerShell.

Aby uzyskać informacje na temat tworzenia zaawansowanych definicji strategii, zobacz następujące artykuły:

Następne kroki