أنواع سجل تشغيل Azure Automation

تدعم ميزة التشغيل التلقائي للعمليات في Azure Automation عدة أنواع من سجلات التشغيل المحددة في الجدول التالي. للتعرف على بيئة التشغيل التلقائي للعمليات، راجع تنفيذ سجل التشغيل في Azure Automation.

النوع	‏‏الوصف
بوويرشيل	سجل التشغيل النصي يعتمد على البرمجة النصية لـ Windows PowerShell. الإصدارات المدعومة حاليا هي: PowerShell 7.2 (GA) وPowerShell 5.1 (GA). نظرا لأن PowerShell 7.1 لم يعد مدعوما من قبل PowerShell المنتج الأصل، نوصيك بإنشاء دفاتر التشغيل في الإصدار المدعوم على المدى الطويل PowerShell 7.2
سير عمل PowerShell	سجل التشغيل النصي يعتمد على البرمجة النصية لسير عمل PowerShell.
Python	سجل التشغيل النصي يعتمد على البرمجة النصية لـ Python. الإصدارات المدعومة حاليا هي: Python 3.8 (GA) وPython 3.10 (معاينة). نظرا لأن Python 2.7 لم يعد مدعوما من قبل Python المنتج الأصل، نوصيك بإنشاء دفاتر تشغيل في إصدارات مدعومة على المدى الطويل.
رسم بياني	سجل التشغيل البياني يستند إلى Windows PowerShell وتم إنشاؤه وتحريره بالكامل في المحرر الرسومي في مدخل Microsoft Azure.
سير عمل الرسم البياني PowerShell	سجل التشغيل البياني يستند إلى Windows PowerShell Workflow وتم إنشاؤه وتحريره بالكامل في المحرر الرسومي مدخل Microsoft Azure.

إشعار

سيتبع Azure Automation دورة حياة الدعم لإصدارات لغة PowerShell وPython وفقا للمخططات الزمنية التي نشرتها المنتجات الأصلية PowerShell وPython على التوالي. نوصيك باستخدام دفاتر التشغيل مع إصدارات اللغة المدعومة.

يُرجى مراعاة الاعتبارات التالية عند تحديد النوع الذي يجب استخدامه في سجل تشغيل معين.

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

سجلات تشغيل PowerShell

تستند سجلات تشغيل PowerShell إلى Windows PowerShell. يمكنك تحرير التعليمات البرمجية لسجلات التشغيل مباشرة باستخدام محرر النص في مدخل Microsoft Azure. يمكنك أيضا استخدام أي محرر نصوص دون اتصال واستيراد سجل التشغيل إلى Azure Automation.

يتم تحديد إصدار PowerShell بواسطة إصدار وقت التشغيل المحدد (أي الإصدار 7.2 أو 7.1 (معاينة) أو 5.1).

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

إشعار

• حاليا، يتم دعم إصدار وقت التشغيل PowerShell 7.2 لكل من السحابة والوظائف المختلطة في جميع المناطق العامة باستثناء سحابات وسط الهند، ووسط الإمارات العربية المتحدة، وإسرائيل الوسطى، وإيطاليا الشمالية، وشمال ألمانيا، وسحب Gov.
• في وقت تنفيذ دفتر التشغيل، إذا حددت إصدار وقت التشغيل ك 7.2، يتم استخدام وحدات PowerShell النمطية التي تستهدف إصدار وقت التشغيل 7.2 وإذا حددت إصدار وقت التشغيل ك 5.1، يتم استخدام وحدات PowerShell النمطية التي تستهدف إصدار وقت التشغيل 5.1. ينطبق هذا على وحدات PowerShell 7.1 (معاينة) ودفاتر التشغيل.

تأكد من تحديد إصدار وقت التشغيل المناسب للوحدات النمطية.

على سبيل المثال: إذا كنت تقوم بتنفيذ دفتر تشغيل لسيناريو أتمتة SharePoint في إصداروقت التشغيل 7.1 (معاينة)، فقم باستيراد الوحدة النمطية في إصداروقت التشغيل 7.1 (معاينة)؛ إذا كنت تقوم بتنفيذ دفتر تشغيل لسيناريو أتمتة SharePoint في إصداروقت التشغيل 5.1، فقم باستيراد الوحدة النمطية في إصداروقت التشغيل 5.1. في هذه الحالة، سترى إدخالين للوحدة النمطية، أحدهما لإصدار وقت التشغيل7.1 (معاينة) والآخر ل 5.1.

إشعار

حاليا، يتم دعم PowerShell 5.1 وPowerShell 7.1 (معاينة) وPowerShell 7.2.

المزايا

• تنفيذ جميع المنطق المعقد باستخدام التعليمات البرمجية PowerShell بدون التعقيدات الأخرى لـ PowerShell Workflow.
• البدء بشكل أسرع من سجلات تشغيل PowerShell Workflow، حيث لا يلزم تجميعها قبل التشغيل.
• التشغيل في Azure وعلى Hybrid Runbook Workers لكل من Windows وLinux.

القيود والمشكلات المعروفة

فيما يلي القيود الحالية والمشكلات المعروفة مع دفاتر تشغيل PowerShell:

PowerShell 7.2

القيود

إشعار

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

• بالنسبة لإصدار وقت تشغيل PowerShell 7.2، لا يتم استخراج أنشطة الوحدة النمطية للوحدات النمطية المستوردة. استخدم ملحق Azure Automation لتعليمات VS البرمجية لتبسيط تجربة تأليف دفتر التشغيل.
• لا يدعم PowerShell 7.x مهام سير العمل. لمزيد من المعلومات، راجع سير عمل PowerShell لمزيد من التفاصيل.
• لا يدعم PowerShell 7.x حاليا دفاتر التشغيل الموقعة.
• لا يدعم تكامل التحكم بالمصادر PowerShell 7.2. أيضا، يتم إنشاء دفاتر تشغيل PowerShell 7.2 في التحكم بالمصادر في حساب التنفيذ التلقائي ك Runtime 5.1.
• يتم تثبيت الوحدة النمطية Az 8.3.0 بشكل افتراضي. تظهر القائمة الكاملة لوحدات المكون النمطية لإصدار الوحدة النمطية Az المحدد بمجرد تكوين إصدار Az مرة أخرى باستخدام مدخل Microsoft Azure أو واجهة برمجة التطبيقات.
• سيتم التحقق من صحة وحدة PowerShell 7.2 المستوردة أثناء تنفيذ المهمة. تأكد من استيراد جميع التبعيات للوحدة النمطية المحددة أيضا لتنفيذ المهمة بنجاح.
• لا يدعم Start-Job دفتر تشغيل Azure مع -credential.
• لا يدعم Azure جميع معلمات إدخال PowerShell. اعرف المزيد.

المشاكل المعروفة

• قد تفشل دفاتر التشغيل التي تعتمد على مسارات الملفات الداخلية مثل C:\modules بسبب التغييرات في البنية الأساسية الخلفية للخدمة. قم بتغيير التعليمات البرمجية لدفتر التشغيل للتأكد من عدم وجود تبعيات على مسارات الملفات الداخلية واستخدم Get-ChildItem للحصول على معلومات الوحدة النمطية المطلوبة.

• Get-AzStorageAccountقد يفشل cmdlet مع وجود خطأ: Get-AzStorageAccount تم العثور على الأمر في الوحدة النمطية Az.Storage، ولكن تعذر تحميل الوحدة النمطية.

• تنفيذ البرامج النصية التابعة باستخدام .\child-runbook.ps1 غير معتمد.
  الحل البديل: استخدم Start-AutomationRunbook (cmdlet الداخلي) أو Start-AzAutomationRunbook (من الوحدة النمطية Az.Automation ) لبدء تشغيل دفتر تشغيل آخر من دفتر التشغيل الأصل.

• عند استخدام إصدار الوحدة النمطية ExchangeOnlineManagement : 3.0.0 أو أعلى، يمكنك تجربة أخطاء. لحل المشكلة، تأكد من تحميل وحدات PowerShellGet و PackageManagement بشكل صريح.

• عند استخدام New-AzAutomationVariable cmdlet داخل وحدة Az.Automation لتحميل متغير من كائن النوع، لا تعمل العملية كما هو متوقع.

  الحل البديل: تحويل الكائن إلى سلسلة JSON باستخدام ConvertTo-Json cmdlet ثم تحميل المتغير مع سلسلة JSON كقيمة لها. يضمن هذا الحل البديل المعالجة المناسبة للمتغير داخل بيئة Azure Automation كسلسلة JSON.

  مثال - إنشاء كائن PowerShell يحتوي على معلومات مخزنة حول أجهزة Azure الظاهرية

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

PowerShell 5.1

القيود

• لا يمكن لسجلات التشغيل استخدام المعالجة المتوازية لتنفيذ إجراءات متعددة بالتوازي.
• لا يمكن لسجلات التشغيل استخدام نقاط التحقق لاستئناف سجل التشغيل إذا كان حدث خطأ.
• يمكنك تضمين سجلات تشغيل PowerShell وPowerShell Workflow وسجلات تشغيل رسومية فقط كسجلات تشغيل فرعية باستخدام Start-AzAutomationRunbook cmdlet، مما يؤدي إلى إنشاء دالة جديدة.
• لا يمكن لسجلات التشغيل استخدام عبارة PowerShell #Requires ، فهي غير مدعومة في بيئة الاختبار المعزولة ل Azure أو في Hybrid Runbook Workers وقد تتسبب في فشل المهمة.
• لا يدعم Start-Job دفتر تشغيل Azure مع -credential.
• لا يدعم Azure جميع معلمات إدخال PowerShell. اعرف المزيد.

المشاكل المعروفة

• قد تفشل دفاتر التشغيل التي تعتمد على مسارات الملفات الداخلية مثل C:\modules بسبب التغييرات في البنية الأساسية الخلفية للخدمة. قم بتغيير التعليمات البرمجية لدفتر التشغيل للتأكد من عدم وجود تبعيات على مسارات الملفات الداخلية واستخدم Get-ChildItem للحصول على معلومات الوحدة النمطية المطلوبة.

  نموذج البرنامج النصي

  
  # Get information about module "Microsoft.Graph.Authentication"
  $ModuleName = "Microsoft.Graph.Authentication"
  
  $NewPath = "C:\usr\src\PSModules\$ModuleName"
  $OldPath = "C:\Modules\User\$ModuleName"
  
  if (Test-Path -Path $NewPath -PathType Container) {
      Get-ChildItem -Path $NewPath
  } elseif (Test-Path -Path $OldPath -PathType Container) {
      Get-ChildItem -Path $OldPath
  } else {
      Write-Output "Module $ModuleName not present."
  }
  # Getting the path to the Temp folder, if needed.
  $tmp = $env:TEMP
  
  

• Get-AzStorageAccountقد يفشل cmdlet مع وجود خطأ: Get-AzStorageAccount تم العثور على الأمر في الوحدة النمطية Az.Storage، ولكن تعذر تحميل الوحدة النمطية.

• لا يمكن لسجلات تشغيل PowerShell استرداد أصل متغير غير مشفر بقيمة خالية.

• لا يمكن لسجلات تشغيل PowerShell استرداد أصل متغير باستخدام *~* في الاسم.

• يمكن أن تتعطل عملية Get-Process في تكرار حلقي في سجل تشغيل PowerShell بعد حوالي 80 تكرارًا.

• يمكن أن يفشل سجل تشغيل PowerShell إذا حاول كتابة كمية كبيرة من البيانات إلى دفق الإخراج مرة واحدة. يمكنك عادةً التغلب على هذه المشكلة عن طريق جعل إخراج سجل التشغيل هو المعلومات المطلوبة فقط للعمل مع العناصر الكبيرة. بدلاً من استخدام Get-Process دون قيود، يمكنك على سبيل المثال، يمكنك فقط تضمين المعلمات المطلوبة في إخراج الأمر cmdlet كما هو الحال مع Get-Process | Select ProcessName, CPU.

• عند استخدام إصدار الوحدة النمطية ExchangeOnlineManagement : 3.0.0 أو أعلى، قد تواجه أخطاء. لحل المشكلة، تأكد من تحميل وحدات PowerShellGet و PackageManagement بشكل صريح أيضا.

• إذا قمت باستيراد الوحدة النمطية Az.Accounts مع الإصدار 2.12.3 أو أحدث، فتأكد من استيراد الوحدة النمطية Newtonsoft.Json v10 بشكل صريح إذا كانت دفاتر تشغيل PowerShell 5.1 تعتمد على هذا الإصدار من الوحدة النمطية. الحل البديل لهذه المشكلة هو استخدام دفاتر تشغيل PowerShell 7.2.

• عند استخدام New-AzAutomationVariable cmdlet داخل وحدة Az.Automation لتحميل متغير من كائن النوع، لا تعمل العملية كما هو متوقع.

  الحل البديل: تحويل الكائن إلى سلسلة JSON باستخدام ConvertTo-Json cmdlet ثم تحميل المتغير مع سلسلة JSON كقيمة لها. يضمن هذا الحل البديل المعالجة المناسبة للمتغير داخل بيئة Azure Automation كسلسلة JSON.

  مثال - إنشاء كائن PowerShell يحتوي على معلومات مخزنة حول أجهزة Azure الظاهرية

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

PowerShell 7.1

القيود

• لم يعد PowerShell 7.1 مدعوما من قبل المنتج الأصل PowerShell. نوصيك بإنشاء دفاتر تشغيل جديدة في PowerShell 7.2 للحصول على دعم طويل الأجل وتحديث دفاتر التشغيل القديمة.
• لا يتم دعم أوامر PowerShell cmdlets الداخلية ل Azure Automation على Linux Hybrid Runbook Worker. يجب استيراد الوحدة النمطية automationassets في بداية دفتر تشغيل PowerShell للوصول إلى وظائف الموارد (الأصول) المشتركة لحساب التنفيذ التلقائي.
• بالنسبة لإصدار وقت تشغيل PowerShell 7، لا يتم استخراج أنشطة الوحدة النمطية للوحدات النمطية المستوردة.
• نوع معلمة دفتر التشغيل PSCredential غير مدعوم في إصدار وقت التشغيل PowerShell 7.
• لا يدعم PowerShell 7.x مهام سير العمل. لمزيد من المعلومات، راجع سير عمل PowerShell لمزيد من التفاصيل.
• لا يدعم PowerShell 7.x حاليا دفاتر التشغيل الموقعة.
• لا يدعم تكامل التحكم بالمصادر PowerShell 7.1 (معاينة) أيضا، يتم إنشاء دفاتر تشغيل PowerShell 7.1 (معاينة) في التحكم بالمصادر في حساب التنفيذ التلقائي ك Runtime 5.1.
• إدارة الوحدة النمطية PowerShell 7.1 غير مدعومة من خلال Get-AzAutomationModule أوامر cmdlets.
• يفشل دفتر التشغيل بدون تتبع السجل إذا كانت قيمة الإدخال تحتوي على الحرف '.
• لا يدعم Start-Job دفتر تشغيل Azure مع -credential.
• لا يدعم Azure جميع معلمات إدخال PowerShell. اعرف المزيد.

المشاكل المعروفة

• قد تفشل دفاتر التشغيل التي تعتمد على مسارات الملفات الداخلية مثل C:\modules بسبب التغييرات في البنية الأساسية الخلفية للخدمة. قم بتغيير التعليمات البرمجية لدفتر التشغيل للتأكد من عدم وجود تبعيات على مسارات الملفات الداخلية واستخدم Get-ChildItem للحصول على معلومات الوحدة النمطية المطلوبة.

  نموذج البرنامج النصي

  
  # Get information about module "Microsoft.Graph.Authentication"
  $ModuleName = "Microsoft.Graph.Authentication"
  
  $NewPath = "C:\usr\src\PSModules\$ModuleName"
  $OldPath = "C:\Modules\User\$ModuleName"
  
  if (Test-Path -Path $NewPath -PathType Container) {
      Get-ChildItem -Path $NewPath
  } elseif (Test-Path -Path $OldPath -PathType Container) {
      Get-ChildItem -Path $OldPath
  } else {
      Write-Output "Module $ModuleName not present."
  }
  # Getting the path to the Temp folder, if needed.
  $tmp = $env:TEMP
  
  

• Get-AzStorageAccountقد يفشل cmdlet مع وجود خطأ: Get-AzStorageAccount تم العثور على الأمر في الوحدة النمطية Az.Storage، ولكن تعذر تحميل الوحدة النمطية.

• تنفيذ البرامج النصية التابعة باستخدام .\child-runbook.ps1 غير مدعوم في هذه المعاينة. الحل البديل: استخدم Start-AutomationRunbook (cmdlet الداخلي) أو Start-AzAutomationRunbook (من Az.Automation الوحدة النمطية) لبدء تشغيل دفتر تشغيل آخر من دفتر التشغيل الأصل.

• خصائص دفتر التشغيل التي تحدد تفضيلات التسجيل غير مدعومة في وقت تشغيل PowerShell 7. الحل البديل: تعيين التفضيل بشكل صريح في بداية دفتر التشغيل كما يلي -

      $VerbosePreference = "Continue"
  
      $ProgressPreference = "Continue"
  

• تجنب استيراد الوحدة النمطية Az.Accounts إلى الإصدار 2.4.0 لوقت تشغيل PowerShell 7 حيث يمكن أن يكون هناك سلوك غير متوقع باستخدام هذا الإصدار في Azure Automation.

• قد تواجه مشكلات في التنسيق مع تدفقات إخراج الخطأ للمهمة قيد التشغيل في وقت تشغيل PowerShell 7.

• عند استيراد وحدة PowerShell 7.1 التي تعتمد على وحدات نمطية أخرى، قد تجد أن زر الاستيراد رمادي حتى عند تثبيت إصدار PowerShell 7.1 من الوحدة النمطية التابعة. على سبيل المثال، الوحدة النمطية Az PowerShell. حوسبة الإصدار 4.20.0، له تبعية على Az.Accounts يجري >= 2.6.0. تحدث هذه المشكلة عندما لا تفي وحدة نمطية تابعة مكافئة في PowerShell 5.1 بمتطلبات الإصدار. على سبيل المثال، الإصدار 5.1 من Az.Accounts كان < 2.6.0.

• عند بدء تشغيل دفتر تشغيل PowerShell 7 باستخدام خطاف الويب، فإنه يحول معلمة إدخال خطاف الويب تلقائيا إلى JSON غير صالح.

• نوصي باستخدام إصدار الوحدة النمطية ExchangeOnlineManagement : 3.0.0 أو أقل لأن الإصدار: 3.0.0 أو أعلى قد يؤدي إلى فشل الوظيفة.

• إذا قمت باستيراد الوحدة النمطية Az.Accounts مع الإصدار 2.12.3 أو أحدث، فتأكد من استيراد الوحدة النمطية Newtonsoft.Json v10 بشكل صريح إذا كانت سجلات تشغيل PowerShell 7.1 تعتمد على هذا الإصدار من الوحدة النمطية. الحل البديل لهذه المشكلة هو استخدام دفاتر تشغيل PowerShell 7.2.

• عند استخدام New-AzAutomationVariable cmdlet داخل وحدة Az.Automation لتحميل متغير من كائن النوع، لا تعمل العملية كما هو متوقع.

  الحل البديل: تحويل الكائن إلى سلسلة JSON باستخدام ConvertTo-Json cmdlet ثم تحميل المتغير مع سلسلة JSON كقيمة لها. يضمن هذا الحل البديل المعالجة المناسبة للمتغير داخل بيئة Azure Automation كسلسلة JSON.

  مثال - إنشاء كائن PowerShell يحتوي على معلومات مخزنة حول أجهزة Azure الظاهرية

    # Retrieve Azure virtual machines with status information for the 'northeurope' region 
    $AzVM = Get-AzVM -Status | Where-Object {$_.Location -eq "northeurope"} 
  
    $VMstopatch = @($AzVM).Id 
    # Create an Azure Automation variable (This cmdlet will not fail, but the variable may not work as intended when used in the runbook.) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $VMstopatch 
  
    # Convert the object to a JSON string 
    $jsonString = $VMstopatch | ConvertTo-Json 
  
    # Create an Azure Automation variable with a JSON string value (works effectively within the automation runbook) 
    New-AzAutomationVariable -ResourceGroupName "mrg" -AutomationAccountName "mAutomationAccount2" -Name "complex1" -Encrypted $false -Value $jsonString 
  

سجلات التشغيل في PowerShell Workflow

سجلات التشغيل في PowerShell Workflow هي عبارة عن دفاتر تشغيل نصية تستند إلى Windows PowerShell Workflow. يمكنك تحرير التعليمات البرمجية لسجلات التشغيل مباشرة باستخدام محرر النص في مدخل Microsoft Azure. يمكنك أيضا استخدام أي محرر نصوص دون اتصال واستيراد سجل التشغيل إلى Azure Automation.

إشعار

لا يدعم PowerShell 7.1 (معاينة) وPowerShell 7.2 دفاتر تشغيل سير العمل.

المزايا

• تنفيذ جميع المنطق المعقد باستخدام التعليمات البرمجية PowerShell Workflow.
• استخدام نقاط التحقق لاستئناف العملية إذا كان حدث خطأ.
• استخدام المعالجة المتوازية لتنفيذ إجراءات متعددة بالتوازي.
• يمكن أن تتضمن سجلات التشغيل الرسومية الأخرى وسجلات تشغيل PowerShell Workflow كسجلات تشغيل فرعية لإنشاء تدفقات عمل عالية المستوى.

القيود

• سير عمل PowerShell غير مدعوم في إصدارات PowerShell 7+. ومن ثم، لا يمكن ترقية دفاتر التشغيل القديمة.
• معالجة غير فعالة للتنفيذ المتوازي مقارنة بإصدارات PowerShell 7+ الأحدث.
• يعمل PowerShell Workflow داخليا باستخدام عمليات متعددة. ومن ثم، قد لا تتوفر الوحدات النمطية المتوفرة في عملية واحدة في عملية أخرى وتتسبب في استثناءات مثل عدم العثور على الأمر.
• يجب أن تتعامل سجلات التشغيل مع التعقيد الإضافي لسير عمل PowerShell، مثل العناصر غير المتسلسلة.
• تستغرق سجلات التشغيل وقتًا أطول لبدء تشغيلها من سجلات تشغيل PowerShell نظرًا لأنه يجب تجميعها قبل التشغيل.
• يمكنك فقط تضمين سجلات تشغيل PowerShell كسجلات تشغيل فرعية باستخدام الأمر Start-AzAutomationRunbook cmdlet.
• لا يمكن تشغيل سجلات التشغيل على Linux Hybrid Runbook Worker.

سجلات تشغيل Python

يتم تجميع دفاتر تشغيل Python ضمن Python 2.7(GA) وPython 3.8 (GA) وPython 3.10 (معاينة). يمكنك إنشاء وتحرير التعليمات البرمجية لدفتر التشغيل باستخدام محرر النص في بوابة Azure. يمكنك أيضا استخدام أي محرر نصوص دون اتصال واستيراد سجل التشغيل إلى Azure Automation.

حاليا، يتم دعم إصدار وقت تشغيل Python 3.10 (معاينة) لكل من الوظائف السحابية والمختلطة في جميع المناطق العامة باستثناء أستراليا الوسطى 2 وكوريا الجنوبية والسويد الجنوبية وJio India Central والبرازيل SouthEast ووسط الهند وغرب الهند والإمارات العربية المتحدة الوسطى وسحب Gov.

المزايا

إشعار

قد يستغرق استيراد حزمة Python عدة دقائق.

• يستخدم مكتبات Python القوية.
• يمكن تشغيلها في Azure أو في Hybrid Runbook Workers.
• بالنسبة إلى Python 2.7، يتم دعم Windows Hybrid Runbook Workers مع تثبيت python 2.7 .
• بالنسبة ل Python 3.8 Cloud Jobs، يتم دعم إصدار Python 3.8. قد تعمل البرامج النصية والحزم من أي إصدار 3.x إذا كانت التعليمة البرمجية متوافقة عبر إصدارات مختلفة.
• بالنسبة لوظائف Python 3.8 Hybrid على أجهزة Windows، يمكنك اختيار تثبيت أي إصدار 3.x قد ترغب في استخدامه.
• بالنسبة لوظائف Python 3.8 المختلطة على أجهزة Linux، نعتمد على إصدار Python 3 المثبت على الجهاز لتشغيل DSC OMSConfig وLinux Hybrid Worker. يجب أن تعمل الإصدارات المختلفة إذا لم تكن هناك تغييرات فاصلة في توقيعات الأسلوب أو العقود بين إصدارات Python 3.

القيود

فيما يلي قيود دفاتر تشغيل Python

Python 3.10 (معاينة)

• بالنسبة إلى وحدات Python 3.10 (معاينة)، حاليا، يتم دعم ملفات العجلة التي تستهدف نظام التشغيل cp310 Linux فقط. معرفة المزيد
• تكامل التحكم بالمصادر غير مدعوم.
• يتم التحقق من صحة الحزم المخصصة ل Python 3.10 (معاينة) فقط أثناء وقت تشغيل المهمة. من المتوقع أن تفشل المهمة إذا كانت الحزمة غير متوافقة في وقت التشغيل أو إذا لم يتم استيراد التبعيات المطلوبة للحزم إلى حساب التنفيذ التلقائي.
• حاليا، يتم دعم دفاتر تشغيل Python 3.10 (معاينة) فقط من مدخل Microsoft Azure. واجهة برمجة تطبيقات Rest وPowerShell غير مدعومين.

Python 3.8 (GA)

• يجب أن تكون على دراية ببرمجة Python.
• تكامل التحكم بالمصادر غير مدعوم.
• بالنسبة إلى وحدات Python 3.8 النمطية، استخدم ملفات العجلة التي تستهدف cp38-amd64.
• لاستخدام مكتبات الجهات الخارجية، يجب عليك استيراد الحزم إلى حساب Automation.
• لا يعمل استخدام Start-AutomationRunbook cmdlet في PowerShell/PowerShell Workflow لبدء تشغيل دفتر تشغيل Python 3.8. يمكنك استخدام Start-AzAutomationRunbook cmdlet من الوحدة النمطية Az.Automation أو Start-AzureRmAutomationRunbook cmdlet من الوحدة النمطية AzureRm.Automation للتغلب على هذا القيد. 
• لا يدعم Azure Automation sys.stderr.
• لا تتوفر حزمة أتمتة Python على pypi.org، لذلك فهي غير متوفرة للاستيراد على جهاز Windows.

Python 2.7

• لم يعد Python 2.7 مدعوما من قبل Python المنتج الأصل. نوصي بإنشاء دفاتر تشغيل جديدة في الإصدارات المدعومة وتحديث دفاتر التشغيل القديمة.
• يجب أن تكون على دراية ببرمجة Python.
• بالنسبة إلى وحدات Python 2.7.12 النمطية، استخدم ملفات العجلة cp27-amd6.
• لاستخدام مكتبات الجهات الخارجية، يجب عليك استيراد الحزم إلى حساب Automation.
• لا يدعم Azure Automation sys.stderr.
• لا تتوفر حزمة أتمتة Python على pypi.org، لذلك فهي غير متوفرة للاستيراد على جهاز Windows.

إصدارات Python المتعددة

ينطبق على العاملين المختلطين في Windows. بالنسبة Windows Runbook Worker، عند تشغيل دفتر تشغيل Python 2 فإنه يبحث عن متغير البيئة PYTHON_2_PATH أولاً ويتحقق من صحة ما إذا كان يشير إلى ملف صالح قابل للتنفيذ. على سبيل المثال، إذا كان مجلد التثبيت هو C:\Python2، فإنه سيتم التحقق مما إذا كان C:\Python2\python.exe يعد مسارًا صالحًا. إذا لم يتم العثور عليها، عندئذٍ فإنه يبحث عن متغير البيئة PATH للقيام بفحص مماثل.

بالنسبة ل Python 3، فإنه يبحث عن متغير env PYTHON_3_PATH أولا ثم يعود إلى متغير البيئة PATH.

عند استخدام إصدار واحد فقط من Python، يمكنك إضافة مسار التثبيت إلى المتغير PATH. إذا كنت تريد استخدام كلا الإصدارين على Runbook Worker ، فقم بتعيين PYTHON_2_PATH وPYTHON_3_PATH إلى موقع الوحدة النمطية لتلك الإصدارات.

المشكلات المعروفة

بالنسبة للوظائف السحابية، تفشل وظائف Python 3.8 في بعض الأحيان مع ظهور رسالة invalid interpreter executable pathاستثناء . قد ترى هذا الاستثناء إذا تأخرت المهمة، أو بدأت أكثر من 10 دقائق، أو باستخدام Start-AutomationRunbook لبدء تشغيل دفاتر تشغيل Python 3.8. إذا تأخرت المهمة، يجب أن يكون إعادة تشغيل سجل التشغيل كافيًا.

سجلات التشغيل الرسومية

يمكنك إنشاء سجلات تشغيل PowerShell Workflow الرسومية وتحريرها باستخدام المحرر الرسومي في مدخل Microsoft Azure. ومع ذلك، لا يمكنك إنشاء هذا النوع من سجلات التشغيل أو تحريره باستخدام أداة أخرى. السمات الرئيسية لسجلات التشغيل الرسومية :

• يتم تصديرها إلى ملفات في حسابك على Azure Automation ثم استيرادها إلى حساب Azure Automation آخر.
• إنشاء التعليمة البرمجية PowerShell.
• تم التحويل إلى أو من سجلات تشغيل PowerShell Workflow الرسومية أثناء الاستيراد.

المزايا

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

القيود

• لا يمكن إنشاء أو تحرير خارج مدخل Microsoft Azure.
• قد تتطلب نشاط التعليمات البرمجية التي تحتوي على تعليمات برمجية PowerShell لتنفيذ منطق معقد.
• لا يمكن التحويل إلى أحد تنسيقات النص، ولا يمكنك تحويل سجل تشغيل النص إلى تنسيق رسومي.
• لا يمكن عرض تعليمات PowerShell البرمجية التي ينشئها سير العمل الرسومي أو تحريرها مباشرةً. يمكنك عرض التعليمات البرمجية التي تقوم بإنشائها في أي أنشطة تعليمات برمجية.
• لا يمكن تشغيل سجلات التشغيل على Linux Hybrid Runbook Worker. راجع التشغيل التلقائي للموارد في مركز البيانات أو السحابة باستخدام Hybrid Runbook Worker.
• لا يمكن توقيع سجلا التشغيل الرسومية رقميًا.

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

• للتعرف على المزيد حول استخدام سجلات تشغيل PowerShell، راجع البرنامج التعليمي: إنشاء دفتر تشغيل PowerShell.
• للتعرف على سجلات تشغيل PowerShell Workflow، أنظر البرنامج التعليمي: إنشاء سجل تشغيل PowerShell Workflow.
• لمعرفة المزيد حول سجلات التشغيل الرسومية، راجع البرنامج التعليمي: إنشاء سجل تشغيل رسومي.
• لمعرفة المزيد حول سجلات تشغيل Python، راجع البرنامج التعليمي: إنشاء سجل تشغيل Python