In deze blog delen we een praktische en veilige oplossing voor een veelvoorkomend probleem bij SharePoint-gebruikers. Als je regelmatig met grote bestanden werkt in SharePoint, ben je waarschijnlijk al eens tegen opslaglimieten aangelopen. Met het hieronder beschreven PowerShell-script kun je eenvoudig schijfruimte vrijmaken zonder belangrijke functionaliteit te verliezen. We behandelen ook alternatieve oplossingen en geven je praktische tips voor probleemoplossing.
Het probleem: SharePoint vol
Komt dit je bekend voor? Je probeert bestanden te uploaden naar SharePoint of wijzigingen aan te brengen aan bestaande documenten, maar je krijgt een foutmelding dat er geen ruimte meer is. Dit frustrerende probleem komt vaker voor dan je denkt, en heeft vaak een onverwachte oorzaak.
Uit onze ervaring met klanten blijkt dat dit probleem meestal pas wordt opgemerkt wanneer het te laat is – vaak tijdens een belangrijk project waarbij deadlines in gevaar komen. Een volle SharePoint-omgeving kan de productiviteit aanzienlijk verminderen en zelfs leiden tot dataverlies als bestanden niet kunnen worden opgeslagen.
De oorzaak: Versiebeheer
In SharePoint is versiebeheer standaard actief. Dit betekent dat elke keer dat je een document wijzigt, SharePoint automatisch een nieuwe versie opslaat. Op het eerste gezicht lijkt dit een geweldige functie – je kunt altijd terug naar eerdere versies van je werk als dat nodig is.
Maar er schuilt een probleem: bij grote bestanden zoals CAD-tekeningen, PowerPoint-presentaties met veel afbeeldingen, of grote Excel-bestanden kunnen deze versies veel opslagruimte innemen. Elke kleine aanpassing die je maakt resulteert in een geheel nieuwe versie die wordt opgeslagen. Na verloop van tijd kan dit leiden tot een SharePoint-omgeving die volledig vol raakt.
De oplossing: Automatische versies opschonen
Om dit probleem aan te pakken, hebben we een PowerShell-script ontwikkeld dat automatisch oudere versies van bestanden opschoont. Het script behoudt de 10 meest recente versies van elk bestand en verwijdert alle oudere versies.
Zo werkt het:
- Het script maakt verbinding met je SharePoint-omgeving
- Het identificeert alle documentbibliotheken binnen je site
- Voor elk bestand controleert het hoeveel versies er zijn
- Als er meer dan 10 versies zijn, worden de oudste versies verwijderd
- De 10 meest recente versies blijven behouden
Deze aanpak biedt een perfecte balans: je hebt nog steeds toegang tot recente versies van je documenten voor het geval je iets moet herstellen, maar je voorkomt dat je SharePoint-omgeving vol raakt met honderden of zelfs duizenden oude versies die je waarschijnlijk nooit meer nodig hebt.
Start vandaag nog met SharePoint intranet!
Het script gebruiken: stap voor stap
Het gebruik van het script vereist enkele voorbereidingen en voorzorgsmaatregelen:
Vereisten:
- PowerShell 5.1 of hoger
- PnP PowerShell module (installeerbaar via
Install-Module PnP.PowerShell) - Beheerdersrechten voor de SharePoint-omgeving
- Een back-up van je SharePoint-omgeving (dringend aanbevolen voordat je begint)
Stapsgewijze instructies:
- Maak eerst een back-up van je SharePoint-site Dit is cruciaal om gegevensverlies te voorkomen mocht er iets misgaan.
- Download en sla het script op als een .ps1 bestand op je lokale computer.
- Open PowerShell als administrator Klik met de rechtermuisknop op PowerShell in het startmenu en selecteer “Als administrator uitvoeren”.
- Navigeer naar de locatie van het script met het
cdcommando. - Voer het script uit met de opdracht: .\SharePointCleanup.ps1
- Volg de prompts op het scherm:
- Voer je tenant naam in (bijvoorbeeld: contoso.onmicrosoft.com)
- Voer de URL van je SharePoint-rootsite in
- Het script registreert automatisch een Entra ID-applicatie voor authenticatie
- Voer de URL in van de TeamSite waar je versies wilt opschonen
- Kies uit de lijst van beschikbare documentbibliotheken welke je wilt opschonen
- Controleer de resultaten Voor elk bestand zal het script tonen hoeveel versies er zijn gevonden en hoeveel er worden verwijderd.
- Verwijder de applicatieregistratie Na het uitvoeren van het script, ga naar het Entra-beheercentrum en verwijder de tijdelijk aangemaakte applicatieregistratie om beveiligingsrisico’s te voorkomen.
🚨BELANGRIJK: Vergeet na het gebruik van het script niet om de applicatieregistratie te verwijderen uit het Entra-beheercentrum! Dit is essentieel voor de beveiliging van je SharePoint-omgeving, aangezien de applicatie toegangsrechten heeft tot je data.
Code van het Script
Hieronder vind je de volledige code van het script. Je kunt dit kopiëren en in een PowerShell-bestand plakken om het te gebruiken.
1# Configuration2$CONFIG = @{3 APP_NAME = "SharePointVersionCleaner"4 VALID_SP_URL_PATTERN = "^https://[a-zA-Z0-9]+-my\.sharepoint\.com|^https://[a-zA-Z0-9]+\.sharepoint\.com"5}6 7function Connect-ToSharePoint {8 try {9 $script:TenantName = Read-Host "Voer je tenant naam in (bijvoorbeeld: contoso.onmicrosoft.com)"10 $script:SharePointRootSite = Read-Host "Voer de SharePoint root site URL in"11 if (-not ($script:SharePointRootSite -match $CONFIG.VALID_SP_URL_PATTERN)) {12 throw "Ongeldige SharePoint URL. Gebruik format: https://[tenant].sharepoint.com"13 }14 15 Write-Host "Registreren van Entra ID applicatie..." -ForegroundColor Yellow16 $Output = Register-PnPEntraIDAppForInteractiveLogin -ApplicationName $CONFIG.APP_NAME -Tenant $script:TenantName -Interactive17 18 # Zoek naar de regel met de ClientId19 $script:ClientId = $Output | Select-String -Pattern "ClientId\s+([\w-]+)" | ForEach-Object { $_.Matches.Groups[1].Value }20 21 # Verbind met de nieuwe app registratie22 Connect-PnPOnline -Url $script:SharePointRootSite -Interactive -ClientId $script:ClientId23 Write-Host "Succesvol verbonden met SharePoint Online!" -ForegroundColor Green24 return $true25 }26 catch {27 Write-Host "Fout bij verbinden: $($_.Exception.Message)" -ForegroundColor Red28 return $false29 }30}31 32function Connect-ToTeamSite {33 try {34 $script:TeamSiteUrl = Read-Host "Voer de URL in van de TeamSite waar je versies wilt opschonen"35 if (-not ($script:TeamSiteUrl -match $CONFIG.VALID_SP_URL_PATTERN)) {36 throw "Ongeldige SharePoint URL. Gebruik format: https://[tenant].sharepoint.com/sites/[site]"37 }38 39 # Verbind met de TeamSite met dezelfde ClientId40 Connect-PnPOnline -Url $script:TeamSiteUrl -Interactive -ClientId $script:ClientId41 Write-Host "Succesvol verbonden met TeamSite!" -ForegroundColor Green42 return $true43 }44 catch {45 Write-Host "Fout bij verbinden met TeamSite: $($_.Exception.Message)" -ForegroundColor Red46 return $false47 }48}49 50function Get-DocumentLibraries {51 try {52 $libraries = Get-PnPList | Where-Object { $_.BaseTemplate -eq 101 } | Select-Object Title, Id53 Write-Host "Beschikbare documentbibliotheken:" -ForegroundColor Cyan54 $libraries | Format-Table55 return $libraries56 }57 catch {58 Write-Host "Fout bij ophalen van documentbibliotheken: $($_.Exception.Message)" -ForegroundColor Red59 return $null60 }61}62 63function Clean-FileVersions {64 param (65 [string]$LibraryName66 )67 68 try {69 # Haal alle bestanden op uit de documentbibliotheek70 $files = Get-PnPListItem -List $LibraryName -PageSize 500 | Where-Object { $_.FileSystemObjectType -eq "File" }71 72 # Controleer of er bestanden zijn gevonden73 if ($null -eq $files -or $files.Count -eq 0) {74 Write-Host "Geen bestanden gevonden in de bibliotheek '$LibraryName'." -ForegroundColor Red75 return76 }77 78 Write-Host "Gevonden: $($files.Count) bestanden in de bibliotheek." -ForegroundColor Cyan79 80 # Verwerk elk bestand81 foreach ($file in $files) {82 try {83 Write-Host "Verwerken van bestand: $($file.FieldValues.FileLeafRef)" -ForegroundColor Cyan84 85 # Haal bestandsversies op86 $fileUrl = $file.FieldValues.FileRef87 $versions = Get-PnPFileVersion -Url $fileUrl88 89 # Tel het totaal aantal versies90 $totalVersions = $versions.Count91 Write-Host " Totaal aantal versies: $totalVersions"92 93 # Als er meer dan 10 versies zijn, verwijder de oudste94 if ($totalVersions -gt 10) {95 $versionsToDelete = $versions | Sort-Object -Property Created -Descending | Select-Object -Skip 1096 Write-Host " Verwijderen van $($versionsToDelete.Count) oude versies..." -ForegroundColor Yellow97 98 foreach ($versionToDelete in $versionsToDelete) {99 Write-Host " Verwijderen versie: $($versionToDelete.VersionLabel) gemaakt op $($versionToDelete.Created)"100 Remove-PnPFileVersion -Url $fileUrl -Identity $versionToDelete.ID -Force101 }102 }103 else {104 Write-Host " Geen versies om te verwijderen (10 of minder versies aanwezig)" -ForegroundColor Green105 }106 }107 catch {108 Write-Host "Fout bij verwerken van bestand $($file.FieldValues.FileLeafRef): $_" -ForegroundColor Red109 }110 }111 }112 catch {113 Write-Host "Fout bij opschonen van versies: $($_.Exception.Message)" -ForegroundColor Red114 }115}116 117# Main script118try {119 # Stap 1: Verbind met SharePoint120 if (-not (Connect-ToSharePoint)) {121 throw "Kon niet verbinden met SharePoint."122 }123 124 # Stap 2: Verbind met specifieke TeamSite125 if (-not (Connect-ToTeamSite)) {126 throw "Kon niet verbinden met TeamSite."127 }128 129 # Stap 3: Toon beschikbare documentbibliotheken130 $libraries = Get-DocumentLibraries131 if ($null -eq $libraries) {132 throw "Kon geen documentbibliotheken ophalen."133 }134 135 # Stap 4: Vraag welke bibliotheek opgeschoond moet worden136 $libraryName = Read-Host "Voer de naam in van de documentbibliotheek om op te schonen"137 138 # Stap 5: Schoon bestandsversies op139 Clean-FileVersions -LibraryName $libraryName140 Write-Host "Opschonen van versies voltooid!" -ForegroundColor Green141}142catch {143 Write-Host "Er is een fout opgetreden: $($_.Exception.Message)" -ForegroundColor Red144}145finally {146 # Verbreek de verbinding met SharePoint147 Disconnect-PnPOnline148 Write-Host "Verbinding met SharePoint verbroken." -ForegroundColor Cyan149} Het script in actie
Wanneer je het script uitvoert, zie je direct het proces in werking. Hieronder zie je een voorbeeld van de uitvoer bij een van onze klanten:
In dit voorbeeld zien we dat:
- De bibliotheek “Projectdocumenten” 324 bestanden bevatte
- 187 bestanden hadden meer dan 10 versies
- In totaal werd ongeveer 43 GB aan opslagruimte vrijgemaakt
- Het proces duurde ongeveer 15 minuten voor een bibliotheek van deze grootte
Veelvoorkomende problemen en oplossingen
Tijdens het gebruik van het script kunnen verschillende problemen optreden. Hier zijn enkele veelvoorkomende problemen en hun oplossingen:
Probleem: “Sommige versies worden niet verwijderd”
Oplossing:
- Controleer of er geen bestanden zijn ingecheckt
- Zorg ervoor dat er geen bestandsvergrendelingen actief zijn
- Controleer of je voldoende rechten hebt voor alle bestanden
Probleem: “Script werkt te langzaam bij grote bibliotheken”
Oplossing:
- Voer het script uit tijdens daluren
- Verdeel grote bibliotheken in kleinere batches
- Pas de PageSize parameter aan in het script (regel
$items = Get-PnPListItem -List $LibraryName -PageSize 500)
Probleem: “Kan geen verbinding maken met SharePoint”
Oplossing: Controleer of:
- Je de juiste tenant-naam hebt ingevoerd
- Je PowerShell met administratorrechten uitvoert
- De PnP.PowerShell module correct is geïnstalleerd (
Install-Module PnP.PowerShell -Force) - Je de juiste machtigingen hebt in SharePoint
Veiligheidsoverwegingen
Bij het gebruik van dit script zijn er enkele belangrijke veiligheidsaspecten om rekening mee te houden:
- Maak altijd een back-up voordat je het script uitvoert
- Test eerst in een niet-productieomgeving als dat mogelijk is
- Documenteer welke bibliotheken zijn opgeschoond voor toekomstige referentie
- Verwijder de applicatieregistratie onmiddellijk na gebruik om ongeautoriseerde toegang te voorkomen
- Informeer gebruikers voordat je het script uitvoert, zodat ze weten dat oudere versies worden verwijderd
Conclusie
SharePoint-opslagruimte is waardevol, en met dit script kun je ervoor zorgen dat je deze ruimte efficiënt gebruikt. Door automatisch oude versies op te schonen, kun je problemen met volle SharePoint-omgevingen voorkomen en toch de voordelen van versiebeheer behouden.
In de praktijk hebben we gezien dat klanten na het toepassen van deze oplossing niet alleen meer ruimte beschikbaar hebben, maar ook een snellere en efficiëntere SharePoint-ervaring krijgen. Grote documentbibliotheken laden sneller, en het risico op problemen tijdens het uploaden of bewerken van bestanden wordt aanzienlijk verminderd.
Als je vragen hebt over het gebruik van dit script of hulp nodig hebt bij andere SharePoint-gerelateerde uitdagingen, neem dan gerust contact met ons op.
Waarom kiezen voorIT Aanspreekpunt?
✅ Bewezen expertise– 10+ jaar SharePoint implementaties
✅ Lokale service– Persoonlijke begeleiding vanuit Enschede
✅ Complete ontzorging– Van advies tot implementatie en support
✅ Transparante prijzen– Geen verrassingen, heldere afspraken
Direct contact opnemen?
📞 Bel 053 203 2153 voor direct advies
📧 Mail naar [email protected]
📅 Plan een gratis SharePoint scan
