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

Blog · Mirko Peters

Ridurre le versioni dei file di SharePoint con limiti di conteggio: cosa significa davvero MajorWithMinorVersionsLimit

By ·

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:

  1. Nel riferimento ai cmdlet, la sintassi con limite di conteggio richiede sia -MajorVersionLimit sia -MajorWithMinorVersionsLimit. Ciascuna pagina indica che serve anche l'altro parametro.
  2. L'esercitazione di Learn "Queue a trim job" mostra -MajorVersionLimit 100 -MajorWithMinorVersionsLimit 0 e la descrive come una configurazione che conserva 100 versioni principali.
  3. 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: -MajorVersionLimit e -MajorWithMinorVersionsLimit, come descritto sopra.
  • Automatica: -Automatic applica 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 $true per i limiti «Automatic». Learn elenca -ApplyToNewDocumentLibraries e -ApplyToExistingDocumentLibraries per 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

Fonti

Entities in this article

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

Related articles

RSS