SharePoint

SharePoint vol? Zo maak je ruimte vrij

Ruben Talman Bijgewerkt op · 6 min. lezen

SharePoint vol? Zo maak je ruimte vrij
Op deze pagina
  1. Het probleem: SharePoint vol
  2. De oorzaak: Versiebeheer
  3. De oplossing: Automatische versies opschonen
  4. Het script gebruiken: stap voor stap
  5. Code van het Script
  6. Het script in actie
  7. Veelvoorkomende problemen en oplossingen
  8. Veiligheidsoverwegingen
  9. Conclusie
  10. Waarom kiezen voorIT Aanspreekpunt?

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:

  1. Het script maakt verbinding met je SharePoint-omgeving
  2. Het identificeert alle documentbibliotheken binnen je site
  3. Voor elk bestand controleert het hoeveel versies er zijn
  4. Als er meer dan 10 versies zijn, worden de oudste versies verwijderd
  5. 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:

  1. Maak eerst een back-up van je SharePoint-site Dit is cruciaal om gegevensverlies te voorkomen mocht er iets misgaan.
  2. Download en sla het script op als een .ps1 bestand op je lokale computer.
  3. Open PowerShell als administrator Klik met de rechtermuisknop op PowerShell in het startmenu en selecteer “Als administrator uitvoeren”.
  4. Navigeer naar de locatie van het script met het cd commando.
  5. Voer het script uit met de opdracht: .\SharePointCleanup.ps1
  6. 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
  7. Controleer de resultaten Voor elk bestand zal het script tonen hoeveel versies er zijn gevonden en hoeveel er worden verwijderd.
  8. 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.

PowerShell
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:

  1. Maak altijd een back-up voordat je het script uitvoert
  2. Test eerst in een niet-productieomgeving als dat mogelijk is
  3. Documenteer welke bibliotheken zijn opgeschoond voor toekomstige referentie
  4. Verwijder de applicatieregistratie onmiddellijk na gebruik om ongeautoriseerde toegang te voorkomen
  5. 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

SharePoint dat wél werkt voor je team?

Bekijk SharePoint-inrichting

We bellen je zo terug

0 / 2000 tekens

We gebruiken je gegevens alleen om contact met je op te nemen. Zie onze privacyverklaring.