أخطاء SPMT وMigration Manager: قائمة تحقق للنقاط النهائية والمساحة على القرص والفحص
By Mirko Peters ·
هل يُبلغ SPMT عن نقص في مساحة القرص، أم يُظهر وكيل Migration Manager الحالة Connected لكنه لا يستطيع الفحص؟ تحقّق من النقاط النهائية المطلوبة، ومجلد العمل المحلي، والتخزين الوجهة، وإعدادات الوكيل بهذا الترتيب.
Automatically translated with AI from the original post. Read the English original
قد يعمل ترحيل مشاركة ملفات أو SharePoint محلي بسلاسة لأسابيع. ثم تفشل مكتبة برسالة عن نقص مساحة القرص، أو يرفض جدار حماية نقطة نهائية، أو يبقى وكيل Migration Manager على الحالة "Connected" ويرفض الفحص. تعرض أربعة نقاشات مجتمعية من Microsoft، تمتد من أواخر 2025 إلى أواخر 2026، هذه الحالات. ولا يحمل سوى واحد منها ردًا مُعلَّمًا كحل، لذلك يجمع هذا المقال بينها وبين صفحات Learn الحالية. وهو دليل لاستكشاف الأخطاء وإصلاحها، وليس إجراءً رسميًا من Microsoft.
النقاط الرئيسية
- اسمح بالقوائم الكاملة للنقاط النهائية من Microsoft Learn، بما في ذلك api.office.com لـ SPMT ونقاط الفحص لـ Migration Manager. ويَنصح أحد النقاشات بالقيام بذلك عبر اسم المضيف، لا عبر عنوان IP.
- قد يحتاج جدار الحماية الذي يرفض إدخالًا يتضمن https:// إلى اسم المضيف فقط في كائن FQDN، كما ورد في نقاش عُلِّم فيه هذا الحل.
- تشير أخطاء مساحة القرص الخاصة بـ SPMT التي توثقها Learn إلى مجلد العمل المحلي. لذا تحقّق أولًا من المساحة الحرة على جهاز الترحيل، ثم من تخزين موقع الوجهة.
- لم تتوفر في النقاشات أي معالجة مؤكدة لحالة "Cannot scan" مع وكيل متصل. وكان لدى أحد السائلين طلب دعم فني صنّفته Microsoft مشكلة معروفة.
- احتفظ بتقرير الفشل ورمز الخطأ الدقيق والوقت (UTC) جاهزًا، لأن معظم النقاشات انتهت بعبارة "افتح طلب دعم فني".
كيف تبدو الأعراض
- النقطة النهائية: يرفض جدار الحماية على جهاز SPMT الإدخال
https://api.office.comبوصفه إدخالًا غير صالح. كان صاحب المنشور قد قرأ أن الواجهة مهجورة، إلا أن صفحة متطلبات SPMT المسبقة ما زالت تدرجها (أغسطس 2026). - مساحة القرص: يفشل ترحيل من SharePoint 2019 إلى SharePoint Online لمكتبتين برسالتي "There isn't enough disk space in the target site collection" و"Not all the items in the package have been migrated". ويقول صاحب المنشور إن الوجهة تتسع بمساحة كبيرة (أغسطس 2026).
- Cannot scan: يُظهر وكيل Migration Manager الحالة Connected مع "Cannot scan". كانت عمليات الترحيل تعمل حتى منتصف سبتمبر. ولم تُجدِ إعادة تثبيت الوكيل نفعًا، ورأى السائل طلبات SSL فاشلة إلى نقاط نهاية الترحيل من Microsoft (أكتوبر 2026).
- تسجيل الدخول بالشهادة: بعد إعادة تثبيت الوكيل باستخدام المصادقة المعتمدة على الشهادات، يظهر الزر Add Source Path في تبويب الفحص معطّلًا، ويكرر سجل الوكيل الرسالة
token_not_found(نوفمبر 2025).
الخطوة 1: تحقّق من النقاط النهائية
تُدرج Learn نقاط نهاية الأداتين كعناوين URL من نوع HTTPS. وبالنسبة إلى Migration Manager، تذكر الصفحة أن العامل يرسل طلبات إلى نقاط النهاية هذه ويتلقى ردودها، وأن نقاط النهاية لا يمكنها استدعاء Migration Manager مطلقًا، وأن العامل لا يفتح أي منفذ للاتصالات البعيدة.
بالنسبة إلى SPMT، تسرد صفحة المتطلبات الأساسية في Learn، ضمن عناصر أخرى، ما يلي:
- المصادقة:
login.microsoftonline.com،login.windows.net،aadcdn.msftauth.net،aadcdn.msauth.net،secure.aadcdn.microsoftonline-p.com - واجهات برمجة التطبيقات لنقل المحتوى والتحقق منه:
api.office.comوgraph.windows.net - قوائم انتظار الترحيل والتخزين في Azure:
.queue.core.windows.netو.blob.core.windows.net - الوجهة:
*.sharepoint.com - Graph للحصول على معلومات المستأجر والموقع:
graph.microsoft.com
بالنسبة إلى Migration Manager، تضيف صفحة المتطلبات الأساسية في Learn نقاط نهاية متعلقة بالفحص، مثل api.mmp.svc.cloud.microsoft وodyssey.mmp.svc.cloud.microsoft وodyssey.prod.migrations.microsoft.com، إلى جانب عدة مضيفات SignalR. وتُدرج الصفحة أيضًا api.prod.migrations.microsoft.com كمتطلب لواجهة الويب الخاصة بـ Migration Manager. انسخ القائمة الحالية من الصفحة دائمًا، لأنها تتغير. كما تذكر مقدمة الصفحة production.odyssey.ops.mover.io لاتصالات SignalR، وهذا المضيف غير وارد في جدولها، لذا اقرأ النص المحيط بالجدول.
تقدم الإجابة المعلَّمة كحل في سلسلة api.office.com النصيحة التالية:
- لا تعتبر رفض الجدار الناري لعنوان ما دليلًا على أن نقطة النهاية غير مطلوبة.
- اسمح باسم المضيف عبر TCP 443 من جهاز الترحيل، واستخدم قواعد تعتمد على DNS بدلًا من عناوين IP. هذه نصيحة من السلسلة. أما Learn فلا يذكر أي منفذ.
- إذا رفض حقل الجدار الناري الإدخال، فأدخل اسم المضيف فقط في كائن FQDN. قد تكون البادئة
https://هي ما يرفضه الحقل. هذا الجزء نصيحة من السلسلة وليس من Learn. - اختبر تحليل أسماء النطاقات واتصال TLS الصادر من جهاز الترحيل، ثم أعد تشغيل الفحص.
اختبار سريع من جهاز الترحيل:
``powershell Test-NetConnection api.office.com -Port 443 Test-NetConnection odyssey.prod.migrations.microsoft.com -Port 443 ``
لا يمكن اختبار حرف البدل مثل *.blob.core.windows.net كما هو مكتوب، لذا اختبر اسم مضيف حقيقي من المستأجر بدلًا منه. كما تطلب إجابة في سلسلة "Cannot scan" استبعاد الوكيل أو الجدار الناري أو فحص SSL أو تغييرات الشهادات بين العامل وهذه المضيفات. لم أجد ذكرًا لفحص SSL في صفحتي المتطلبات الأساسية، لذا تعامل مع هذه النقطة كاقتراح من المجتمع.
الخطوة 2: التحقق من المساحة الحرة على جهاز الترحيل
بالنسبة إلى SPMT، توثّق صفحة استكشاف الأخطاء وإصلاحها في Learn الأخطاء التالية:
- "Scan File Failure: Not enough disk space to pack the file": مساحة القرص المخصصة لمجلد العمل الخاص بالترحيل صغيرة جدًا بالنسبة إلى حجم ملف المصدر. وسّع مجلد العمل وأعد المحاولة.
- Error 0x02040012: التخزين المؤقت المحلي على الجهاز منخفض جدًا، لأن SPMT يخزّن الحزمة مؤقتًا في مجلد العمل. وسّع التخزين المؤقت وأعد المحاولة.
توصي Learn بمساحة تخزين محلية حرة تبلغ 150 GB للجهاز الذي يشغّل SPMT، سواء في ملف الأجهزة الموصى به أو في الحد الأدنى. تحقق من قرص النظام ومن القرص الذي يقع عليه مجلد العمل. ويُذكر مجلد العمل %appdata%\Microsoft\MigrationToolStorage في صفحة استكشاف الأخطاء، وتنص عدة أخطاء فيها على ضرورة بقاء ملفاته ومجلداته مغلقة أثناء الترحيل.
في سلسلة SharePoint 2019، قال رد من عضو في المجتمع يحمل لقب MVP إن الرسالة تشير على الأرجح إلى التخزين المؤقت المحلي، وليس إلى حدود SharePoint Online. وتسرد صفحة Learn الأخطاء المحلية أعلاه، ولا تذكر نص "target site collection" بالضبط. لذلك يُعد الفحص المحلي أفضل خطوة أولى مدعومة بالأدلة.
الخطوة 3: التحقق من الموقع الهدف وتخزين المستأجر
قال رد آخر في السلسلة نفسها إن الرسالة الثانية، "Not all the items in the package have been migrated"، ربما تكون أثرًا جانبيًا للخطأ الأول. واقترح التحقق من حد التخزين لموقع الوجهة (في مركز إدارة SharePoint ضمن المواقع النشطة)، ومن إجمالي تخزين المستأجر، ومن الإصدارات القديمة ومحتوى سلة المحذوفات. لم يُعلَّم هذا الرد ولا الرد الآخر كحل، ولم يُبلغ صاحب المنشور عن أي نتيجة.
إذا كان الهدف ممتلئًا، فضع في اعتبارك ما تذكره Learn عن التخزين: قد تتأخر تقارير الاستخدام بما يصل إلى 48 ساعة، وفي وضع التخزين اليدوي يكون لكل موقع حدّه الخاص.
أما بخصوص "عدم ترحيل جميع العناصر"، فإن صفحة استكشاف الأخطاء وإصلاحها في Learn تذكر الخطأ 0x01710009 مرتين: مرة بالنص "Errors or time-out for Server Processing the file: Not all the items in the package are migrated"، ومرة كفشل ناتج عن أخطاء إنهاء المهمة، حيث فشلت بعض العناصر في الحزمة، مع توصية بإعادة تشغيل الترحيل. أما بالنسبة إلى التبعيات المفقودة على عناصر القائمة (الخطأ 0x01410010)، فتحقق من FailureSummaryReport.csv وتأكد من أن التبعيات ضمن نطاق الترحيل. ويقترح الموضوع أيضًا إعادة محاولة مكتبة واحدة فشلت بدفعات أصغر، ثم تشغيل ترحيل تزايدي لالتقاط العناصر المفقودة. وهذا اقتراح من المجتمع، وليس خطوة من Learn.
الخطوة 4: تحقق من وكيل Migration Manager
تغطي صفحة استكشاف أخطاء Migration Manager وإصلاحها في Learn بعض حالات الوكيل التي ليست "Cannot scan" لكنها تشبهها:
- انقطاع اتصال الوكيل: تشمل الأسباب المحتملة سلامة الشبكة على حاسوب الوكيل، أو تغيير كلمة المرور أو تغييرًا حرجًا مشابهًا لحساب مسؤول المستأجر (وعندئذٍ يجب إعادة تثبيت جميع الوكلاء)، أو فشل الترقية التلقائية، أو انتهاء صلاحية الرمز المميز.
- بقاء الفحص في حالة Queued: يمكن جدولة الوكلاء الموجودين في مجموعة الوكلاء Default فقط. وإذا لم يكن أي وكيل في تلك المجموعة، فغيّر مجموعة الوكيل إلى Default.
- تعذّر إرسال مهمة (0x01610002): توصي الصفحة بإضافة استثناءات لبرنامج مكافحة الفيروسات للملفين
microsoft.sharepoint.migration.clientservice.exeوmicrosoft.sharepoint.migration.mthost.exe.
في موضوع "Cannot scan"، ذكر أحد الردود خطوات إعداد الوكيل من Microsoft وسأل عما إذا كانت جميع المشاركات متأثرة أم بعضها فقط. وقدّم رد مُنشأ تلقائيًا في الموضوع نفسه اقتراحًا بتعديل ملف إعداد للوكيل. مثل هذه الردود ليست دليلًا، ولم أجد شيئًا مشابهًا في صفحات Learn، لذا لا تطبّق هذا التغيير دون بيان من Microsoft. كتب صاحب السؤال أن مهندس دعم أخبره بأنها مشكلة معروفة يجري العمل على حلها، لكن موظفي Microsoft لم يؤكدوا ذلك في الموضوع. إذا كانت أعراضك مطابقة، فتواصل مع الدعم مبكرًا.
الخطوة 5: تسجيل دخول الوكيل بالشهادة
لا يتضمن موضوع الشهادة أي حل مؤكد. أشار مشرف من موظفي Microsoft إلى ملف إعداد الشهادة المفقود أو غير المكتمل بوصفه سبب ظهور token_not_found، وطلب التحقق من أذونات التطبيق. وأجاب صاحب السؤال بأنه تحقق من الملف وأعاد تثبيت الوكيل مرات عديدة. ثم اقترح المشرف فحوصات نقاط النهاية ومنح التطبيق صلاحية Read على موقع المسؤول، وأفاد صاحب السؤال بأن اختبارات نقاط النهاية نجحت وبقيت المشكلة قائمة. واقترح آخر تعليق للمشرف استخدام Microsoft Service Hub إذا استمرت المشكلة. ولا يوجد أي رد يؤكد الحل. لم أتمكن من التحقق من صيغة الملف أو الأذونات في صفحات Learn التي قرأتها، لذا استخدم صفحة إعداد Migration Manager الرسمية الخاصة بمصادقة الشهادة، ولا تعتمد على الموضوع.
الخطوة 6: اجمع الأدلة
تذكر Learn مواقع السجلات التالية لـ Migration Manager: %AppData%\Microsoft\SPMigration\Logs للمهام الفاشلة، والمجلد Migration\MigrationTool[tenant_site] ضمن %AppData%\Microsoft\SPMigration\Logs لتقرير المهمة المكتملة (أو ضمن مجلد العمل المخصص لديك). رتّب المجلدات الفرعية حسب وقت التعديل، وافتح المجلد الأقرب إلى وقت بدء المهمة. لا تسرد صفحة SPMT مجلدات السجلات الخاصة بها، لذا افتح تقرير المهمة الفاشلة داخل الأداة (كما يقترح أحد الردود). دوّن أول عنصر فشل، ورمز الخطأ، ومعرّف الارتباط (Correlation ID)، والوقت بالتوقيت العالمي UTC، وأضف عنوان URL لموقع الوجهة.
الحدود والنقاط المفتوحة
- السؤال المتعلق بنقاط النهاية هو الوحيد الذي يحمل حلًا معلَّمًا، وحتى هنا لم يكتب صاحب السؤال أي تأكيد.
- مواضيع مساحة القرص و"Cannot scan" والشهادة لم تُحل بعد. تعامل مع الخطوات الخاصة بها بوصفها قائمة تحقق لتضييق نطاق المشكلة.
- تُظهر صفحة متطلبات Migration Manager المسبقة تاريخ تحديث مرئيًا هو يوليو 2025. قارنه بما تطلبه البوابة اليوم.
ذات صلة
المصادر
- Microsoft Learn: المتطلبات المسبقة لـ SPMT ونقاط النهاية المطلوبة
- Microsoft Learn: استكشاف مشكلات SPMT الشائعة وإصلاحها
- Microsoft Learn: المتطلبات المسبقة لـ Migration Manager ونقاط النهاية
- Microsoft Learn: استكشاف أخطاء ترحيل الملفات باستخدام Migration Manager وإصلاحها
- Microsoft Community Hub: مشكلة في SharePoint Migration Tool (أغسطس 2026)
- Microsoft Community Hub: المساعدة بخصوص خطأ SPMT (أغسطس 2026)
- Microsoft Q&A: ترحيل Microsoft 365 - تعذّر الفحص (أكتوبر 2026)
- Microsoft Q&A: زر Add Source Path معطّل في Migration Manager مع مصادقة الشهادة (نوفمبر 2025)