Ridurre le versioni dei file di SharePoint con limiti di conteggio: cosa significa davvero MajorWithMinorVersionsLimit
By Mirko Peters ·
Un processo di riduzione con -MajorVersionLimit 100 e -MajorWithMinorVersionsLimit 5 ha lasciato al loro posto tutte le versioni secondarie. Ecco come Microsoft descrive i due limiti, come eseguire una riduzione in sicurezza e cosa resta poco chiaro.
Automatically translated with AI from the original post. Read the English original
Un amministratore di SharePoint voleva ridurre lo spazio di archiviazione eliminando le versioni dei file in tutti i siti. Ha eseguito uno script che leggeva gli URL dei siti da un file CSV e richiamava New-SPOSiteFileVersionBatchDeleteJob con -MajorVersionLimit 100 e -MajorWithMinorVersionsLimit 5. L'aspettativa era: conservare le ultime 100 versioni principali e le ultime 5 versioni secondarie di ciascuna versione principale. Il risultato: le versioni principali sono state ridotte, ma sono rimaste tutte le versioni secondarie delle versioni principali rimanenti.
Punti chiave
- Microsoft Learn descrive -MajorWithMinorVersionsLimit come il numero di versioni principali per le quali vengono conservate tutte le versioni secondarie, e non come un limite massimo al numero di versioni secondarie.
- I due parametri di conteggio devono essere indicati insieme, e l'esercitazione di Learn usa -MajorWithMinorVersionsLimit 0 quando si devono contare solo le versioni principali.
- Le versioni eliminate vengono cancellate in modo permanente e aggirano il cestino, quindi esegui prima l'analisi what-if e fai una prova su un solo sito.
- I processi di riduzione vengono eseguiti in background, in batch, nei giorni successivi, e puoi controllarli o annullarli con i cmdlet di avanzamento e di rimozione.
- Learn non dice come vengano gestiti i file che hanno solo versioni secondarie (ad esempio 0.192), quindi verifica questo caso su una libreria di prova.
Questa domanda è stata pubblicata nella Microsoft Community Hub nel febbraio 2026 e non ha ancora una risposta. Questo articolo non pretende di risolverla. Mostra cosa dice Microsoft Learn sui due parametri, offre un modo prudente per eseguire una riduzione e segnala i punti in cui la documentazione e la discussione lasciano una lacuna. Non è una procedura ufficiale di Microsoft.
Che cosa fanno i due parametri secondo la documentazione
La pagina di Learn "Trim existing versions" riporta il comando con limite di conteggio in questo modo: New-SPOSiteFileVersionBatchDeleteJob -Identity $siteUrl -MajorVersionLimit <n> -MajorWithMinorVersionsLimit <n>. Il testo segnaposto del secondo parametro recita "number of major versions for which all minor versions will be kept". La pagina di Learn sui limiti di versione delle librerie usa quasi le stesse parole per Set-SPOListVersionPolicy: il numero di versioni principali per le quali vengono conservate tutte le versioni secondarie.
La pagina spiega inoltre che la modalità manuale con limite di conteggio elimina le versioni più vecchie che superano il limite specificato.
Altri tre dettagli dalla documentazione:
- Nel riferimento ai cmdlet, la sintassi con limite di conteggio richiede sia
-MajorVersionLimitsia-MajorWithMinorVersionsLimit. Ciascuna pagina indica che serve anche l'altro parametro. - L'esercitazione di Learn "Queue a trim job" mostra
-MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0e la descrive come una configurazione che conserva 100 versioni principali. - L'esempio del riferimento ai cmdlet usa
-MajorVersionLimit 30 -MajorWithMinorVersionsLimit 10.
Secondo me, il significato di questa formulazione non è "quante versioni secondarie conservare". Si avvicina piuttosto a "per quante versioni principali vuoi conservare ogni versione secondaria". Questa lettura differisce da quanto si aspettava chi ha posto la domanda. Non spiega nemmeno del tutto il risultato ottenuto da chi ha posto la domanda. Con un valore di 5, ci si aspetterebbe che tutte le versioni secondarie sopravvivano solo per un numero limitato di versioni principali, non per ogni versione principale conservata. Le pagine di Microsoft non descrivono lo schema esatto, quindi non posso dire se chi ha posto la domanda abbia notato un ritardo, una regola diversa o un bug. Consideralo un punto ancora aperto.
Passaggio 1: decidi quale modalità di riduzione ti serve
Microsoft Learn descrive tre modalità di riduzione per le versioni esistenti:
- In base all'età:
-DeleteBeforeDays <giorni>elimina le versioni più vecchie del numero di giorni indicato. - Limite di conteggio:
-MajorVersionLimite-MajorWithMinorVersionsLimit, come descritto sopra. - Automatica:
-Automaticapplica la logica dell'impostazione Automatica di controllo delle versioni alle versioni esistenti.
La pagina di Learn sui limiti della cronologia delle versioni consiglia l'impostazione Automatica per un'archiviazione ottimizzata delle versioni. Secondo la pagina, l'impostazione Automatica combina il valore di ripristino della cronologia delle versioni con un minore utilizzo dello spazio di archiviazione, senza che tu debba stabilire limiti di conteggio o di età. La pagina sull'archiviazione delle versioni del piano afferma che l'impostazione Automatica conserva le versioni create nei primi 30 giorni (entro un limite di 500 versioni), per poi diradarle a versioni orarie, giornaliere e settimanali man mano che invecchiano.
Per la riduzione basata sull'età, Learn elenca due limiti. Il processo non elimina le versioni create negli ultimi 30 giorni, quindi il valore inserito deve essere di almeno 30 giorni. Inoltre elimina sempre tutte le versioni create prima del 1° gennaio 2023, quindi il numero di giorni scelto deve produrre una data successiva a tale data. Verifica la pagina aggiornata prima di basarti su questi due punti.
Passaggio 2: genera il report ed esegui l'analisi "what-if"
La pagina di Learn sulla riduzione consiglia di eseguire un'analisi "what-if" prima della riduzione (l'esercitazione sull'accodamento di un processo la definisce facoltativa). Le esercitazioni descrivono un report sull'utilizzo dello spazio di archiviazione delle versioni per il sito o la libreria, che scarichi come file CSV. Successivamente esegui uno script sul report con PowerShell 7. Per il caso del limite di conteggio, lo script "what-if" dell'esercitazione accetta -ImportPath, -ExportPath e -MajorVersionLimit. Non accetta un limite per le versioni secondarie. Pertanto, il risultato "what-if" per i limiti di conteggio modella solo il limite delle versioni principali.
Le pagine delle esercitazioni non indicano il cmdlet che crea il report, quindi segui l'esercitazione di Learn per questo passaggio. Learn precisa che un processo di riduzione può richiedere alcuni giorni, a seconda delle dimensioni della libreria. L'esercitazione "what-if" non indica una durata.
Passaggio 3: accoda il processo prima su un sito
Connettiti come amministratore di SharePoint con la versione corrente di SharePoint Online Management Shell, quindi accoda un processo per un sito di prova:
``powershell New-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``
Per una sola libreria, usa la variante dedicata alle librerie:
``powershell New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 ``
Learn avverte che le versioni eliminate in questo modo vengono eliminate definitivamente e non finiscono nel cestino. La documentazione dei cmdlet elenca anche -WhatIf e -Confirm come parametri. La documentazione descrive -WhatIf solo come la visualizzazione di ciò che accadrebbe se il cmdlet venisse eseguito, senza dettagli sul suo output per questi cmdlet, quindi non considerarlo un sostituto dell'analisi "what-if" basata sul report.
Passaggio 4: monitora il processo
I processi di riduzione sono asincroni. Secondo Learn, l'eliminazione avviene in batch nei giorni successivi, e i volumi, lo stato del servizio e il carico della farm influiscono sui tempi. Controlla un processo a livello di sito con:
``powershell Get-SPOSiteFileVersionBatchDeleteJobProgress -Identity https://contoso.sharepoint.com/sites/site1 ``
Per un processo su una libreria, la pagina di Learn sulla riduzione elenca Get-SPOListFileVersionBatchDeleteJobProgress -Site <url> -List <nome>. Per interrompere un processo, usa Remove-SPOSiteFileVersionBatchDeleteJob oppure Remove-SPOListFileVersionBatchDeleteJob. Annullare il processo interrompe ulteriori eliminazioni, ma non ripristina le versioni già eliminate.
Non aspettarti che il report sullo spazio di archiviazione cambi subito. La pagina di Learn sui limiti di spazio di archiviazione dei siti indica che l'utilizzo non include le modifiche delle ultime da 24 a 48 ore.
Passaggio 5: imposta i limiti per le nuove versioni
Un job di trim gestisce solo le versioni che esistono oggi. Per controllare le versioni future, imposta il criterio di versione sul sito o sulla libreria:
- Sito:
Set-SPOSite -Identity <url> -EnableAutoExpirationVersionTrim $trueper i limiti «Automatic». Learn elenca-ApplyToNewDocumentLibrariese-ApplyToExistingDocumentLibrariesper scegliere l'ambito. - Libreria:
Set-SPOListVersionPolicy -Site <url> -List <name> -EnableAutoExpirationVersionTrim $true.
Impostare un criterio per sito o libreria non elimina le versioni già esistenti, quindi accoda un job di trim per quelle. Le modifiche alle librerie esistenti vengono elaborate in un job in background che, secondo Learn, può richiedere fino a 24 ore. Learn aggiunge che, quando abbassi il limite di numero di versioni su una libreria, le versioni esistenti oltre il nuovo limite vengono eliminate gradualmente, fino a 20 per ogni nuova versione creata. L'interfaccia dell'interfaccia di amministrazione non accetta meno di 100 versioni principali né una scadenza inferiore a 30 giorni. Learn precisa che valori più bassi sono possibili tramite le API pubbliche, ma non sono consigliati, perché possono causare perdita di dati accidentale.
Passaggio 6: trim a livello di tenant
Learn elenca cmdlet a livello di tenant come New-SPOTenantApplyFileVersionPolicyJob (con -CollectVersionData, -TrimVersions e -SetVersionPolicy). Sono in anteprima pubblica, richiedono una licenza SharePoint Advanced Management o una licenza Copilot ed escludono i siti in sola lettura, bloccati e archiviati. Può essere in esecuzione un solo job a livello di tenant alla volta. Se gestisci molti siti, confronta questa strada con un loop su CSV come quello del thread.
Cosa resta poco chiaro
- File con sole versioni minori: chi ha scritto la domanda riguarda file che non sono mai stati pubblicati come versione principale e che hanno centinaia di versioni minori, come 0.192. Learn non dice come il trim basato sul numero di versioni li tratti. Crea una libreria di prova, aggiungi un file del genere ed esegui un job piccolo prima di toccare la produzione.
- Risultato discordante: l'osservazione di chi ha scritto, secondo cui sono rimaste tutte le versioni minori di ogni versione principale conservata, non è spiegata dalle pagine che ho letto.
- Conservazione: la pagina di Learn sul trim rimanda a una FAQ per le versioni soggette a criteri di conservazione o blocchi di eDiscovery. Non descrive però il comportamento nella pagina stessa.
Correlati
- SharePoint
- Controllo versioni intelligente
- Librerie di documenti SharePoint
- SharePoint Advanced Management
Fonti
- Microsoft Learn: Eliminare le versioni esistenti da sito, libreria o OneDrive
- Microsoft Learn: Accodare un job di trim per un sito o una libreria di documenti
- Microsoft Learn: Eseguire un'analisi what-if
- Microsoft Learn: New-SPOSiteFileVersionBatchDeleteJob
- Microsoft Learn: Impostare i limiti di versione per una singola libreria di documenti
- Microsoft Learn: Impostare i limiti di versione per un sito
- Microsoft Learn: Gestire i limiti di spazio di archiviazione dei siti
- Microsoft Learn: Panoramica dei limiti della cronologia versioni
- Microsoft Learn: Pianificare l'archiviazione delle versioni nelle raccolte di documenti
- Microsoft Community Hub: Riduzione della cronologia versioni di SharePoint - Versioni secondarie (febbraio 2026)