تقليص إصدارات ملفات SharePoint باستخدام حدود العدد: ما الذي يعنيه MajorWithMinorVersionsLimit فعلًا
By Mirko Peters ·
أدت مهمة تقليص بالمعاملين -MajorVersionLimit 100 و-MajorWithMinorVersionsLimit 5 إلى بقاء كل الإصدارات الثانوية في مكانها. فيما يلي كيف تصف Microsoft المعاملين، وكيف تُنفَّذ مهمة تقليص آمنة، وما الذي يبقى غامضًا.
Automatically translated with AI from the original post. Read the English original
أراد مسؤول SharePoint خفض مساحة التخزين عبر تقليص إصدارات الملفات في جميع المواقع. فشغّل سكربتًا يقرأ عناوين المواقع من ملف CSV ويستدعي New-SPOSiteFileVersionBatchDeleteJob مع -MajorVersionLimit 100 و-MajorWithMinorVersionsLimit 5. وكان المتوقع: الاحتفاظ بآخر 100 إصدار رئيسي وبآخر 5 إصدارات ثانوية لكل إصدار رئيسي. أما ما حدث فعلًا فهو أن الإصدارات الرئيسية قُلِّصت، لكن بقيت كل الإصدارات الثانوية للإصدارات الرئيسية المتبقية.
النقاط الرئيسية
- تصف Microsoft Learn المعامل -MajorWithMinorVersionsLimit بأنه عدد الإصدارات الرئيسية التي تُحفظ لها جميع الإصدارات الثانوية، وليس حدًا لعدد الإصدارات الثانوية نفسها.
- يجب تحديد المعاملين معًا، ويستخدم برنامج Learn التعليمي القيمة -MajorWithMinorVersionsLimit 0 عندما يُراد احتساب الإصدارات الرئيسية فقط.
- تُحذف الإصدارات المقلَّصة نهائيًا ولا تمر عبر سلة المحذوفات، لذلك شغّل تحليل what-if أولًا، واختبر على موقع واحد.
- تعمل مهام التقليص في الخلفية على دفعات خلال الأيام التالية، ويمكنك التحقق منها أو إلغاؤها باستخدام أوامر التقدم والإزالة.
- لا تذكر Learn كيفية التعامل مع الملفات التي تملك إصدارات ثانوية فقط (مثل 0.192)، لذا تحقق من هذه الحالة على مكتبة اختبار.
نُشر هذا السؤال في Microsoft Community Hub في فبراير 2026، ولم تُنشر له إجابة. لا تدّعي هذه المقالة حل المسألة، بل توضح ما تقوله Microsoft Learn عن المعاملين، وتقدم طريقة حذرة لتنفيذ التقليص، وتحدد النقاط التي تترك فيها الوثائق والنقاش فجوة. وهي ليست إجراءً رسميًا من Microsoft.
ما الذي توثّق له المعاملان
تعرض صفحة Learn بعنوان "Trim existing versions" أمر وضع حدود العدد على النحو التالي: New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. ويقول النص التوضيحي للمعامل الثاني "number of major versions for which all minor versions will be kept". وتستخدم صفحة Learn الخاصة بحدود إصدارات المكتبة عبارات شبه متطابقة للأمر Set-SPOListVersionPolicy: عدد الإصدارات الرئيسية التي تُحفظ لها جميع الإصدارات الثانوية.
تذكر الصفحة أيضًا أن وضع حدود العدد اليدوي يحذف أقدم الإصدارات التي تتجاوز حد العدد المحدد.
ثلاثة تفاصيل أخرى من الوثائق:
- في مرجع الأوامر، تتطلب صيغة حدود العدد وجود كل من
-MajorVersionLimitو-MajorWithMinorVersionsLimit. وتذكر كل صفحة أنك تحتاج إلى المعامل الآخر أيضًا. - يعرض برنامج Learn التعليمي "Queue a trim job" الأمر
-MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0، ويصفه بأنه احتفاظ بـ 100 إصدار رئيسي. - يستخدم مثال مرجع الأوامر القيم
-MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10.
أقرأ هذه الصياغة على أن الرقم الثاني ليس "عدد الإصدارات الثانوية المراد الاحتفاظ بها". الأقرب إلى المقصود هو "لعدد كم من الإصدارات الرئيسية تريد الاحتفاظ بكل إصدار ثانوي". هذه القراءة تختلف عما كان صاحب السؤال يتوقعه. كما أنها لا تفسر نتيجته بالكامل. فمع القيمة 5 تتوقع أن تبقى جميع الإصدارات الثانوية لعدد محدود فقط من الإصدارات الرئيسية، لا لكل إصدار رئيسي محفوظ. لا تصف صفحات Microsoft النمط الدقيق، لذلك لا أستطيع الجزم بما إذا كان صاحب السؤال قد لاحظ تأخيرًا، أو قاعدة مختلفة، أو خللًا. ويبقى هذا الأمر مفتوحًا.
الخطوة 1: حدِّد وضع التقليم الذي تحتاجه
تصف Learn ثلاثة أوضاع تقليم للإصدارات الموجودة:
- العمر: يحذف
-DeleteBeforeDays <days>الإصدارات الأقدم من عدد الأيام الذي تحدده. - حد العدد:
-MajorVersionLimitو-MajorWithMinorVersionsLimit، كما ورد أعلاه. - تلقائي: يطبّق
-Automaticمنطق إعداد الإصدارات التلقائي على الإصدارات الموجودة.
تنصح صفحة Learn حول حدود سجل الإصدارات بإعداد Automatic لتحسين تخزين الإصدارات. وتذكر أن هذا الإعداد يجمع بين قيمة الاسترداد من سجل الإصدارات وانخفاض استهلاك التخزين، دون الحاجة إلى تخمين حدود العدد أو العمر. وتقول صفحة تخزين إصدارات الخطة إن Automatic يحتفظ بالإصدارات التي أُنشئت خلال أول 30 يومًا (ضمن حد عدد يبلغ 500)، ثم يخفف عددها تدريجيًا إلى إصدارات بالساعة واليوم والأسبوع كلما تقدمت في العمر.
في التقليم القائم على العمر، تذكر Learn حدّين. لا تحذف المهمة الإصدارات التي أُنشئت خلال آخر 30 يومًا، لذلك يجب أن تكون القيمة المدخلة 30 يومًا على الأقل. كما تحذف دائمًا جميع الإصدارات التي أُنشئت قبل 1 يناير 2023، لذلك يجب أن ينتج عدد الأيام الذي تختاره تاريخًا بعد هذا التاريخ. تحقق من الصفحة الحالية قبل الاعتماد على هاتين النقطتين.
الخطوة 2: أنشئ التقرير وشغّل تحليل "ماذا لو"
تطلب صفحة التقليم في Learn تشغيل تحليل "ماذا لو" قبل التقليم (ويسميه درس queue-a-job اختياريًا). تصف الدروس تقرير استخدام تخزين الإصدارات للموقع أو المكتبة، والذي تنزّله بصيغة CSV. ثم تشغّل نصًا برمجيًا على التقرير باستخدام PowerShell 7. في حالة حد العدد، يقبل نص "ماذا لو" في الدرس المعاملات -ImportPath و-ExportPath و-MajorVersionLimit. ولا يقبل حدًا لعدد الإصدارات الثانوية. لذلك لا تمثل نتيجة "ماذا لو" لحالة حد العدد سوى حد الإصدارات الرئيسية.
لا تسمي صفحات الدروس الأمر الذي ينشئ التقرير، لذا اتبع درس Learn لهذه الخطوة. تذكر Learn أن مهمة التقليم قد تستغرق عدة أيام حسب حجم المكتبة. ولا يحدد درس "ماذا لو" أي مدة.
الخطوة 3: أدرج المهمة على موقع واحد أولًا
سجّل الدخول بصفته SharePoint Administrator باستخدام SharePoint Online Management Shell الحالي، ثم أدرج مهمة لموقع اختبار واحد:
``powershell New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``
لمكتبة واحدة، استخدم النسخة الخاصة بالمكتبة:
``powershell New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``
تحذّر Learn من أن الإصدارات المحذوفة بهذه الطريقة تُحذف نهائيًا ولا تنتقل إلى سلة المحذوفات. كما تدرج مرجعية الأوامر المعاملين -WhatIf و-Confirm ضمن المعاملات. وتصف المرجعية -WhatIf بأنه يعرض ما سيحدث إذا تم تشغيل الأمر فقط، دون تفاصيل عن مخرجاته لهذه الأوامر، لذا لا تعتبره بديلًا عن تحليل "ماذا لو" القائم على التقرير.
الخطوة 4: راقب المهمة
مهام التقليم غير متزامنة. وبحسب Learn، يتم الحذف على دفعات خلال الأيام القادمة، ويؤثر الحجم وصحة الخدمة وعبء العمل في المزرعة على التوقيت. تحقق من مهمة على مستوى الموقع باستخدام:
``powershell Get-SPOSiteFileVersionBatchDeleteJobProgress -Identity https://contoso.sharepoint.com/sites/site1 ``
بالنسبة إلى مهمة مكتبة، تدرج صفحة التقليم في Learn الأمر Get-SPOListFileVersionBatchDeleteJobProgress -Site <url> -List <name>.ولإيقاف المهمة، استخدم Remove-SPOSiteFileVersionBatchDeleteJob أو Remove-SPOListFileVersionBatchDeleteJob. يوقف الإلغاء الحذف اللاحق، لكنه لا يستعيد الإصدارات التي حُذفت بالفعل.
لا تتوقع أن يتغير تقرير التخزين فورًا. تذكر صفحة Learn حول حدود تخزين المواقع أن استخدام التخزين لا يشمل التغييرات التي تمت خلال آخر 24 إلى 48 ساعة.
الخطوة 5: تعيين حدود للإصدارات الجديدة
تعالج مهمة التقليم الإصدارات الموجودة حاليًا فقط. للتحكم في الإصدارات المستقبلية، عيّن نهج الإصدارات على الموقع أو المكتبة:
- الموقع:
Set-SPOSite -Identity <url> -EnableAutoExpirationVersionTrim $trueللحدود التلقائية. تذكر Learn المعاملين-ApplyToNewDocumentLibrariesو-ApplyToExistingDocumentLibrariesلاختيار النطاق. - المكتبة:
Set-SPOListVersionPolicy -Site <url> -List <name> -EnableAutoExpirationVersionTrim $true.
إن تعيين نهج على موقع أو مكتبة لا يقلّم الإصدارات الموجودة مسبقًا، لذا أضف مهمة تقليم لتلك الإصدارات. تُعالج التغييرات على المكتبات الموجودة في مهمة خلفية، وتذكر Learn أنها قد تستغرق حتى 24 ساعة. وتضيف Learn أنه عند خفض حد العدد على مكتبة، تُقلَّم الإصدارات الموجودة التي تتجاوز الحد الجديد تدريجيًا، بما يصل إلى 20 إصدارًا مع كل إصدار جديد يُنشأ. ولا يقبل مركز الإدارة UI أقل من 100 إصدار رئيسي أو مدة انتهاء أقصر من 30 يومًا. وتذكر Learn أن القيم الأقل ممكنة عبر واجهات برمجة التطبيقات العامة، لكنها غير مُوصى بها لأنها قد تؤدي إلى فقدان بيانات غير مقصود.
الخطوة 6: التقليم على مستوى المستأجر
تذكر Learn أوامر cmdlets على مستوى المستأجر مثل New-SPOTenantApplyFileVersionPolicyJob (مع -CollectVersionData و-TrimVersions و-SetVersionPolicy). وهي في المعاينة العامة، وتتطلب ترخيص SharePoint Advanced Management أو ترخيص Copilot، وتستثني المواقع للقراءة فقط والمقفلة والمؤرشفة. ولا يمكن تشغيل سوى مهمة مستأجر واحدة في كل مرة. إذا كنت تدير مواقع كثيرة، فقارن هذا المسار بحلقة CSV مثل تلك الواردة في الخيط.
ما يبقى غير واضح
- الملفات ذات الإصدارات الثانوية فقط: سأل صاحب المنشور عن ملفات لم تُنشر أبدًا كإصدار رئيسي، ولها مئات الإصدارات الثانوية، مثل 0.192. لا تذكر Learn كيف يعالج تقليم حد العدد هذه الملفات. أنشئ مكتبة اختبار، وأضف ملفًا من هذا النوع، وشغّل مهمة صغيرة قبل أن تلمس بيئة الإنتاج.
- عدم تطابق النتيجة: ملاحظة صاحب المنشور بأن جميع الإصدارات الثانوية لكل إصدار رئيسي محفوظ بقيت دون حذف، لم تُفسَّر في الصفحات التي قرأتها.
- الاستبقاء: تشير صفحة Learn الخاصة بالتقليم إلى الأسئلة المتداولة للإصدارات الخاضعة لنهج الاستبقاء أو لعمليات الحجز في eDiscovery. لكنها لا تصف السلوك في الصفحة نفسها.
ذات صلة
المصادر
- Microsoft Learn: تقليص الإصدارات الحالية من الموقع أو المكتبة أو OneDrive
- Microsoft Learn: جدولة مهمة تقليص لموقع أو مكتبة مستندات
- Microsoft Learn: تشغيل تحليل "ماذا لو"
- Microsoft Learn: New-SPOSiteFileVersionBatchDeleteJob
- Microsoft Learn: تعيين حدود الإصدارات لمكتبة مستندات فردية
- Microsoft Learn: تعيين حدود الإصدارات لموقع
- Microsoft Learn: Manage site storage limits
- Microsoft Learn: نظرة عامة على حدود سجل الإصدارات
- Microsoft Learn: تخطيط تخزين الإصدارات في مكتبات المستندات
- Microsoft Community Hub: تقليص سجل إصدارات SharePoint - الإصدارات الثانوية (فبراير 2026)