SharePoint 파일 버전 정리: 개수 제한과 MajorWithMinorVersionsLimit의 실제 의미
By Mirko Peters ·
-MajorVersionLimit 100과 -MajorWithMinorVersionsLimit 5를 지정한 정리 작업을 실행했더니 모든 부 버전이 그대로 남아 있었습니다. 이 글에서는 Microsoft가 두 제한 값을 어떻게 설명하는지, 안전하게 정리 작업을 실행하는 방법, 그리고 아직 불분명한 부분을 정리합니다.
Automatically translated with AI from the original post. Read the English original
한 SharePoint 관리자가 모든 사이트의 파일 버전을 정리해 스토리지를 줄이려고 했습니다. CSV 파일에서 사이트 URL을 읽어 New-SPOSiteFileVersionBatchDeleteJob을 -MajorVersionLimit 100과 -MajorWithMinorVersionsLimit 5와 함께 호출하는 스크립트를 실행했습니다. 기대한 결과는 각 주 버전마다 최근 주 버전 100개와 최근 부 버전 5개를 유지하는 것이었습니다. 실제로는 주 버전은 정리되었지만, 남은 주 버전의 모든 부 버전은 그대로 남아 있었습니다.
핵심 포인트
- Microsoft Learn은 -MajorWithMinorVersionsLimit를 부 버전 개수의 상한이 아니라, 모든 부 버전을 유지할 주 버전의 개수로 설명합니다.
- 두 개수 매개 변수는 함께 지정해야 합니다. 주 버전만 개수로 계산하려는 경우 Learn 자습서에서는 -MajorWithMinorVersionsLimit 0을 사용합니다.
- 정리된 버전은 영구적으로 삭제되며 휴지통을 거치지 않습니다. 따라서 먼저 what-if 분석을 실행하고 사이트 하나에서 테스트하십시오.
- 정리 작업은 백그라운드에서 며칠에 걸쳐 일괄 실행되며, 진행 상황 cmdlet과 Remove cmdlet으로 확인하거나 취소할 수 있습니다.
- Learn은 부 버전만 있는 파일(예: 0.192)을 어떻게 처리하는지 설명하지 않습니다. 따라서 이 경우는 테스트 라이브러리에서 직접 확인하십시오.
이 질문은 2026년 2월 Microsoft Community Hub에 게시되었으며, 현재 답변은 없습니다. 이 글은 이 문제를 해결했다고 주장하지 않습니다. 대신 두 매개 변수에 대해 Microsoft Learn이 설명하는 내용을 보여주고, 정리 작업을 신중하게 실행하는 방법을 안내하며, 문서와 해당 스레드에서 공백으로 남아 있는 부분을 표시합니다. 이 글은 Microsoft의 공식 절차가 아닙니다.
두 매개 변수가 문서상 수행하는 작업
Learn 페이지 "기존 버전 정리"는 개수 제한 명령을 다음과 같이 나열합니다. New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. 두 번째 매개 변수의 자리 표시자 텍스트는 "모든 부 버전을 유지할 주 버전의 개수"입니다. 라이브러리 버전 제한에 대한 Learn 페이지도 Set-SPOListVersionPolicy에 대해 거의 같은 표현, 즉 모든 부 버전을 유지하는 주 버전의 개수를 사용합니다.
이 페이지에는 수동 개수 제한 모드가 지정된 개수 제한을 초과하는 가장 오래된 버전을 삭제한다는 내용도 나와 있습니다.
문서에서 확인되는 세 가지 세부 사항은 다음과 같습니다.
- cmdlet 참조 문서에서 개수 제한 구문은
-MajorVersionLimit와-MajorWithMinorVersionsLimit를 모두 요구합니다. 각 페이지는 나머지 하나도 함께 필요하다고 설명합니다. - Learn 자습서 "정리 작업 큐에 넣기"는
-MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0을 보여 주며, 이를 주 버전 100개를 유지하는 설정으로 표시합니다. - cmdlet 참조 문서의 예제는
-MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10을 사용합니다.
제가 이 문구를 읽어 보면, 두 번째 숫자는 "보관할 마이너 버전 수"라기보다 "모든 마이너 버전을 유지하고 싶은 메이저 버전이 몇 개인지"에 가깝습니다. 이 해석은 게시자가 기대한 것과 다릅니다. 또한 게시자의 결과를 완전히 설명하지도 못합니다. 값이 5라면 모든 마이너 버전이 제한된 수의 메이저 버전에 대해서만 남을 것으로 예상되는데, 보관되는 메이저 버전마다 모두 남는 것이 아니기 때문입니다. Microsoft 문서에는 정확한 패턴이 설명되어 있지 않으므로, 게시자가 지연을 겪었는지, 다른 규칙이 적용되었는지, 아니면 버그인지는 판단할 수 없습니다. 이 부분은 미해결 상태로 둡니다.
1단계: 필요한 정리 모드 결정하기
Learn에서는 기존 버전을 정리하는 세 가지 모드를 설명합니다.
- 기간:
-DeleteBeforeDays <days>는 입력한 일수보다 오래된 버전을 삭제합니다. - 개수 제한: 앞에서 설명한
-MajorVersionLimit과-MajorWithMinorVersionsLimit입니다. - 자동:
-Automatic은 자동 설정의 논리를 기존 버전에 적용합니다.
버전 기록 제한에 관한 Learn 페이지는 버전 저장소를 최적화하기 위해 자동 설정을 권장합니다. 이 페이지에 따르면 자동 설정은 버전 기록의 복구 가치와 낮은 저장 용량 사용을 결합하므로, 개수나 기간 제한을 직접 추측할 필요가 없습니다. 플랜 버전 저장소 페이지에서는 자동 설정이 처음 30일 동안 생성된 버전을 500개 개수 제한 내에서 유지하고, 시간이 지남에 따라 이를 시간별, 일별, 주별 버전으로 줄여 나간다고 설명합니다.
기간 기준 정리에 대해 Learn은 두 가지 제한을 안내합니다. 작업은 최근 30일 이내에 생성된 버전을 삭제하지 않으므로 입력 값은 최소 30일이어야 합니다. 또한 2023년 1월 1일 이전에 생성된 모든 버전은 항상 삭제되므로, 선택한 일수로 계산한 날짜가 그 이후여야 합니다. 이 두 가지에 의존하기 전에 최신 페이지를 확인하십시오.
2단계: 보고서 생성 및 what-if 분석 실행하기
Learn의 정리 페이지는 정리 전에 what-if 분석을 실행하라고 안내합니다(작업 큐 등록 자습서에서는 이를 선택 사항이라고 설명합니다). 자습서에서는 사이트 또는 라이브러리의 버전 저장소 사용량 보고서를 설명하며, 이 보고서는 CSV 파일로 다운로드합니다. 그런 다음 PowerShell 7로 이 보고서를 대상으로 스크립트를 실행합니다. 개수 제한의 경우, 자습서의 what-if 스크립트는 -ImportPath, -ExportPath, -MajorVersionLimit을 받습니다. 마이너 버전 제한은 받지 않으므로, 개수 제한에 대한 what-if 결과는 메이저 버전 제한만 모델링합니다.
자습서 페이지에는 보고서를 만드는 cmdlet 이름이 나와 있지 않으므로, 이 단계는 Learn 자습서를 따르십시오. Learn에 따르면 정리 작업은 라이브러리 크기에 따라 며칠이 걸릴 수 있습니다. what-if 자습서에는 소요 시간이 나와 있지 않습니다.
3단계: 먼저 사이트 하나에 작업 큐 등록하기
SharePoint 관리자 권한으로 최신 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이 실행되면 어떤 일이 일어날지 보여 주는 기능으로만 설명하며, 이 cmdlet들에 대한 출력 내용은 자세히 다루지 않습니다. 따라서 이를 보고서 기반 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개씩 점진적으로 새 한도를 초과하는 기존 버전이 정리된다고 덧붙입니다. 관리 센터 UI에서는 주 버전을 100개 미만으로 설정하거나 만료 기간을 30일 미만으로 설정할 수 없습니다. Learn에서는 공개 API를 통해 더 낮은 값을 설정할 수 있지만, 의도치 않은 데이터 손실을 일으킬 수 있어 권장하지 않는다고 설명합니다.
6단계: 테넌트 전체 트리밍
Learn에는 New-SPOTenantApplyFileVersionPolicyJob(-CollectVersionData, -TrimVersions, -SetVersionPolicy 포함)과 같은 테넌트 수준 cmdlet이 나와 있습니다. 이들은 공개 미리 보기 상태이며, 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: 사이트 스토리지 한도 관리
- Microsoft Learn: 버전 기록 한도 개요
- Microsoft Learn: 문서 라이브러리의 버전 저장소 계획
- Microsoft Community Hub: SharePoint 버전 기록 정리 - 보조 버전(2026년 2월)