مشاركة عبر

تحرير دفاتر التشغيل النصية في Azure Automation

  • مقالة

يمكنك استخدام محرر نصي في Azure Automation لتحرير PowerShell runbooks وPowerShell سير العمل runbooks. يحتوي هذا المحرر على الميزات النموذجية لمحرري التعليمات البرمجية الآخرين، مثل التحسس الذكي. كما أنه يستخدم ترميز الألوان مع ميزات خاصة إضافية لمساعدتك في الوصول إلى الموارد الشائعة في الكتب.

يتضمن المحرر النصي ميزة لإدراج التعليمات البرمجية لـ cmdlets والأصول وسجلات التشغيل التابعة في دفتر تشغيل. بدلاً من كتابة التعليمات البرمجية بنفسك، يمكنك التحديد من قائمة الموارد المتوفرة، كما يقوم المحرر بإدراج التعليمات البرمجية المناسبة في دفتر التشغيل.

يحتوي كل كتاب تشغيل في Azure Automation على إصدارين، مسودة ونشر. تحرير الإصدار مسودة من دفتر التشغيل ثم نشرها بحيث يمكن تنفيذها. لا يمكن تحرير الإصدار المنشور. لمزيد من المعلومات، راجع نشر دفتر تشغيل.

توفر هذه المقالة خطوات مفصلة لتنفيذ وظائف مختلفة مع هذا المحرر. لا تنطبق هذه على دفاتر التشغيل الرسومية. للعمل على هذه الكتب، راجع التأليف الرسومي في أتمتة Azure.

هام

لا تقم بتضمين الكلمة الأساسية "AzureRm" في أي برنامج نصي مُصمم ليتم تنفيذه مع الوحدة Az. قد يؤدي تضمين الكلمة الأساسية، حتى في تعليق، إلى تحميل AzureRm ومن ثم تعارضه مع الوحدة النمطية Az.

قم بتحرير دفتر تشغيل بمدخل Microsoft Azure

  1. في مدخل Microsoft Azure حدد حساب التنفيذ التلقائي.
  2. حدد "Runbooks" في "Process Automation" لفتح قائمة دفاتر التشغيل.
  3. اختر دفتر التشغيل الذي تريد تحريره ثم انقر فوق Edit.
  4. تحرير دفتر التشغيل.
  5. انقر على Save عند اكتمال عمليات التحرير.
  6. انقر فوق Publish إذا كنت تريد نشر أحدث إصدار مسودة من دفتر التشغيل.

إدراج cmdlet في دفتر تشغيل

  1. في لوحة المحرر النصي، ضع المؤشر حيث تريد وضع cmdlet.
  2. توسيع عقدة Cmdlets في عنصر تحكم المكتبة.
  3. توسيع الوحدة النمطية التي تحتوي على cmdlet للاستخدام.
  4. انقر بزر الماوس الأيمن فوق اسم cmdlet لإدراج وحدد إضافة إلى لوحة. إذا كان cmdlet أكثر من مجموعة معلمات، يضيف المحرر المجموعة الافتراضية. يمكنك أيضاً توسيع cmdlet لتحديد مجموعة معلمات مختلفة.
  5. لاحظ أنه يتم إدراج رمز الأمر cmdlet مع قائمة المعلمات الكاملة الخاصة به.
  6. توفير قيمة مناسبة بدلا من القيمة محاطة بأقواس زاوية (<>) لأي معلمات مطلوبة. إزالة أي معلمات لا تحتاج إليها.

إدراج التعليمات البرمجية لدفتر تشغيل تابع في دفتر تشغيل

  1. في لوحة محرر النصوص، ضع المؤشر في المكان الذي تريد وضع رمزدفتر التشغيل الفرعي فيه.
  2. توسيع عقدة Runbooks في عنصر تحكم المكتبة.
  3. انقر بزر الماوس الأيمن فوق دفتر التشغيل لإدراجه وحدد Add to canvas.
  4. يتم إدراج التعليمات البرمجية لدفتر التشغيل التابع مع أي عناصر نائبة لأي معلمات دفتر التشغيل.
  5. استبدل العناصر النائبة بالقيم المناسبة لكل معلمة.

إدراج أصل في دفتر تشغيل

  1. في عنصر تحكم Canvas للمحرر النصي ضع المؤشر حيث تريد وضع التعليمات البرمجية لدفتر التشغيل التابع.
  2. توسيع عقدة Assets في عنصر تحكم المكتبة.
  3. قم بتوسيع العقدة لنوع الأصل المطلوب.
  4. انقر بزر الماوس الأيمن فوق اسم الأصل المراد إدراجه وحددAdd to canvas. بالنسبة للأصول المتغيرة، حدد إما إضافة "الحصول على متغير" إلى لوحة أو إضافة "تعيين متغير" إلى لوحة،اعتمادًا على ما إذا كنت ترغب في الحصول على المتغير أو تعيينه.
  5. لاحظ أن يتم إدراج التعليمات البرمجية للأصل في دفتر التشغيل.

تحرير دفتر تشغيل Azure Automation باستخدام Windows PowerShell

لتحرير كتاب تشغيل مع Windows PowerShell، استخدم محرر اختيارك وحفظ دفتر التشغيل إلى ملف .ps1. يمكنك استخدام cmdlet الخاص بـ Export-AzAutomationRunbook لاسترداد محتويات دفتر التشغيل. يمكنك استخدام cmdlet الخاص بـ Import-AzAutomationRunbook لاستبدال دفتر تشغيل مسودة موجودة مع تعديل واحد.

استرداد محتويات دفتر تشغيل باستخدام Windows PowerShell

تظهر الأوامر عينة التالية كيفية استرداد البرنامج النصي لدفتر تشغيل وحفظه إلى ملف برنامج نصي. في هذا المثال، يتم استرداد نسخة المسودة. من الممكن أيضاً استرداد الإصدار المنشور من دليل التشغيل، على الرغم من أنه لا يمكن تغيير هذا الإصدار.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Export-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -OutputFolder $scriptFolder -Slot Draft

قم بتغيير محتويات دفتر التشغيل باستخدام Windows PowerShell

تُظهر أوامر العينة التالية كيفية استبدال المحتويات الموجودة في كتاب التشغيل بمحتويات ملف البرنامج النصي.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Import-AzAutomationRunbook -Path "$scriptfolder\Hello-World.ps1" -Name $runbookName -Type PowerShell -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -Force
Publish-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName

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