اقرأ باللغة الإنجليزية

مشاركة عبر

تحديث الوحدات النمطية لـAzure PowerShell في Azure Automation

  • مقالة

يتم توفير وحدات PowerShell النمطية الأكثر شيوعاً افتراضياً في كل حساب Automation. يرجى الاطلاع على الوحدات النمطية الافتراضية. يعمل فريق Azure على تحديث الوحدات النمطية في Azure بصفة منتظمة، ويمكن أن تطرأ تغييرات بشأن cmdlets المدرجة. يمكن لتغييرات مثل إعادة تسمية معلمة أو إهمال أمر cmdlet بالكامل إحداث تأثير سلبي على كتاب تشغيلك.

ملاحظة

ولا يمكنك حذف الوحدات النمطية العمومية، نظراً لأنها وحدات نمطية توفر Automation بعيدا عن محيط الصندوق.

هام

تتيح لك تجربة بيئة وقت التشغيل الجديدة إدارة الوحدات والحزم من خلال السماح لك بتكوين بيئة تنفيذ المهمة. في التجربة الجديدة، لا تتوفر الوحدات النمطية وشفرات الحزم. لإدارة الوحدات والحزم، راجع إدارة بيئة وقت التشغيل ودفاتر التشغيل المقترنة.

إعداد حساب Automation

لمنع التأثير على دفاتر التشغيل والعمليات التي تقوم بأتمتتها، تأكد من اختبارها والتحقق من صحتها أثناء إجراء التحديثات. إذا لم يكن لديك حساب Automation مخصص لهذا الغرض، فاحرص على إنشاء حساب يمكنك من اختبار العديد من السيناريوهات المختلفة خلال مرحلة تطوير دفاتر التشغيل الخاصة بك. ويجب أن يتضمن هذا الاختبار تغييرات متكررة، مثل تحديث الوحدات النمطية لـ PowerShell.

تأكد من إضافة حسابك على Automation هوية مدارة معينة من قبل النظام أو هوية مدارة تم تعيينها من قبل المستخدم.

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

ملاحظة

قد لا يحتوي الحساب الجديد على Automation على أحدث الوحدات النمطية.

تحديث الوحدات النمطية لـAzure

توضح الأقسام التالية كيفية تحديث وحدات Az إما من خلال المدخل (مستحسن) أو من خلال دفتر التشغيل.

تحديث وحدات Az النمطية من خلال المدخل

أصبح تحديث الوحدات النمطية الخاصة بـ Azure متاحاً فقط من خلال المدخل. ستصبح التحديثات من خلال نموذج PowerShell وARM متاحة في المستقبل. وستحدث الوحدات النمطية الافتراضية لـ Az الافتراضية عند تنفيذ الخطوات التالية:

  1. سجل الدخول إلى مدخل Microsoft Azure وانتقل إلى حساب التنفيذ التلقائي الخاص بك.

  2. ضمن Shared Resources، حدد Modules.

  3. حدد تحديث وحدات Az النمطية.

  4. حدد «تحديث الوحدة النمطية». ستعرض الوحدة النمطية لـ Azure بطريقة افتراضية.

  5. من القائمة المنسدلة، حدد «إصدار الوحدة النمطية» وإصدار «إصدار نوع التشغيل»

  6. حدد «تحديث» لتحديث الوحدة النمطية في Azure على الإصدار المحدد من جانبك. في صفحة الوحدات النمطية، يمكنك عرض القائمة على النحو المبين أدناه:

    تحديث صفحة الوحدات النمطية لـAZ باستخدام التحديدات.

إذا حددت إصداراً أقل من إصدار الوحدة النمطية Az الحالي الذي تم استيراده في حساب Automation، فستقوم عملية التحديث بالتراجع إلى الإصدار الأدنى المحدد.

يمكنك التحقق من صحة عملية التحديث عن طريق التحقق من إصدار الوحدة النمطية وخاصية الحالة للوحدات النمطية المُحدثة المعروضة في قائمة الوحدات النمطية داخلالوحدات النمطية PowerShell.

سيقوم فريق Azure بتحديث إصدار الوحدة النمطية بانتظام وتوفير خيار لتحديث الوحدات النمطية الافتراضية لـAzure عن طريق تحديد إصدار الوحدة النمطية من القائمة المنسدلة.

تحديث الوحدات النمطية Az من خلال دفتر التشغيل

لتحديث وحدات Azure النمطية في حساب التنفيذ التلقائي الخاص بك:

  1. استخدم سجل تشغيل Update-AutomationAzureModulesForAccount المتوفر ك مصدر مفتوح.
  2. قم بالتنزيل من مستودع GitHub، لبدء استخدام دفتر التشغيل هذا لتحديث وحدات Azure النمطية.
  3. قم باستيراده إلى حساب Automation الخاص بك أو قم بتشغيله كبرنامج نصي. لمعرفة طريقة استيراد كتاب تشغيل في حسابك على Automation، يرجى الاطلاع على استيراد كتاب التشغيل.

ملاحظة

نوصي بتحديث وحدات Az النمطية من خلال مدخل Microsoft Azure. يمكنك أيضا تنفيذ هذا باستخدام Update-AutomationAzureModulesForAccount البرنامج النصي، المتوفر كمصدر مفتوح والمتوفر كمرجع. ومع ذلك، في حالة حدوث أي فشل في دفتر التشغيل، تحتاج إلى تعديل المعلمات في دفتر التشغيل كما هو مطلوب أو تصحيح البرنامج النصي وفقا للسيناريو.

يدعم دفتر تشغيل Update-AutomationAzureModulesForAccount تحديث الوحدات النمطية Azure وAzureRM وAz بصفة افتراضية. يُرجى مراجعة تحديث كتاب تشغيل الوحدات النمطية Azure README للحصول على مزيد من المعلومات الخاصة بتحديث Az.Automation باستخدام كتاب التشغيل. توجد عوامل هامة إضافية تحتاج إلى أخذها في الاعتبار عند استخدام الوحدات النمطية Az في حسابك على Automation. لمعرفة مزيد من التفاصيل، يرجى الاطلاع على إدارة الوحدات النمطية في Automation في Azure.

استخدام التعليمات البرمجية لدفتر تشغيل التحديث كبرنامج نصي عادي ل PowerShell

يمكنك استخدام التعليمة البرمجية لكتاب التشغيل باعتبارها برنامج نصياً منتظماً لـ PowerShell عوضاً عن كتاب التشغيل. لتطبيق ذلك، قم بتسجيل الدخول إلى Azure باستخدام Connect-AzAccount cmdlet أولاً، ومن ثم انتقل -Login $false إلى البرنامج النصي.

استعمال كتاب تشغيل التحديث على السحب ذات السيادة

لاستعمال كتاب التشغيل المذكور على السحب ذات السيادة، احرص على استخدم المعلمة AzEnvironment لتوفير البيئة الصحيحة لكتاب التشغيل. القيم المقبولة هي AzureCloud (السحابة العامة لـAzure ) AzureChinaCloud وAzureGermanCloud وAzureUSGovernment. يمكن استرجاع تلك القيم باستخدام Get-AzEnvironment | select Name. في حالة عدم نقل القيم إلى cmdlet، فسيتم تعيين دفتر التشغيل افتراضياً إلى AzureCloud.

استخدام كتاب تشغيل التحديث لتحديث إصدار وحدة نمطية معينة

في حالة رغبتك في استخدام إصدار وحدة نمطية Azure PowerShell محددة بدلاً من أحدث وحدة نمطية متوفرة على معرض PowerShell، انقل تلك الإصدارات إلى ModuleVersionOverridesالمعلمة الاختيارية لكتاب تشغيل Update-AutomationAzureModulesForAccount. يرجى الاطلاع على كتاب التشغيل Update-AutomationAzureModulesForAccount.ps1 يتم تحديث الوحدات النمطية لـAzure PowerShell التي لم يتم ذكرها في المعلمة ModuleVersionOverrides بأحدث إصدارات الوحدة النمطية في معرض PowerShell. في حالة نقلك أية شيء إلى المعلمة ModuleVersionOverrides، يتم تحديث كافة الوحدات النمطية مع أحدث إصدارات الوحدة النمطية على معرض PowerShell. يحدث الأمر نفسه في زر تحديث الوحدات النمطية لـAzure في مدخل Microsoft Azure.

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