קיצוץ גרסאות קבצים ב-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>. טקסט הציון למקום של הפרמטר השני הוא "מספר הגרסאות הראשיות שעבורן יישמרו כל הגרסאות המשניות". בעמוד 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מיישם את הלוגיקה של הגדרת הגרסאות האוטומטית על גרסאות קיימות.
דף המגבלות של היסטוריית הגרסאות ממליץ על ההגדרה האוטומטית לאחסון גרסאות מיטבי. לפי הדף, ההגדרה האוטומטית משלבת את ערך השחזור של היסטוריית הגרסאות עם שימוש נמוך יותר באחסון, בלי שתצטרכו לנחש מגבלות של מספר או של גיל. דף אחסון הגרסאות בתוכנית קובע שההגדרה האוטומטית שומרת את הגרסאות שנוצרו ב-30 הימים הראשונים (במסגרת מגבלה של 500 גרסאות), ואז מדללת אותן לגרסאות שעתיות, יומיות ושבועיות ככל שהן מתבגרות.
לקיצוץ לפי גיל, Learn מציין שתי מגבלות. העבודה אינה מוחקת גרסאות שנוצרו ב-30 הימים האחרונים, ולכן הקלט חייב להיות לפחות 30 ימים. העבודה גם מוחקת תמיד את כל הגרסאות שנוצרו לפני 1 בינואר 2023, ולכן מספר הימים שתבחרו חייב להניב תאריך שאחרי תאריך זה. בדקו את הדף העדכני לפני שאתם נשענים על שתי הנקודות האלה.
שלב 2: יצירת הדוח והרצת ניתוח what-if
דף הקיצוץ של Learn קובע שיש להריץ ניתוח what-if לפני הקיצוץ (מדריך ה-queue-a-job מכנה אותו אופציונלי). המדריכים מתארים דוח שימוש באחסון גרסאות לאתר או לספרייה, שמורידים כקובץ CSV. לאחר מכן מריצים סקריפט על הדוח עם PowerShell 7. במקרה של הגבלת מספר, סקריפט ה-what-if במדריך מקבל -ImportPath, -ExportPath ו--MajorVersionLimit. הוא אינו מקבל הגבלה של גרסאות משנה. לכן תוצאת ה-what-if להגבלות מספר מדמה רק את מגבלת הגרסאות הראשיות.
דפי המדריך אינם מציינים את ה-cmdlet שיוצר את הדוח, ולכן פעלו לפי מדריך Learn לשלב הזה. Learn מציין שעבודת קיצוץ עשויה להימשך מספר ימים, בהתאם לגודל הספרייה. מדריך ה-what-if אינו מציין משך זמן.
שלב 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 מזהיר שגרסאות שנמחקות בדרך זו נמחקות לצמיתות ואינן עוברות לסל המחזור. עמוד ההפניה ל-cmdlet מפרט גם את -WhatIf ו--Confirm כפרמטרים. ההפניה מתארת את -WhatIf רק כהצגה של מה שיקרה אם ה-cmdlet ירוץ, ללא פירוט על הפלט שלו עבור cmdlets אלה. לכן אל תתייחסו אליו כתחליף לניתוח what-if המבוסס על הדוח.
שלב 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 לכל גרסה ראשית חדשה שנוצרת. ממשק מרכז הניהול אינו מקבל פחות מ-100 גרסאות ראשיות או תוקף תפוגה קצר מ-30 ימים. לפי Learn, ניתן להגדיר ערכים נמוכים יותר דרך ממשקי API ציבוריים, אך הדבר אינו מומלץ, מפני שהוא עלול לגרום לאובדן נתונים בלי כוונה.
שלב 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)