مشاركة عبر

استيراد وتصدير تعريفات المخطط باستخدام PowerShell

  • مقالة

هام

في 11 يوليو 2026، سيتم إهمال المخططات (إصدار أولي). قم بترحيل تعريفات المخطط الحالي وتعييناته إلى مواصفات القالبومكدسات التوزيع. سيتم تحويل البيانات الاصطناعية للمخطط إلى قوالب ARM JSON أو ملفات Bicep المستخدمة لتعريف مكدسات التوزيع. لمعرفة كيفية تأليف أداة كمورد ARM، راجع:

يمكن إدارة Azure Blueprints بشكل كامل من خلال مدخل Microsoft Azure. مع تقدم المؤسسات في استخدامها لـ Azure Blueprints، يجب أن تبدأ في التفكير في تعريفات المخطط كتعليمة برمجية مدارة. غالباً ما يُشار إلى هذا المفهوم باسم البنية الأساسية كتعليمة برمجية (IaC). يوفر التعامل مع تعريفات المخطط كتعليمة برمجية مزايا إضافية تتجاوز ما يقدمه مدخل Microsoft Azure. تشمل هذه المزايا:

  • مشاركة تعريفات المخطط
  • النسخ الاحتياطي لتعريفات المخطط
  • إعادة استخدام تعريفات المخطط في مستأجرين أو اشتراكات مختلفة
  • وضع تعريفات المخطط في التحكم بالمصادر
    • الاختبار التلقائي لتعريفات المخطط في بيئات الاختبار
    • دعم مسارات المعالجة للتكامل المستمر والتوزيع المستمر (CI/CD)

مهما كانت أسبابك، فإن إدارة تعريفات المخطط كتعليمة برمجية لها ميزات. توضح هذه المقالة كيفية استخدام الأمرين Import-AzBlueprintWithArtifact وExport-AzBlueprintWithArtifact في الوحدة النمطية Az.Blueprint.

المتطلبات الأساسية

تفترض هذه المقالة معرفة عملية معتدلة من Azure Blueprints. إذا لم تكن قد فعلت ذلك بعد، فاعمل من خلال المقالات التالية:

إذا لم يكن مثبتاً بالفعل، فاتبع الإرشادات الموجودة في إضافة الوحدة النمطية Az.Blueprint لتثبيت الوحدة النمطية Az.Blueprint والتحقق من صحتها من معرض PowerShell.

بنية المجلد لتعريف مخطط

قبل النظر في تصدير المخططات واستيرادها، دعونا ننظر في كيفية هيكلة الملفات التي تشكّل تعريف المخطط. يجب تخزين تعريف المخطط في مجلده الخاص.

هام

إذا لم يتم تمرير أي قيمة إلى المعلمة الاسم لـ Import-AzBlueprintWithArtifact cmdlet، يتم استخدام اسم المجلد الذي يتم تخزين تعريف المخطط فيه.

جنباً إلى جنب مع تعريف المخطط، الذي يجب تسميته blueprint.json، هي البيانات الاصطناعية التي يتكون منها تعريف المخطط. يجب أن تكون كل البيانات الاصطناعية في المجلد الفرعي المسمى artifacts. معاً، يجب أن تبدو بنية تعريف مخططك كملفات JSON في المجلدات كما يلي:

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

تصدير تعريف مخططك

خطوات تصدير تعريف مخططك واضحة. يمكن أن يكون تصدير تعريف المخطط مفيداً للمشاركة أو النسخ الاحتياطي أو وضعها في التحكم بالمصادر.

  • المخطط [مطلوب]
    • تحديد تعريف المخطط
    • استخدم Get-AzBlueprint للحصول على العنصر المرجعي
  • OutputPath [required]
    • تحديد المسار الذي تريد حفظ ملفات JSON لتعريف المخطط فيه
    • ملفات الإخراج موجودة في مجلد فرعي باسم تعريف المخطط
  • الإصدار (اختياري)
    • تحديد الإصدار الذي يجب إخراجه إذا كان العنصر المرجعي المخطط يحتوي على مراجع لأكثر من إصدار واحد.

  1. احصل على مرجع لتعريف المخطط للتصدير من الاشتراك الممثل كـ {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. استخدم cmdlet Export-AzBlueprintWithArtifact لتصدير تعريف المخطط المحدد:

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

استيراد تعريف مخططك

بمجرد أن يكون لديك إما تعريف مخطط تم تصديره أو يكون لديك تعريف مخطط تم إنشاؤه يدوياً في بنية المجلد المطلوبة، يمكنك استيراد تعريف المخطط هذا إلى مجموعة إدارة أو اشتراك مختلف.

للحصول على أمثلة لتعريفات المخطط المضمنة، راجع مستودع Azure Blueprints GitHub.

  • الاسم [مطلوب]
    • تحديد اسم تعريف المخطط الجديد
  • InputPath [required]
  • ManagementGroupId (اختياري)
    • معرف مجموعة الإدارة لحفظ تعريف المخطط إذا لم يكن السياق الافتراضي الحالي
    • يجب تحديد إما ManagementGroupId أو SubscriptionId
  • SubscriptionId (اختياري)
    • معرف الاشتراك لحفظ تعريف المخطط إذا لم يكن السياق الافتراضي الحالي
    • يجب تحديد إما ManagementGroupId أو SubscriptionId

  1. استخدم cmdlet Import-AzBlueprintWithArtifact لاستيراد تعريف المخطط المحدد:

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

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

بمجرد استيراد تعريف المخطط، يمكنك تعيين باستخدام PowerShell.

للحصول على معلومات حول إنشاء تعريفات مخطط متقدمة، راجع المقالات التالية:

الخطوات التالية