Mengimpor dan mengekspor definisi cetak biru dengan PowerShell

Penting

Pada 11 Juli 2026, Cetak Biru (Pratinjau) tidak akan digunakan lagi. Migrasikan definisi dan penugasan cetak biru yang ada ke Spesifikasi Templat dan Tumpukan Penyebaran. Artefak cetak biru akan dikonversi ke templat ARM JSON atau file Bicep yang digunakan untuk menentukan tumpukan penyebaran. Untuk mempelajari cara menulis artefak sebagai sumber daya ARM, lihat:

Azure Blueprints dapat dikelola sepenuhnya melalui portal Microsoft Azure. Ketika organisasi melangkah maju dalam penggunaan Azure Blueprints, mereka harus mulai memikirkan definisi cetak biru sebagai kode terkelola. Konsep ini sering disebut sebagai Infrastructure as Code (IAC). Memperlakukan definisi cetak biru Anda sebagai kode menawarkan keuntungan tambahan di luar apa yang ditawarkan portal Microsoft Azure. Manfaat ini mencakup:

  • Berbagi definisi blueprint
  • Mencadangkan definisi cetak biru Anda
  • Menggunakan kembali definisi cetak biru di penyewa atau langganan yang berbeda
  • Menempatkan definisi cetak biru dalam kontrol sumber
    • Pengujian definisi cetak biru otomatis di lingkungan pengujian
    • Dukungan integrasi berkelanjutan dan saluran penyebaran berkelanjutan (CI/CD)

Apa pun alasan Anda, mengelola definisi cetak biru Anda sebagai kode memiliki manfaat. Artikel ini memperlihatkan cara menggunakan perintah Import-AzBlueprintWithArtifact dan Export-AzBlueprintWithArtifact dalam modul Az.Blueprint.

Prasyarat

Artikel ini mengasumsikan pengetahuan kerja moderat tentang Azure Blueprints. Jika Anda belum melakukannya, kerjakan artikel berikut ini:

Jika belum diinstal, ikuti instruksi di modul Tambahkan Az.Blueprint untuk menginstal dan memvalidasi modul Az.Blueprint dari Galeri PowerShell.

Struktur folder dari definisi cetak biru

Sebelum melihat mengekspor dan mengimpor cetak biru, mari kita lihat bagaimana file yang membentuk definisi cetak biru disusun. Definisi cetak biru harus disimpan di foldernya sendiri.

Penting

Jika tidak ada nilai yang diteruskan ke parameter Nama dari cmdlet Import-AzBlueprintWithArtifact, nama folder yang disimpan dalam definisi cetak biru akan digunakan.

Seiring dengan definisi cetak biru, yang harus diberi nama blueprint.json, adalah artefak yang membentuk definisi cetak biru. Setiap artefak harus berada di subfolder bernama artifacts. Saat disatukan, struktur definisi cetak biru Anda sebagai file JSON dalam folder harus terlihat sebagai berikut:

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

Mengekspor definisi cetak biru Anda

Langkah-langkah untuk mengekspor definisi cetak biru Anda sangat mudah. Mengekspor definisi cetak biru dapat berguna untuk berbagi, mencadangkan, atau menempatkan ke dalam kontrol sumber.

  • Cetak biru [diperlukan]
    • Menetapkan definisi cetak biru
    • Gunakan Get-AzBlueprint untuk mendapat objek referensi
  • OutputPath [diperlukan]
    • Menentukan jalur untuk menyimpan berkas JSON definisi cetak biru
    • File keluaran berada dalam subfolder dengan nama definisi cetak biru
  • Versi (opsional)
    • Menentukan versi yang akan dihasilkan jika objek referensi Blueprint berisi referensi ke lebih dari satu versi.
  1. Dapatkan referensi ke definisi cetak biru untuk diekspor dari langganan yang dinyatakan sebagai {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. Gunakan cmdlet Export-AzBlueprintWithArtifact untuk mengekspor definisi cetak biru yang ditentukan:

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

Mengekspor definisi cetak biru Anda

Setelah Anda memiliki definisi cetak biru yang diekspor atau memiliki definisi cetak biru yang dibuat secara manual dalam struktur folder yang diperlukan, Anda dapat mengimpor definisi cetak biru itu ke grup manajemen atau langganan yang berbeda.

Untuk contoh definisi blueprint bawaan, lihat repositori GitHub Azure Blueprints.

  • Nama [diperlukan]
    • Menentukan nama untuk definisi cetak biru baru
  • InputPath [diperlukan]
  • ManagementGroupId (opsional)
    • ID grup manajemen untuk menyimpan definisi cetak biru jika bukan default konteks saat ini
    • ManagementGroupId atau SubscriptionId harus ditentukan
  • SubscriptionId (opsional)
    • ID grup langganan untuk menyimpan definisi cetak biru jika bukan default konteks saat ini
    • ManagementGroupId atau SubscriptionId harus ditentukan
  1. Gunakan cmdlet Import-AzBlueprintWithArtifact untuk mengimpor definisi cetak biru yang ditentukan:

    # Login first with Connect-AzAccount if not using Cloud Shell
    
    Import-AzBlueprintWithArtifact -Name 'MyBlueprint' -ManagementGroupId 'DevMG' -InputPath 'C:\Blueprints\MyBlueprint'
    

Setelah definisi cetak biru diimpor, tetapkan dengan PowerShell.

Untuk informasi tentang membuat definisi cetak biru tingkat lanjut, lihat artikel berikut ini:

Langkah berikutnya