תיקון הרשאות 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 בכמות גדולה, מייצאים דוח של מי יש לו גישה, מסמנים כל שורה כ-keep, remove או reset, ואז מריצים סקריפט שקורא את ההחלטות שלכם. המדריך מיועד למנהלי SharePoint שמתמודדים עם מאות פריטים בעלי הרשאות ייחודיות, ולא רוצים ללחוץ עליהם אחד אחד. תראו איך בונים רשימת החלטות, אילו cmdlets של PnP PowerShell מבצעים את העבודה, מה דוח Microsoft לא כולל, ואיך לבדוק, לתעד ולאמת הרצה. דוגמה מעשית עם מספרים בדויים מציגה את המחזור המלא.
עיקרי הדברים
- כדי לתקן הרשאות SharePoint בכמות גדולה, מתחילים מדוח: כל שינוי בסקריפט צריך להתחקות לשורה אחת שאדם סימן כ-keep, remove או reset.
- דוח השיתוף של האתר ב-Microsoft מפרט כל קובץ, משתמש, הרשאה וקישור ייחודיים, אבל משמיט קישורי Anyone ואת האנשים הבודדים בתוך קבוצות SharePoint.
- שלושה cmdlets של PnP PowerShell מכסים את רוב התיקונים בכמות גדולה: Remove-PnPGroupMember, Set-PnPListItemPermission ו-Remove-PnPSiteCollectionAdmin.
- איפוס פריט לירושה של ההרשאות מהרשימה מסיר את ההרשאות הייחודיות שלו, ולעיתים קרובות זהו התיקון הנקי ביותר להצטברות הרשאות מיותרת.
- בודקים את הסקריפט על אתר אחד, שומרים יומן של כל שינוי, ומריצים דוח שני לאחר מכן כדי להוכיח שהבעיה נפתרה.
למה תיקון פריט אחר פריט נכשל
בעיות הרשאות SharePoint נבנות לאט. מישהו משתף קובץ יחיד עם עמית. מישהו אחר בוחר לשבור את הירושה של ההרשאות בתיקייה עבור פרויקט שהסתיים מזמן. אחרי כמה שנים, יש בספריות מסמכים מאות פריטים עם הרשאות ייחודיות, ואף אחד לא יודע אילו מהם עדיין חשובים.
תיקון של הדברים אחד אחד נושא שלוש בעיות. הוא איטי. קל לפספס פריטים. ואין בו שום תיעוד של מה ששונה, כך שאי אפשר לבטל טעות או לענות למבקר.
תיקון בכמות גדולה הופך את הסדר. קודם אוספים את העובדות בדוח. אחר כך אדם מחליט. רק אז סקריפט פועל, ורק על שורות שיש להן החלטה. כך נשמרת המהירות של אוטומציה והזהירות של בדיקה ידנית.
תיקון הרשאות SharePoint בכמות גדולה: חמישה שלבים
יש לפעול לפי השלבים הבאים, לפי הסדר.
- מייצאים את העובדות. יוצרים דוח לאתר. המדריך של Microsoft לדוח שיתוף של קבצים ותיקיות קובע שמנהל האתר מריץ אותו מ-Settings, Site usage, בסעיף Shared with external users, באמצעות Run report. בוחרים היכן לשמור את קובץ ה-CSV, ומקבלים מייל כשהדוח מסתיים.
- מוסיפים עמודת החלטה. פותחים את קובץ ה-CSV ב-Excel ומוסיפים עמודה עם שלושה ערכים מותרים: keep, remove, reset. מוסיפים עמודה שנייה לסיבה. מבקשים מבעל האתר לבדוק את השורות שאתם לא יכולים לשפוט בעצמכם.
- כותבים את הסקריפט סביב ההחלטות. קוראים את הקובץ עם
Import-Csv, עוברים על השורות, ומריצים cmdlet אחד לכל סוג החלטה. מדלגים על כל שורה שאין לה החלטה. - בדקו על אתר אחד, ואז על ספרייה אחת. הריצו את הסקריפט קודם על אתר בדיקה או על ספרייה בודדת. השוו את התוצאה למה שציפיתם לו.
- בדקו עם דוח שני. אחרי הריצה האמיתית, הפיקו את הדוח שוב. השורות שהסרתם אמורות להיעלם, והשורות שהשארתם אמורות להישאר ללא שינוי.
אל תדלגו על שלב 2. סקריפט בטוח רק כמו הרשימה שהוא קורא.
איך עובדת ירושת הרשאות לפני שמאפסים דבר
דף התמיכה של Microsoft בנושא התאמה אישית של הרשאות לרשימה או לספרייה של SharePoint מסביר שתיקיות, רשימות ומסמכים יורשים בדרך כלל הרשאות מהאתר שמכיל אותם. כדי לתת לרשימה או לספרייה הרשאות משלה, הבעלים בוחר באפשרות Stop Inheriting Permissions, והפריטים שמתחתיה יורשים אז את ההגדרות החדשות. כדי לחזור לאחור, הכרטיסייה Permissions מציעה את Delete unique permissions, שמסירה את ההרשאות המותאמות שהגדרתם.
שלוש אזהרות מאותו דף חשובות לעבודה בכמות גדולה:
- המגבלה של 100,000 פריטים. אי אפשר לשבור או לשחזר ירושה ברשימה, בספרייה או בתיקייה שמכילות יותר מ-100,000 פריטים. קובץ בודד בספרייה גדולה עדיין יכול לקבל שבירת ירושה.
- הסרת משתמש משפיעה על פריטי משנה. הסרת משתמש או קבוצה מסירה אותם גם מפריטי המשנה, כולל אלה עם ירושה שבורה, ואי אפשר לשחזר זאת. קראו את הלוג לפני שאתם מבצעים הסרה.
- גישה מוגבלת נשארת. אדם שאיתו שותף פריט אחד בלבד מקבל גישה מוגבלת לאתר, וביטול השיתוף של הפריט לא לוקח ממנו אותה.
Microsoft ממליצה להשתמש בקבוצות SharePoint, ומתארת הרשאות ברמת הפריט כנתמכות בשימוש סביר. הכלל המעשי שלנו הוא להעניק גישה דרך קבוצה ולא למשתמשים בודדים, כך שהרשאות האתר יישארו קריאות ויישארו פחות הרשאות ייחודיות לתיקון.
איזה cmdlet פותר איזו בעיה?
ל-PnP PowerShell יש cmdlets לרוב התיקונים בכמות גדולה. שלושת אלה עולים לרוב.
הסרת אדם מקבוצת 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. הקבוצה מופיעה, אבל לא חבריה.
- קישורים שנשלחו במייל ולא נלחץ עליהם מעולם.
- קישורים אנונימיים (לכל מי שיש את הקישור).
יש לכך השלכות ממשיות. אם המטרה שלכם היא לאתר לאן לאדם יש גישה, הדוח יציג את הקבוצה, ולכן עליכם לבדוק את חברי הקבוצה בנפרד. אם המטרה היא להסיר שיתוף ציבורי, הדוח לא יציג בכלל קישורי Anyone, ולכן תצטרכו מקור אחר, כמו דוחות ממשל גישה לנתונים במרכז הניהול של SharePoint. לפי Microsoft, דוחות אלה דורשים את SharePoint Advanced Management.
עבור אתר SharePoint יחיד ב-SharePoint Online, בדקו גם את הרשאות האתר ואת רמות ההרשאה הנמצאות בשימוש תחת Site settings לפני שאתם נוגעים בפריטים. לאחר מכן בדקו את אפשרויות הדיווח של SharePoint עבור כל הדייר, ולא רק עבור אתר אחד. קובץ CSV לכל אתר בנפרד אינו מתרחב למאות אתרים.
באתרים המחוברים לקבוצת Microsoft 365, חברות בקבוצה מנוהלת דרך הקבוצה ולא בקבוצות הפנימיות של האתר. סקריפט שעורך את קבוצות האתר לא יתקן אדם שנמצא בקבוצת Microsoft 365.
הפכו את הסקריפט לבטוח להרצה
סקריפט המוני יכול לגרום נזק רב בזמן קצר. לפני ההרצה האמיתית הראשונה, הטמיעו את ההגנות הבאות:
- הוסיפו מתג ריצה יבשה. לסקריפט שלכם יכול להיות פרמטר
-DryRunשמדפיס כל פעולה מתוכננת ולא משנה דבר. בדקו את הפלט הזה יחד עם בעל האתר. - רשמו ביומן לפני שאתם משנים. לכל שורה, רשמו תחילה ביומן את המצב הקודם: נתיב הפריט, המשתמש ורמת ההרשאה, כמו Full Control, Edit או Read. היומן הזה הוא הדרך שלכם לחזור אחורה.
- עבדו בקבוצות. הריצו 50 פריטים, בדקו אותם, ואז הריצו את 500 הבאים. קבוצה ראשונה קטנה מאתרת הנחה שגויה בשלב מוקדם.
- שמרו את הדוח המקורי. אחסנו את קובץ ה-CSV עם ההחלטות שלכם ואת היומן בתיקייה שרק בעלי האתר יכולים לפתוח. Microsoft ממליצה על אותו דבר לגבי הדוח עצמו, משום שהוא מציג מי יש לו גישה לאילו נתונים.
- שנו חברות בקבוצה בהרצה נפרדת. תקנו הרשאות פריטים בהרצה אחת וחברות בקבוצה בהרצה אחרת, כך שתוכלו לבדוק כל סוג שינוי בנפרד.
דוגמה: ניקוי ספריית מסמכים אחת
המספרים בדוגמה מומצאים.
לאתר פרויקט יש ספריית מסמכים אחת. בדוח יש 620 שורות. לאחר המיון, מנהל ובעל האתר מסמנים אותן:
- 410 שורות: לשמור. אלו הרשאות רגילות מבוססות קבוצה.
- 150 שורות: לאפס. אלו קבצים בודדים עם הרשאות ייחודיות משיתופים ישנים.
- 40 שורות: להסיר. הן מעניקות לקבלן לשעבר גישה ישירה.
- 20 שורות: לא ברור. הן מוחזרות לבעלים עם שאלה.
המנהל כותב סקריפט עם שני ענפים. ענף האיפוס מריץ את Set-PnPListItemPermission עם -InheritPermissions עבור כל קובץ. ענף ההסרה מריץ את Remove-PnPGroupMember עבור הקבלן בקבוצות שבהן הוא מופיע. הסקריפט כותב שורת יומן אחת לכל פעולה: התאריך, הפריט, המצב הקודם והמצב החדש.
תחילה, המנהל מריץ את הסקריפט על עותק של הספרייה עם 20 שורות. התוצאה תואמת לתוכנית. ההרצה המלאה נמשכת ערב אחד. דוח שני מציג 410 שורות ועוד 20, וזה בדיוק מה שהמנהל ציפה לו. היומן נשמר ליד הדוח, כך שכל אחד יכול לראות מה התרחש.
טעויות נפוצות
- הרצת סקריפט ללא רשימת החלטות. לא תוכלו להסביר מאוחר יותר מדוע פריט השתנה.
- איפוס ירושה בספרייה שבה ההרשאות הייחודיות מכוונות. חלק מהתיקיות מוגבלות בכוונה. סמנו אותן לשמירה.
- סמכו על הדוח כעל שלם. הוא משמיט קישורי Anyone וחברים בקבוצות SharePoint.
- הסרה לפני הוספה. כאשר אתם מחליפים משתמש אחד במשתמש אחר, הוסיפו תחילה.
- מתן גישה אדם אחר אדם. הקצו הרשאות דרך קבוצה ולא למשתמש בודד בכל פריט, כך שהסקירה הבאה תהיה קצרה יותר.
- שכחה של קבוצת Microsoft 365. אדם יכול להמשיך לשמור על גישה דרך חברות בקבוצה גם לאחר שניקיתם את האתר.
- אין יומן ואין דוח שני. בלעדיהם, אי אפשר להוכיח את התיקון או לבטל אותו.
איך תוכנה יכולה לעזור
התחילו עם הכלים שכבר יש לכם. דוח השיתוף של האתר ודוחות מרכז הניהול מספקים את העובדות. PnP PowerShell מבצע את השינויים, וגיליון אלקטרוני מחזיק את ההחלטות והיומן.
כמה כלים של צדדים שלישיים משלבים דיווח ותיקון באותו מסך. דוגמה אחת היא SharePoint Essentials Toolkit של Cognillo. לפי דף המוצר של היצרן, הכלי מציג דוחות הרשאות לאתרים, לתיקיות ולפריטים, מראה את כל מה שמשתמש יחיד יכול לגשת אליו, מחליף משתמש אחד במשתמש אחר, ומתקן הרשאות וקישורי שיתוף מתוך הדוחות. היצרן גם מציין שאפשר לתזמן ולייצא דוחות ומשימות. אלה הטענות של היצרן, ו-M365.FM לא בדקה אותן. הדרך הידנית שתוארה לעיל עובדת ללא אף אחד מהכלים האלה.
גילוי נאות: Cognillo מממנת את M365.FM.
הצעד הבא
בחרו אתר אחד עם בעיית הרשאות ידועה, הריצו את דוח השיתוף, והוסיפו לקובץ ה-CSV עמודת החלטה. לאחר מכן השתמשו ברשימה הזו כדי לתקן הרשאות של SharePoint בכמות גדולה, קודם על ספריית בדיקה, ושמרו את היומן.