فشل وحدتي Exchange Online وMicrosoft Graph معاً في Runbook واحد في Azure Automation
By Mirko Peters ·
تعمل كل وحدة على حدة، لكن الاتصال بـ Exchange Online وMicrosoft Graph في الـ Runbook نفسه يفشل بأخطاء تحميل الوحدات. تعرّف على سبب تعارض الإصدارات، وكيفية اختبار بيئة تشغيل مثبّتة الإصدار.
Automatically translated with AI from the original post. Read the English original
يتصل Runbook اختبار بـ Exchange Online باستخدام هويته المُدارة ويقرأ صندوق بريد، وهو يعمل. ويتصل Runbook اختبار ثانٍ بـ Microsoft Graph بالهوية نفسها ويقرأ مستخدماً، وهو يعمل أيضاً. ضعهما معاً في Runbook واحد فيفشل.
النقاط الرئيسية
- الأخطاء هي أخطاء تحميل وحدات، وليست أخطاء أذونات. منح صلاحيات أكثر لن يصلحها.
- حدّد حل مجتمعي مؤكد من عام 2024 السبب: تحمّل الوحدتان إصدارين مختلفين من System.Text.Json إلى عملية واحدة، والوحدة التي تُحمَّل أولاً هي التي تفوز.
- عالجت سلسلة نقاش في مارس 2026 المشكلة ببيئة تشغيل جديدة من PowerShell 7.4 وExchangeOnlineManagement 3.5.0، لكن صاحب السؤال لم يكن قد اختبر السكربت الفعلي بعد.
- تذكر Learn أن ExchangeOnlineManagement 3.10.0 فما فوق يحتاج إلى PowerShell 7.6، بينما تسرد صفحة بيئة التشغيل في Automation الإصدارين 5.1 و7.4. ثبّت إصدار الوحدة واختبر في لوحة الاختبار قبل النشر.
هذه هي سلسلة Microsoft Q&A من مارس 2026 التي تنطلق منها هذه المقالة. وهي تطابق سلسلة Tech Community أقدم من عام 2024 وصلت فعلاً إلى حل أكّده صاحب السؤال. تشرح هذه المقالة السبب، وتعرض ما تقوله Microsoft Learn عن الإصدارات وبيئات التشغيل، وتقدم خطة اختبار. وهي دليل لاستكشاف الأخطاء وإصلاحها، وليست إجراءً رسمياً من Microsoft.
الأعراض
استخدم صاحب سؤال مارس 2026 هوية مُدارة مُعيّنة للنظام، مع Connect-ExchangeOnline -ManagedIdentity -Organization <tenant>.onmicrosoft.com متبوعاً بـ Connect-MgGraph -Identity. وتم استيراد ExchangeOnlineManagement الإصدار 3.9.2 وعدة وحدات من Microsoft.Graph. وكانت الأخطاء كالتالي:
- بيئة التشغيل 5.1: تم العثور على
Connect-MgGraphفي الوحدةMicrosoft.Graph.Authentication، لكن تعذر تحميل الوحدة. - بيئة التشغيل 7.2:
Unable to find type [Microsoft.Exchange.Management.RestApiClient.ExchangeEnvironment].
أظهرت سلسلة 2024، على جهاز سطح مكتب يعمل بـ Windows PowerShell 5.1، الرسالة IDX12729: Unable to decode the header ... as Base64Url encoded string وخطأ "method not found" يذكر System.Text.Json.Utf8JsonReader. ورأى مشارك آخر في السلسلة الخطأ Connect-MgGraph: Invalid JWT access token عند استخدام Connect-IPPSSession في الجلسة نفسها.
جميع هذه الأخطاء متعلقة بالتحميل أو بوقت التشغيل. فهي ليست رسائل Authorization_RequestDenied ولا رسائل رفض الوصول. هذا الفرق مهم، لأن إجابة مولّدة بالذكاء الاصطناعي في سلسلة مارس نصحت صاحب السؤال بمنح Exchange.ManageAsApp ودور Exchange Administrator. هذه متطلبات مسبقة حقيقية، لكنها تعالج التفويض ولا يمكنها إصلاح وحدة نمطية لا يتم تحميلها.
لماذا يحدث ذلك
في سلسلة عام 2024، وُضع علامة "الحل" على ردّ من أحد أعضاء المجتمع (وهو Silver Contributor وليس موظفًا في Microsoft). ذكر الردّ أن الوحدتين النمطيتين تحمّلان كل منهما نسختها الخاصة من System.Text.Json.dll في عملية PowerShell نفسها. أما Exchange Online 3.5.1 فشحن الإصدار 8.0.x، بينما استخدم Microsoft.Graph.Authentication الإصدار 6.0.x. يحتفظ PowerShell بنسخة واحدة فقط من أي تجميع (assembly) لكل عملية، لذا فإن الوحدة التي تُحمَّل أولًا هي التي تنتصر، وقد تفشل الثانية.
أزال صاحب السؤال في تلك السلسلة وحدات Graph قبل الاتصال، وحدّث الوحدتين النمطيتين، ومسح ذاكرة التخزين المؤقت لـ MSAL. ولم يُجدِ أيٌّ من ذلك نفعًا. وبعد الرجوع إلى ExchangeOnlineManagement 3.4.0، كتب صاحب السؤال أن الأمر نجح. وأبلغ مشاركون آخرون عن الحل نفسه. وأبلغ مشارك آخر عن تحسّن مع الإصدار 3.6.0، لكن Connect-IPPSSession المعتمد على الشهادات ظل يفشل بالنسبة له. وأبلغ أحد المشاركين أن ضبط -LogLevel على Default بدلًا من All أصلح المشكلة في اختباره. ولا تذكر Learn هذا الإعداد، لذا تعامل معه بوصفه تقريرًا من المجتمع.
قدّم مشرف متطوع (وهو MVP) في سلسلة عام 2026 شرحًا مشابهًا. فالوحدات النمطية تعتمد على ملفات ثنائية إضافية غير متوافقة بين الفرق، لذا قد تحتاج إلى خلط إصدارات الوحدات النمطية ومضيفات PowerShell.
لا تصف Learn تعارض System.Text.Json. لكنها تذكر في ملاحظات إصدار ExchangeOnlineManagement 3.6.0 بندًا نصه ""Added fix for compatibility issue with the Microsoft.Graph module""، دون أي تفاصيل.
الخطوة 1: تحقّق من نوع الخطأ الذي تواجهه
- شغّل كل اتصال على حدة في Runbook تجريبي. إذا عمل كلاهما منفردًا، فأنت أمام تعارض وليس مشكلة أذونات.
- انسخ السطر الأول من الخطأ. أي رسالة تتعلق بتحميل وحدة نمطية أو نوع أو طريقة فهي تعارض. أما
ForbiddenأوAccess deniedأوAuthorization_RequestDeniedفهي مشكلة أذونات. - في حالة مشكلات الأذونات، اتبع صفحة Learn الخاصة بالهويات المُدارة لـ Exchange. تتطلب الصفحة منح الهوية إذن واجهة برمجة التطبيقات
Exchange.ManageAsAppودورًا في Entra مثل Exchange Administrator. وتنص ملاحظة Learn على أن دور Security Administrator لا يملك الأذونات اللازمة لهذه المهام.
الخطوة 2: تحقّق من إصدار التجميع الذي تطلبه كل وحدة نمطية
اقترحت سلسلة عام 2024 التحقق من إصدار التجميع المحمّل في جلسة جديدة، وحدة نمطية واحدة في كل مرة. ولا يُظهر ملخص السلسلة الأمر الدقيق. الأمر أدناه فحص عام لـ .NET وليس من Learn ولا من السلسلة، لذا اختبره على جهاز احتياطي. استورد وحدة نمطية واحدة، ثم شغّل:
``powershell (Get-Item -Path "$([System.Text.Json.Utf8JsonReader].Assembly.Location)").VersionInfo ``
كرّر العملية في جلسة جديدة مع الوحدة الأخرى. إذا اختلفت الإصدارات، فأنت أمام التعارض المذكور في تلك السلسلة. واستخدم إصدارات الوحدات النمطية نفسها الموجودة في Runbook.
الخطوة 3: ثبّت الإصدارات في بيئة تشغيل منفصلة
نجح صاحب سؤال مارس 2026 في اختبار الحالة بإنشاء بيئة تشغيل جديدة. ولا تذكر السلسلة الخطوات بالنقر، لكن صفحة Learn الخاصة ببيئة التشغيل تذكرها:
- في مدخل Azure، افتح حساب Automation. في صفحة Overview، حدّد Try Runtime Environment experience إذا لم تكن فيها بالفعل.
- ضمن Process Automation، حدّد Runtime Environments، ثم Create.
- في علامة التبويب Basics، أدخل اسمًا، واختر PowerShell كلغة و7.4 كإصدار بيئة التشغيل. تقول Learn إنه لا يمكن تغيير اللغة والإصدار لاحقًا.
- في علامة التبويب Packages، تُضاف حزمة Az تلقائيًا. استخدم Add from gallery لإضافة ExchangeOnlineManagement بإصدار مثبّت، وكذلك وحدات Microsoft.Graph التي تستدعيها. استخدمت السلسلة الإصدار 3.5.0 لـ Exchange Online.
- اختر إنشاء.
- اربط نسخة من Runbook الخاص بك. ضمن Runbooks، حدّده، ثم اختر Update Runtime Environment.
- افتح Runbook، ثم Edit in Portal، واختر البيئة الجديدة، ثم Test pane وStart. انشر فقط إذا نجح الاختبار.
تشير وثائق Learn إلى أن استيراد الحزمة قد يستغرق عدة دقائق، وأنه يمكن إضافة ما يصل إلى 10 حزم في كل مرة، وأن لوحة الوحدات تُستبدل ببيئات وقت التشغيل في التجربة الجديدة.
يعتمد الإصدار الذي تثبّته على بيئة وقت التشغيل:
- تذكر وثائق Learn أن ExchangeOnlineManagement 3.10.0 والإصدارات الأحدث تتطلب PowerShell 7.6.0 أو أحدث بسبب اعتمادات الـ assembly على .NET 10. وتذكر صفحة بيئة وقت التشغيل الخاصة بها الإصدارين 5.1 و7.4 كخيارين. لذلك تحتاج بيئة وقت التشغيل 7.4 إلى إصدار أقدم من 3.10.0. هذا استنتاج مستخلص من صفحتين في Learn، وليس بيانًا صريحًا في أي منهما، لذا تحقق مما يوفره حسابك فعلًا.
- تسرد وثائق Learn مشكلات تخص الإصدارات من 3.7.0 إلى 3.9.2 على Ubuntu 20.04 و18.04، وتذكر 3.9.2 كأحدث إصدار لبعض المنصات الأقدم. وهذه الملاحظات تخص منصات سطح المكتب، وليس Automation.
- استخدم الاختبار الوارد في خيط مارس نفسه الإصدار 3.5.0 على 7.4. وأضاف صاحب السؤال تعليقًا يفيد بأن السكربت الفعلي لم يُختبر بعد، لذلك لا توجد إجابة مؤكدة للإصدارات 3.9.x على 7.4.
- لم تتجنب بيئة وقت التشغيل 5.1 التعارض في خيط مارس، إذ فشل التشغيل على 5.1 مع الإصدار 3.9.2.
اختبر تركيبتين على الأقل، مثل إصدار Exchange المثبّت لديك مع أحدث وحدات Graph، ومع إصدار Graph أقدم. وتحذّر Learn من أن إصدارات المعاينة من PackageManagement أو PowerShellGet قد تسبب مشكلات في الاتصال، لذا استخدم الإصدارات المُصدرة رسميًا.
الخطوة 4: فكّر في تقسيم العمل
إذا لم تنجح أي تركيبة، فتجنّب تحميل الوحدتين في العملية نفسها. على سبيل المثال، اجعل أحد runbooks يتولى جزء Exchange، واجعل runbook آخر يتولى جزء Graph، وابدأ الثاني من الأول. يستند هذا إلى السبب الوارد في خيط 2024. ولم يختبر أي من الخيطين هذا الحل، لذا ابنِ نموذجًا صغيرًا لإثباته أولًا.
تحقق أيضًا مما إذا كان بإمكان Graph أن يحل محل cmdlets الخاصة بـ Exchange في السكربت. وتوضح صفحة Exchange في Learn ذلك لأربعة cmdlets خاصة بمجموعات Microsoft 365، مثل New-UnifiedGroup، وتذكر أنها لا يمكن استخدامها مع الهوية المُدارة، وأنها توصي باستخدام Graph بدلًا منها. أما في المهام الأخرى، فلا تفترض وجود مكافئ في Graph.
التحقق
- في لوحة الاختبار، يُظهر إخراج المهمة الاتصالين، ونتيجة واحدة من كل خدمة.
- شغّل runbook المنشور عبر جدول زمني أو بدء يدوي، وتحقّق من سجلات المهمة بحثًا عن تحذيرات تتعلق بتحميل الـ assemblies.
- دوّن إصدارات الوحدات الدقيقة وبيئة وقت التشغيل. قد يؤدي تحديث لاحق في المعرض إلى تعطيل إعداد كان يعمل. ولا يحميك التثبيت إلا طالما لم تغيّر الإصدارات.
القيود
- خيط 2024 أقدم من النافذة المعتادة، واستخدم Windows PowerShell على سطح المكتب. وقد أُدرج لأنه يذكر السبب ويتضمن نتيجة مؤكدة.
- الحل الوارد في خيط 2026 هو اختبار أولي، وليس إصلاحًا موثّقًا للإنتاج.
- لا تزال صفحة الهوية المُدارة لـ Exchange في Learn تذكر بيئتي وقت التشغيل 5.1 و7.1 (المعاينة) عند إضافة الوحدة، وهذا يختلف عن صفحة بيئة وقت التشغيل. استخدم صفحة بيئة وقت التشغيل للاطلاع على بيئات التشغيل الحالية.
- لا توثّق Learn المشكلة نفسها. ويأتي السبب من خبير في المجتمع.
ذات صلة
المصادر
- Microsoft Learn: وحدة Exchange Online PowerShell (الإصدارات والمتطلبات)
- Microsoft Learn: استخدام الهويات المُدارة في Azure للاتصال بـ Exchange Online PowerShell
- Microsoft Learn: إدارة بيئات وقت التشغيل في Azure Automation
- Microsoft Learn: أوامر المصادقة في Microsoft Graph PowerShell
- Microsoft Q&A: تعذّر الاتصال بـ Exchange Online وGraph في الـ runbook نفسه (مارس 2026)
- Microsoft Community Hub: تداخل Exchange online وMGGraph (2024)