إصلاح أذونات SharePoint بشكل جماعي من تقرير، لا عنصرًا تلو الآخر
Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.
By Mirko Peters · · Updated
إصلاح أذونات SharePoint بشكل جماعي: صدّر تقريرًا، وحدّد لكل صف القيمة keep أو remove أو reset، واختبر نص PnP PowerShell البرمجي على موقع واحد أولًا، ثم تحقّق من النتيجة.
Automatically translated with AI from the original post. Read the English original
لإصلاح أذونات SharePoint بشكل جماعي، تصدّر تقريرًا عمّن لديه وصول، وتحدّد لكل صف الإبقاء أو الإزالة أو إعادة التعيين، ثم تشغّل نصًا برمجيًا يقرأ قراراتك. هذا الدليل موجّه إلى مسؤولي SharePoint الذين يواجهون مئات العناصر ذات الأذونات الفريدة، ولا يرغبون في النقر عليها واحدًا تلو الآخر. ستتعرّف على كيفية بناء قائمة القرارات، وعلى أوامر PnP PowerShell التي تنفّذ العمل، وعلى ما يغفله تقرير Microsoft، وكيفية الاختبار والتسجيل والتحقق من التنفيذ. يعرض مثال تطبيقي بأرقام افتراضية الدورة الكاملة.
النقاط الرئيسية
- لإصلاح أذونات SharePoint بشكل جماعي، ابدأ من تقرير: يجب أن يعود كل تغيير في النص البرمجي إلى صف واحد حدّده شخص بالقيمة keep أو remove أو reset.
- يسرد تقرير مشاركة المواقع في Microsoft كل ملف وكل مستخدم وكل إذن وكل رابط، لكنه يغفل روابط Anyone والأفراد داخل مجموعات SharePoint.
- تغطي ثلاثة أوامر في PnP PowerShell معظم الإصلاحات الجماعية: Remove-PnPGroupMember وSet-PnPListItemPermission وRemove-PnPSiteCollectionAdmin.
- إعادة العنصر لوراثة الأذونات من قائمته تزيل أذوناته الفريدة، وغالبًا ما تكون الحل الأنظف لتراكم الأذونات الزائدة (permission creep).
- اختبر النص البرمجي على موقع واحد، واحتفظ بسجل لكل تغيير، ثم شغّل تقريرًا ثانيًا بعد التنفيذ لتتأكد من زوال المشكلة.
لماذا يفشل الإصلاح عنصرًا تلو الآخر
تتراكم معظم مشكلات أذونات SharePoint ببطء. يشارك شخص ملفًا واحدًا مع زميل. ويقطع شخص آخر وراثة الأذونات في مجلد لمشروع انتهى منذ زمن بعيد. وبعد بضع سنوات، تحتوي بعض مكتبات المستندات على مئات العناصر ذات أذونات فريدة، ولا يستطيع أحد أن يحدد أيها ما زال مهمًا.
إصلاح هذه المشكلات واحدة تلو الأخرى يواجه ثلاث مشكلات. فهو بطيء، ومن السهل أن تُغفل عناصر، ولا يترك سجلًا بما غيّرته، فلا تستطيع التراجع عن خطأ أو الرد على مدقق.
يقلب الإصلاح الجماعي الترتيب. أولًا تجمع الحقائق في تقرير، ثم يتخذ شخص القرار، وعندها فقط يتصرف النص البرمجي، ولا يتصرف إلا في الصفوف التي لها قرار. وبذلك تحتفظ بسرعة الأتمتة وعناية المراجعة اليدوية.
كيفية إصلاح أذونات SharePoint بشكل جماعي: خمس خطوات
اتبع هذه الخطوات بالترتيب.
- صدّر الحقائق. أنشئ تقريرًا للموقع. يذكر دليل Microsoft لـ تقرير مشاركة الملفات والمجلدات أن مسؤول الموقع يشغّله من Settings, Site usage، في قسم Shared with external users، باستخدام Run report. تختار مكان حفظ ملف CSV، وتصلك رسالة بريد إلكتروني عند الانتهاء.
- أضف عمود قرار. افتح ملف CSV في Excel، وأضف عمودًا بثلاث قيم مسموحة: keep وremove وreset. وأضف عمودًا ثانيًا للسبب. واطلب من مالك الموقع مراجعة الصفوف التي لا تستطيع الحكم عليها بنفسك.
- اكتب النص البرمجي حول القرارات. اقرأ الملف باستخدام
Import-Csv، ومرّ على الصفوف، ونفّذ أمرًا واحدًا لكل نوع قرار. وتجاهل كل صف لا يحمل قرارًا. - اختبر على موقع واحد، ثم على مكتبة واحدة. شغّل البرنامج النصي على موقع اختبار أو على مكتبة واحدة أولاً. قارن النتيجة بما كنت تتوقعه.
- تحقّق باستخدام تقرير ثانٍ. بعد التشغيل الفعلي، أنشئ التقرير من جديد. يجب أن تكون الصفوف التي أزلتها قد اختفت، وأن تبقى الصفوف التي أبقيتها دون تغيير.
لا تتخطَّ الخطوة 2. البرنامج النصي آمن بقدر أمان القائمة التي يقرأها.
كيف يعمل توريث الأذونات قبل أن تعيد أي شيء إلى حالته الأصلية
تشرح صفحة الدعم من Microsoft حول تخصيص الأذونات لقائمة أو مكتبة في SharePoint أن المجلدات والقوائم والمستندات ترث عادةً الأذونات من الموقع الذي تحتويه. ولمنح قائمة أو مكتبة أذونات خاصة بها، يختار المالك خيار Stop Inheriting Permissions (إيقاف توريث الأذونات)، فترث العناصر الموجودة أسفلها الإعدادات الجديدة. وللعودة إلى الوضع السابق، توفر علامة التبويب Permissions الخيار Delete unique permissions (حذف الأذونات الفريدة)، الذي يزيل الأذونات المخصصة التي وضعتها.
هناك ثلاثة تحذيرات من الصفحة نفسها تهم العمل الجماعي:
- حد 100,000 عنصر. لا يمكنك إيقاف التوريث أو استعادته على قائمة أو مكتبة أو مجلد يحتوي على أكثر من 100,000 عنصر. ومع ذلك، يمكن إيقاف التوريث لملف واحد في مكتبة كبيرة.
- إزالة مستخدم تطال العناصر الفرعية. إزالة مستخدم أو مجموعة تزيله أيضاً من العناصر الفرعية، بما فيها العناصر التي أوقف توريثها، ولا يمكن استعادته. اقرأ السجل قبل تنفيذ أي عملية إزالة.
- يبقى الوصول المحدود. الشخص الذي شورك معه عنصر واحد فقط يحصل على وصول محدود إلى الموقع، ولا يُسحب هذا الوصول بإلغاء مشاركة العنصر.
توصي Microsoft باستخدام مجموعات SharePoint، وتعدّ أذونات مستوى العنصر مدعومة ضمن الاستخدام المعقول. أما قاعدتنا العملية فهي منح الوصول عبر مجموعة وليس للمستخدمين الأفراد، حتى تبقى أذونات الموقع واضحة ويبقى عدد الأذونات الفريدة التي تحتاج إلى إصلاح أقل.
أي أمر cmdlet يصلح أي مشكلة؟
تتضمن PnP PowerShell أوامر cmdlet لمعظم عمليات الإصلاح الجماعي. هذه الأوامر الثلاثة هي الأكثر شيوعاً.
إزالة شخص من مجموعة SharePoint. يوضح المرجع الخاص بـ Remove-PnPGroupMember بناء الجملة: Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'. استخدمه لمشكلات عضوية المجموعات، مثل موظف غادر ما زال موجوداً في مجموعة Members.
تغيير الأذونات على عنصر أو إعادة تعيينها. يسرد المرجع الخاص بـ Set-PnPListItemPermission هذه الخيارات:
- تضيف
-AddRoleو-RemoveRoleمستوى إذن لمستخدم أو مجموعة على عنصر واحد، أو تزيله. استخدمGet-PnPRoleDefinitionلعرض الأدوار المتاحة. - يزيل
-ClearExistingجميع الأذونات الموجودة على العنصر قبل إضافة الدور الجديد. - يعيد
-InheritPermissionsضبط العنصر بحيث يرث الأذونات من قائمته، ويزيل أذوناته الفريدة. - يغيّر
-SystemUpdateالأذونات دون إنشاء إصدار جديد أو تشغيل Power Automate.
غالباً ما تكون إعادة الضبط أنظف حل. فإذا كان العنصر يملك أذونات فريدة فقط لأن شخصاً شاركه مرة واحدة، فإن إعادة الضبط تعيده إلى قواعد المكتبة.
إزالة مسؤول مجموعة مواقع. يوضح المرجع الخاص بـ Remove-PnPSiteCollectionAdmin الأمر Remove-PnPSiteCollectionAdmin -Owners "user@contoso.onmicrosoft.com". يحتفظ المسؤولون الذين لم تذكرهم بوصولهم. ويمكن أيضاً تمرير قائمة من المستخدمين.
لاستبدال مستخدم بآخر، نفّذ خطوتين: أضف الشخص الجديد حيث كان للشخص القديم وصول، ثم أزل الشخص القديم. نفّذ الإضافة أولاً، حتى لا يفقد أحد الوصول خلال الفترة الفاصلة.
ما الذي لا يُظهره التقرير؟
التقرير بداية وليس الصورة الكاملة. تبيّن صفحة تقرير المشاركة من Microsoft ما يستثنيه ملف CSV:
- المستخدمون الأفراد داخل مجموعات SharePoint. تظهر المجموعة، لكن لا تظهر أعضاؤها.
- الروابط التي أُرسلت عبر البريد الإلكتروني ولم يُنقر عليها قط.
- الروابط المجهولة (Anonymous) لأي شخص.
لهذا تبعات حقيقية. إذا كان هدفك معرفة المواقع التي يملك فيها شخص ما وصولاً، فسيُظهر التقرير المجموعة، لذلك يجب أن تقرأ أعضاء المجموعة بشكل منفصل. أما إذا كان هدفك إزالة المشاركة العامة، فلن يدرج التقرير روابط "أي شخص" إطلاقاً، لذلك تحتاج إلى مصدر آخر، مثل تقارير حوكمة الوصول إلى البيانات في مركز إدارة SharePoint. ووفقاً لـ Microsoft، تتطلب هذه التقارير SharePoint Advanced Management.
بالنسبة إلى موقع SharePoint واحد في SharePoint Online، راجع أيضاً أذونات الموقع ومستويات الأذونات المستخدمة ضمن إعدادات الموقع (Site settings) قبل أن تعدّل أي عنصر. ثم تحقّق من خيارات إعداد تقارير SharePoint على مستوى المستأجر بأكمله، وليس على موقع واحد فقط. فملف CSV لكل موقع على حدة لا يتوسّع إلى مئات المواقع.
بالنسبة إلى المواقع المرتبطة بمجموعة Microsoft 365، تُدار عضوية المجموعة من خلال المجموعة نفسها، وليس من مجموعات الموقع الخاصة. فالنص البرمجي الذي يعدّل مجموعات الموقع لن يصلح شخصاً موجوداً في مجموعة Microsoft 365.
اجعل النص البرمجي آمناً للتشغيل
يمكن للنص البرمجي الجماعي أن يُحدث ضرراً كبيراً في وقت قصير. قبل أول تشغيل فعلي، أضف هذه الحمايات:
- أضف مفتاح التشغيل التجريبي (Dry run). يمكن لنصك البرمجي أن يقبل المعامل
-DryRunفيطبع كل إجراء مخطط له دون أن يغيّر أي شيء. راجع هذا الناتج مع مالك الموقع. - سجّل قبل التغيير. لكل صف، اكتب الحالة القديمة في السجل أولاً: مسار العنصر، والمستخدم، ومستوى الإذن، مثل Full Control أو Edit أو Read. هذا السجل هو طريقك للعودة إلى الحالة السابقة.
- اعمل على دفعات. شغّل 50 عنصراً، وتحقّق منها، ثم شغّل الدفعة التالية البالغة 500. فالدفعة الأولى الصغيرة تكشف الافتراض الخاطئ مبكراً.
- احتفظ بالتقرير الأصلي. خزّن ملف CSV الذي يتضمن قراراتك، والسجل، في مجلد لا يستطيع فتحه إلا مالكو المواقع. وتقترح Microsoft الأمر نفسه بالنسبة إلى التقرير ذاته، لأنه يسرد من لديه وصول إلى ماذا.
- غيّر عضوية المجموعات في تشغيل منفصل. أصلح أذونات العناصر في تشغيل، وعضوية المجموعات في تشغيل آخر، حتى تتمكن من التحقق من كل نوع من التغييرات على حدة.
مثال: تنظيف مكتبة مستندات واحدة
الأرقام افتراضية.
يحتوي موقع مشروع على مكتبة مستندات واحدة. يتضمن التقرير 620 صفاً. وبعد الفرز، يقوم المسؤول ومالك الموقع بتصنيفها:
- 410 صفوف: الاحتفاظ. وهي أذونات المجموعات المعتادة.
- 150 صفاً: إعادة التعيين. وهي ملفات فردية لها أذونات فريدة من مشاركات قديمة.
- 40 صفاً: الإزالة. وهي تمنح متعاقداً سابقاً وصولاً مباشراً.
- 20 صفاً: غير واضح. تُعاد إلى المالك مع سؤال.
يكتب المسؤول نصاً برمجياً بفرعين. ينفّذ فرع إعادة التعيين الأمر Set-PnPListItemPermission مع -InheritPermissions لكل ملف. وينفّذ فرع الإزالة الأمر Remove-PnPGroupMember للمتعاقد في المجموعات التي يظهر فيها. ويكتب النص البرمجي سطر سجل واحداً لكل إجراء: التاريخ، والعنصر، والحالة القديمة، والحالة الجديدة.
أولاً، يشغّل المسؤول النص البرمجي على نسخة من المكتبة تحتوي على 20 صفاً. تتطابق النتيجة مع الخطة. يستغرق التشغيل الكامل مساءً واحداً. ويُظهر تقرير ثانٍ 410 صفوف إضافة إلى 20 صفاً، وهذا ما كان المسؤول يتوقعه. يُحفظ السجل بجانب التقرير، حتى يتمكن أي شخص من معرفة ما حدث.
الأخطاء الشائعة
- تشغيل نص برمجي دون قائمة قرارات. لن تتمكن لاحقاً من تفسير سبب تغيّر أي عنصر.
- إعادة ضبط الوراثة في مكتبة تكون فيها الأذونات الفريدة مقصودة. بعض المجلدات مقيّدة عن قصد. ضع علامة "الاحتفاظ" عليها.
- الوثوق بالتقرير على أنه كامل. فهو يستثني روابط "أي شخص" وأعضاء مجموعات SharePoint.
- الإزالة قبل الإضافة. عند استبدال مستخدم بآخر، أضف الجديد أولاً.
- منح الوصول شخصاً تلو الآخر. امنح الأذونات من خلال مجموعة، لا لمستخدم واحد في كل عنصر، حتى تكون المراجعة التالية أقصر.
- نسيان مجموعة Microsoft 365. يمكن لشخص أن يحتفظ بالوصول من خلال عضوية المجموعة حتى بعد تنظيف الموقع.
- عدم وجود سجل ولا تقرير ثانٍ. بدونهما، لا يمكنك إثبات الإصلاح أو التراجع عنه.
كيف يمكن للبرمجيات أن تساعد
ابدأ بالأدوات التي تملكها بالفعل. يوفّر تقرير مشاركة الموقع وتقارير مركز الإدارة الحقائق اللازمة. ويُجري PnP PowerShell التغييرات، ويحتفظ جدول البيانات بالقرارات والسجل.
بعض أدوات الجهات الخارجية تجمع التقارير والإصلاح في شاشة واحدة. ومن الأمثلة على ذلك أداة Cognillo's SharePoint Essentials Toolkit. ووفقًا لصفحة المنتج لدى المورّد، فإنها تقدّم تقارير الأذونات للمواقع والمجلدات والعناصر، وتعرض كل ما يستطيع شخص واحد الوصول إليه، وتستبدل مستخدمًا بآخر، وتصلح الأذونات وروابط المشاركة انطلاقًا من التقارير. ويقول المورّد أيضًا إنه يمكن جدولة التقارير والمهام وتصديرها. هذه إفادات المورّد، ولم يختبرها M365.FM. ويعمل المسار اليدوي المذكور أعلاه دون الحاجة إلى أي من هذه الأدوات.
إفصاح: ترعى Cognillo برنامج M365.FM.
الخطوة التالية
اختر موقعًا واحدًا به مشكلة أذونات معروفة، وشغّل تقرير المشاركة، وأضف عمود قرار إلى ملف CSV. ثم استخدم هذه القائمة لإصلاح أذونات SharePoint بالجملة على مكتبة اختبار أولًا، واحتفظ بالسجل.