Prompt
Beheerscript schrijven met controlestappen
Laat een PowerShell- of ander beheerscript opstellen met testmodus, logging en minimale rechten, zodat je het veilig kunt controleren voordat het iets wijzigt.
CodingGemiddeld
Wanneer gebruik je deze prompt?
Je wilt een terugkerende beheertaak bij klanten automatiseren, maar een script dat in één keer veel accounts aanpast mag niet fout gaan.
De prompt
Kopieer de prompt en vervang de gemarkeerde variabelen door jouw situatie.
Je bent een ervaren Microsoft 365- en Windows-beheerder. Schrijf een {{taal}}-script voor deze taak.
Taak: {{taak}}
Omgeving: {{omgeving}}
Beperkingen: {{beperkingen}}
Eisen aan het script:
1. Standaard een testmodus die alleen toont wat er zou veranderen, zonder iets te wijzigen. Pas met een expliciete parameter voert het script wijzigingen uit.
2. Logging naar een bestand: wat is gecontroleerd, wat is gewijzigd en wat ging fout.
3. Foutafhandeling per item, zodat één fout de rest niet stopt en niets half uitgevoerd blijft zonder melding.
4. Geen wachtwoorden, tokens, client secrets of tenant-ID's in de code. Gebruik parameters of een veilige inlogmethode, en leg uit welke.
5. Alleen de minimale rechten die nodig zijn. Noem welke rol of permissie het account nodig heeft.
Lever daarna:
- Een uitleg per blok in gewone taal.
- Welke modules en cmdlets je gebruikt, en welke ik moet nakijken in de officiële documentatie omdat ze verouderd of gewijzigd kunnen zijn.
- Hoe ik het eerst veilig test op één gebruiker of in een testomgeving.Vul in en kopieer
Typ je situatie bij elk veld; de prompt wordt meteen aangepast.
Je bent een ervaren Microsoft 365- en Windows-beheerder. Schrijf een {{taal}}-script voor deze taak.
Taak: {{taak}}
Omgeving: {{omgeving}}
Beperkingen: {{beperkingen}}
Eisen aan het script:
1. Standaard een testmodus die alleen toont wat er zou veranderen, zonder iets te wijzigen. Pas met een expliciete parameter voert het script wijzigingen uit.
2. Logging naar een bestand: wat is gecontroleerd, wat is gewijzigd en wat ging fout.
3. Foutafhandeling per item, zodat één fout de rest niet stopt en niets half uitgevoerd blijft zonder melding.
4. Geen wachtwoorden, tokens, client secrets of tenant-ID's in de code. Gebruik parameters of een veilige inlogmethode, en leg uit welke.
5. Alleen de minimale rechten die nodig zijn. Noem welke rol of permissie het account nodig heeft.
Lever daarna:
- Een uitleg per blok in gewone taal.
- Welke modules en cmdlets je gebruikt, en welke ik moet nakijken in de officiële documentatie omdat ze verouderd of gewijzigd kunnen zijn.
- Hoe ik het eerst veilig test op één gebruiker of in een testomgeving.Nog 4 velden leeg; die blijven als {{...}} staan.
Wat je hier typt, blijft in je browser; het wordt nergens heen gestuurd.
Variabelen
| Variabele | Wat vul je in? | Voorbeeld |
|---|---|---|
| {{taal}} | De scripttaal | PowerShell |
| {{taak}} | Wat het script moet doen | alle gedeelde mailboxen zonder eigenaar opsporen en in een CSV-bestand zetten |
| {{omgeving}} | Waar het script draait, zonder echte tenantnamen | Microsoft 365-omgeving van een klant met 40 gebruikers, beheer via Exchange Online PowerShell |
| {{beperkingen}} | Wat het script niet mag doen | niets verwijderen of wijzigen, alleen rapporteren |
Wat krijg je terug?
Een script met testmodus, logging en foutafhandeling, plus uitleg per blok, benodigde rechten en een testplan.
Hieronder staat een PowerShell-script dat gedeelde mailboxen zonder eigenaar opspoort via Exchange Online PowerShell. Omdat de taak puur rapporterend is, wordt de scheiding tussen testmodus en uitvoering toegepast op het wegschrijven van het CSV-bestand: in testmodus zie je het resultaat alleen op het scherm, pas met de parameter Uitvoeren wordt het CSV-bestand daadwerkelijk aangemaakt.
Script
param(
[switch]$Uitvoeren,
[string]$CsvPad = ".\GedeeldeMailboxenZonderEigenaar.csv",
[string]$LogPad = ".\GedeeldeMailboxenCheck.log"
)
function Schrijf-Log {
param([string]$Bericht)
$tijd = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
$regel = "$tijd - $Bericht"
Add-Content -Path $LogPad -Value $regel
Write-Host $regel
}
Schrijf-Log "Script gestart. Modus: $(if ($Uitvoeren) {'UITVOEREN'} else {'TESTMODUS'})"
try {
if (-not (Get-Module -ListAvailable -Name ExchangeOnlineManagement)) {
throw "Module ExchangeOnlineManagement is niet geïnstalleerd. Installeer met: Install-Module ExchangeOnlineManagement"
}
Import-Module ExchangeOnlineManagement -ErrorAction Stop
Connect-ExchangeOnline -ShowBanner:$false -ErrorAction Stop
Schrijf-Log "Verbonden met Exchange Online."
}
catch {
Schrijf-Log "FOUT bij verbinden: $($_.Exception.Message)"
exit 1
}
$resultaten = @()
try {
$gedeeldeMailboxen = Get-Mailbox -RecipientTypeDetails SharedMailbox -ResultSize Unlimited -ErrorAction Stop
Schrijf-Log "Aantal gedeelde mailboxen gevonden: $($gedeeldeMailboxen.Count)"
}
catch {
Schrijf-Log "FOUT bij ophalen gedeelde mailboxen: $($_.Exception.Message)"
Disconnect-ExchangeOnline -Confirm:$false
exit 1
}
foreach ($mb in $gedeeldeMailboxen) {
try {
$permissies = Get-MailboxPermission -Identity $mb.Identity -ErrorAction Stop |
Where-Object { $_.User -notlike "NT AUTHORITY\SELF" -and $_.IsInherited -eq $false }
Schrijf-Log "Gecontroleerd: $($mb.PrimarySmtpAddress) - aantal toegewezen gebruikers: $($permissies.Count)"
if (-not $permissies -or $permissies.Count -eq 0) {
$resultaten += [PSCustomObject]@{
Mailbox = $mb.DisplayName
PrimarySmtp = $mb.PrimarySmtpAddress
Gecontroleerd = (Get-Date -Format "yyyy-MM-dd HH:mm:ss")
Status = "Geen eigenaar/toegang gevonden"
}
}
}
catch {
Schrijf-Log "FOUT bij controleren van $($mb.PrimarySmtpAddress): $($_.Exception.Message)"
continue
}
}
Schrijf-Log "Aantal mailboxen zonder eigenaar: $($resultaten.Count)"
if ($Uitvoeren) {
try {
$resultaten | Export-Csv -Path $CsvPad -NoTypeInformation -Encoding UTF8 -ErrorAction Stop
Schrijf-Log "CSV weggeschreven naar $CsvPad met $($resultaten.Count) regels."
}
catch {
Schrijf-Log "FOUT bij wegschrijven van CSV: $($_.Exception.Message)"
}
}
else {
Schrijf-Log "TESTMODUS: er is geen CSV weggeschreven. Resultaat op het scherm:"
$resultaten | Format-Table -AutoSize | Out-String | Write-Host
}
Disconnect-ExchangeOnline -Confirm:$false
Schrijf-Log "Verbinding verbroken, script afgerond."
Uitleg per blok
Parameters: Uitvoeren is de schakelaar tussen testmodus en uitvoering. Zonder die parameter draait het script altijd in testmodus. CsvPad en LogPad bepalen waar het rapport en het logbestand komen, standaard in de map waar je het script start.
Schrijf-Log: elke melding gaat zowel naar het scherm als naar het logbestand, met tijdstip. Zo zie je achteraf precies wat er is gecontroleerd en waar iets misging.
Verbinden: het script controleert eerst of de module ExchangeOnlineManagement aanwezig is en maakt dan verbinding. Connect-ExchangeOnline opent het normale Microsoft-inlogscherm, inclusief MFA. Er staan dus geen wachtwoorden, tokens of tenant-ID's in het script.
Mailboxen ophalen: Get-Mailbox haalt alleen gedeelde mailboxen op (RecipientTypeDetails SharedMailbox), zonder limiet op het aantal.
Controle per mailbox: Get-MailboxPermission toont wie toegang heeft. Het systeemaccount NT AUTHORITY\SELF en overgeërfde rechten worden genegeerd. Blijft er niemand over, dan heeft de mailbox in de praktijk geen eigenaar en komt hij in de lijst. Een fout bij één mailbox wordt gelogd, waarna het script doorgaat met de volgende.
Rapport: in testmodus zie je de lijst op het scherm, met de parameter Uitvoeren wordt hij als CSV opgeslagen. Het script wijzigt in geen van beide gevallen iets aan de mailboxen.
Modules en cmdlets om na te kijken
Module ExchangeOnlineManagement, versie 3 of hoger. Cmdlets: Connect-ExchangeOnline, Get-Mailbox, Get-MailboxPermission en Disconnect-ExchangeOnline. Controleer in de officiële documentatie of Get-Mailbox in jouw moduleversie nog de aanbevolen cmdlet is: Microsoft raadt in nieuwere versies Get-EXOMailbox en Get-EXOMailboxPermission aan, die sneller zijn bij grote aantallen. De parameternamen kunnen daar iets verschillen.
Benodigde rechten
Alleen leesrechten. De rol View-Only Recipients in Exchange Online, onderdeel van de rolgroep View-Only Organization Management, is voldoende. Een Global Admin-account is niet nodig en voor deze taak af te raden.
Veilig testen
1. Draai het script zonder parameters, in een testtenant of bij de klant. Er wordt niets gewijzigd en niets weggeschreven; controleer het logbestand en de lijst op het scherm.
2. Maak in de testomgeving één gedeelde mailbox aan zonder rechten toe te wijzen en draai het script opnieuw. Die mailbox moet nu in de lijst staan.
3. Draai het script met de parameter Uitvoeren en open het CSV-bestand in Excel. Controleer of de kolommen en het aantal regels kloppen met het logbestand.
4. Pas daarna plan je het script in als terugkerende taak.
Eén keer gemaakt met Claude en nagelezen. Jouw antwoord verschilt: het hangt af van wat je invult en van het model.
Tips
- Begin met een script dat alleen leest en rapporteert. Bouw de wijzigende stap pas toe als de rapportage klopt.
- Laat het script daarna nog eens beoordelen met de vraag: wat kan hier misgaan bij 500 gebruikers in plaats van 5?