M365Con 2027 – conferencia online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Recortar versiones de archivos de SharePoint con límites de recuento: qué significa realmente MajorWithMinorVersionsLimit

Por ·

Un trabajo de recorte con -MajorVersionLimit 100 y -MajorWithMinorVersionsLimit 5 dejó todas las versiones secundarias en su sitio. Aquí tienes qué describe Microsoft sobre los dos límites, cómo ejecutar un recorte seguro y qué sigue sin estar claro.

Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés

Un administrador de SharePoint quería reducir el almacenamiento recortando versiones de archivos en todos los sitios. Ejecutó un script que leía las URL de los sitios desde un archivo CSV y llamaba a New-SPOSiteFileVersionBatchDeleteJob con -MajorVersionLimit 100 y -MajorWithMinorVersionsLimit 5. La expectativa era conservar las últimas 100 versiones principales y las últimas 5 versiones secundarias de cada versión principal. Lo que ocurrió fue que se recortaron las versiones principales, pero se conservaron todas las versiones secundarias de las versiones principales restantes.

Puntos clave

  • Microsoft Learn describe -MajorWithMinorVersionsLimit como el número de versiones principales para las que se conservan todas las versiones secundarias, no como un límite máximo para el número de versiones secundarias.
  • Los dos parámetros de recuento deben indicarse juntos, y el tutorial de Learn usa -MajorWithMinorVersionsLimit 0 cuando solo se deben contar las versiones principales.
  • Las versiones recortadas se eliminan de forma permanente y se saltan la papelera de reciclaje, así que ejecuta primero el análisis what-if y haz una prueba en un solo sitio.
  • Los trabajos de recorte se ejecutan en segundo plano, por lotes, durante los días siguientes, y puedes consultarlos o cancelarlos con los cmdlets de progreso y de eliminación.
  • Learn no indica cómo se tratan los archivos que solo tienen versiones secundarias (por ejemplo, 0.192), así que verifica ese caso en una biblioteca de prueba.

Esa pregunta se publicó en Microsoft Community Hub en febrero de 2026 y no tiene respuesta. Este artículo no pretende resolverla. Muestra lo que Microsoft Learn dice sobre los dos parámetros, te ofrece una forma cuidadosa de ejecutar un recorte y señala los puntos en los que la documentación y el hilo dejan un vacío. No es un procedimiento oficial de Microsoft.

Lo que la documentación dice que hacen los dos parámetros

La página de Learn "Trim existing versions" muestra el comando con límite de recuento así: New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. El texto de marcador del segundo parámetro dice "number of major versions for which all minor versions will be kept". La página de Learn sobre los límites de versiones de biblioteca usa casi las mismas palabras para Set-SPOListVersionPolicy: el número de versiones principales para las que se conservan todas las versiones secundarias.

La página también indica que el modo manual de límite de recuento elimina las versiones más antiguas que superan el límite especificado.

Tres detalles más de la documentación:

  1. En la referencia de cmdlets, la sintaxis del límite de recuento exige tanto -MajorVersionLimit como -MajorWithMinorVersionsLimit. Cada página indica que también necesitas el otro parámetro.
  2. El tutorial de Learn "Queue a trim job" muestra -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 y lo describe como la conservación de 100 versiones principales.
  3. El ejemplo de la referencia de cmdlets usa -MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10.

Mi lectura de esta redacción es que el segundo número no significa "cuántas versiones secundarias conservar". Se acerca más a "para cuántas versiones principales quieres conservar todas las versiones secundarias". Esa lectura difiere de lo que esperaba el autor de la pregunta, y tampoco explica del todo su resultado. Con un valor de 5, esperarías que todas las versiones secundarias sobrevivieran solo durante un número limitado de versiones principales, no en cada versión principal conservada. Las páginas de Microsoft no describen el patrón exacto, así que no puedo saber si el autor vio un retraso, otra regla o un error. Lo dejo como cuestión abierta.

Paso 1: decide qué modo de recorte necesitas

Learn describe tres modos de recorte para las versiones existentes:

  • Antigüedad: -DeleteBeforeDays <días> elimina las versiones más antiguas que el número de días que indiques.
  • Límite de recuento: -MajorVersionLimit y -MajorWithMinorVersionsLimit, como se indicó antes.
  • Automático: -Automatic aplica la lógica de la configuración de versiones automática a las versiones existentes.

La página de Learn sobre los límites del historial de versiones recomienda la configuración Automática para un almacenamiento de versiones optimizado. Según indica, la configuración Automática combina el valor de recuperación del historial de versiones con un menor uso de almacenamiento, sin que tengas que adivinar límites de recuento o de antigüedad. La página sobre el almacenamiento de versiones del plan dice que Automática conserva las versiones creadas en los primeros 30 días (dentro de un límite de 500 versiones) y, después, las reduce a versiones por hora, diarias y semanales a medida que envejecen.

Para el recorte basado en antigüedad, Learn enumera dos límites. El trabajo no elimina las versiones creadas en los últimos 30 días, así que la entrada debe ser de al menos 30 días. Además, siempre elimina todas las versiones creadas antes del 1 de enero de 2023, por lo que el número de días que elijas debe producir una fecha posterior a esa. Consulta la página actual antes de basarte en estos dos puntos.

Paso 2: genera el informe y ejecuta el análisis what-if

La página de recorte de Learn indica que ejecutes un análisis what-if antes de recortar (el tutorial de poner un trabajo en cola lo califica de opcional). Los tutoriales describen un informe de uso del almacenamiento de versiones del sitio o de la biblioteca, que descargas como archivo CSV. Después, ejecutas un script contra el informe con PowerShell 7. En el caso del límite de recuento, el script what-if del tutorial acepta -ImportPath, -ExportPath y -MajorVersionLimit. No acepta un límite de versiones secundarias. Por tanto, el resultado what-if para los límites de recuento solo modela el límite de versiones principales.

Las páginas de los tutoriales no indican el cmdlet que crea el informe, así que sigue el tutorial de Learn para ese paso. Learn señala que un trabajo de recorte puede tardar unos días según el tamaño de la biblioteca. El tutorial de what-if no indica ninguna duración.

Paso 3: pon en cola el trabajo primero en un sitio

Conéctate como administrador de SharePoint con la versión actual de SharePoint Online Management Shell y, después, pon en cola un trabajo para un sitio de prueba:

``powershell New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``

Para una biblioteca, usa la variante de biblioteca:

``powershell New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``

Learn advierte de que las versiones eliminadas de este modo se borran de forma permanente y no van a la papelera de reciclaje. La referencia de cmdlets también enumera -WhatIf y -Confirm como parámetros. La referencia describe -WhatIf solo como la visualización de lo que ocurriría si se ejecuta el cmdlet, sin detallar su salida para estos cmdlets, así que no lo consideres un sustituto del análisis what-if basado en el informe.

Paso 4: supervisa el trabajo

Los trabajos de recorte son asíncronos. Según Learn, la eliminación se realiza por lotes durante los días siguientes, y el volumen, el estado del servicio y la carga de la granja afectan al tiempo que tarda. Comprueba un trabajo a nivel de sitio con:

``powershell Get-SPOSiteFileVersionBatchDeleteJobProgress -Identity https://contoso.sharepoint.com/sites/site1 ``

Para un trabajo de biblioteca, la página de recorte de Learn enumera Get-SPOListFileVersionBatchDeleteJobProgress -Site <url> -List <nombre>. Para detener un trabajo, usa Remove-SPOSiteFileVersionBatchDeleteJob o Remove-SPOListFileVersionBatchDeleteJob. Cancelar detiene las eliminaciones posteriores, pero no restaura las versiones que ya se hayan eliminado.

No esperes que el informe de almacenamiento cambie de inmediato. La página de Learn sobre los límites de almacenamiento del sitio indica que el uso de almacenamiento no incluye los cambios de las últimas 24 a 48 horas.

Paso 5: Establece límites para las nuevas versiones

Un trabajo de recorte solo procesa las versiones que existen hoy. Para controlar las versiones futuras, establece la directiva de versiones en el sitio o en la biblioteca:

  • Sitio: Set-SPOSite -Identity <url> -EnableAutoExpirationVersionTrim $true para los límites automáticos. Learn enumera -ApplyToNewDocumentLibraries y -ApplyToExistingDocumentLibraries para elegir el alcance.
  • Biblioteca: Set-SPOListVersionPolicy -Site <url> -List <name> -EnableAutoExpirationVersionTrim $true.

Establecer una directiva en el sitio o en la biblioteca no recorta las versiones que ya existen, así que pon en cola un trabajo de recorte para esas. Los cambios en las bibliotecas existentes se procesan en un trabajo en segundo plano que, según Learn, puede tardar hasta 24 horas. Learn añade que, cuando reduces el límite de recuento de una biblioteca, las versiones existentes por encima del nuevo límite se recortan de forma gradual, hasta 20 por cada versión nueva creada. El centro de administración no acepta menos de 100 versiones principales ni una caducidad inferior a 30 días. Learn indica que los valores más bajos son posibles mediante las API públicas, pero no se recomiendan, porque pueden provocar una pérdida de datos involuntaria.

Paso 6: Recorte en todo el inquilino

Learn enumera cmdlets de nivel de inquilino como New-SPOTenantApplyFileVersionPolicyJob (con -CollectVersionData, -TrimVersions y -SetVersionPolicy). Están en vista previa pública, requieren una licencia de SharePoint Advanced Management o una licencia de Copilot, y excluyen los sitios de solo lectura, bloqueados y archivados. Solo puede ejecutarse un trabajo de inquilino a la vez. Si administras muchos sitios, compara esta ruta con un bucle de CSV como el del hilo.

Lo que sigue sin estar claro

  • Archivos solo con versiones secundarias: El autor de la publicación preguntó por archivos que nunca se publicaron como versión principal y que tienen cientos de versiones secundarias, como la 0.192. Learn no indica cómo trata el recorte por límite de recuento a estos archivos. Crea una biblioteca de prueba, añade un archivo de este tipo y ejecuta un trabajo pequeño antes de tocar producción.
  • Discrepancia en los resultados: La observación del autor de que se conservaron todas las versiones secundarias de cada versión principal retenida no se explica en las páginas que he leído.
  • Retención: La página de Learn sobre el recorte remite a unas preguntas frecuentes sobre las versiones sujetas a directivas de retención o a retenciones de eDiscovery. Sin embargo, no describe el comportamiento en la propia página.

Relacionado

Fuentes

Entidades en este artículo

SharePoint Intelligent versioning (SharePoint) SharePoint document libraries SharePoint Advanced Management

Artículos relacionados

RSS