Repair-ExchangeService.ps1
|
<#PSScriptInfo
.VERSION 1.0.0 .GUID 29efc124-74bd-59c1-9491-786b61fd67ae .AUTHOR Torsten Weise .COMPANYNAME powerscripting.de .COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz. .TAGS Powerscripting German Exchange ExchangeOnline Mailbox PSEdition_Desktop PSEdition_Core .LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt .PROJECTURI https://powerscripting.de/skripte/repair-exchangeservice.html .ICONURI https://powerscripting.de/assets/icon-192.png .EXTERNALMODULEDEPENDENCIES Exchange Management Shell .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES Erste Veröffentlichung in der PowerShell Gallery. .PRIVATEDATA #> <# .SYNOPSIS Prüft, ob alle Exchange-Dienste richtig eingestellt sind und laufen, und korrigiert sie auf Wunsch. .DESCRIPTION Welche Dienste ein Exchange-Server braucht, weiß Exchange selbst: Test-ServiceHealth liefert für jede installierte Rolle die Liste der benötigten Dienste. Das Skript prüft für jeden dieser Dienste: - Starttyp: Soll ist "Automatisch". Nach abgebrochenen Updates stehen Dienste oft auf "Deaktiviert". - Status: Soll ist "Läuft". Zusätzlich werden alle übrigen Exchange-Dienste (MSExchange*) aufgelistet, damit deaktivierte oder gestoppte Dienste auffallen, die Test-ServiceHealth nicht als Pflicht führt, zum Beispiel POP3 und IMAP4. Mit -Fix werden falsche Starttypen auf "Automatisch" gesetzt und gestoppte Pflichtdienste gestartet. Mit -IncludeComponents prüft das Skript außerdem die Serverkomponenten (Get-ServerComponentState). Nach einem fehlgeschlagenen kumulativen Update bleiben dort oft Komponenten auf "Inactive", und der Server nimmt keine Verbindungen an, obwohl alle Dienste laufen. -FixComponents setzt sie wieder aktiv. Läuft in der Exchange Management Shell (Exchange Server 2016, 2019 und Subscription Edition). .PARAMETER Server Exchange-Server, der geprüft wird. Standard: der lokale Server. .PARAMETER Fix Starttypen korrigieren und gestoppte Pflichtdienste starten. .PARAMETER IncludePopImap POP3- und IMAP4-Dienste wie Pflichtdienste behandeln. Nur verwenden, wenn POP3 oder IMAP4 genutzt wird. .PARAMETER IncludeComponents Zusätzlich die Serverkomponenten prüfen. .PARAMETER FixComponents Inaktive Serverkomponenten wieder aktivieren. Nicht verwenden, solange der Server absichtlich im Wartungsmodus ist, etwa während Updates in einer DAG. .EXAMPLE .\Repair-ExchangeService.ps1 Zeigt den Zustand aller Exchange-Dienste auf dem lokalen Server, ohne etwas zu ändern. .EXAMPLE .\Repair-ExchangeService.ps1 -Fix -WhatIf Zeigt, welche Dienste korrigiert und gestartet würden. .EXAMPLE .\Repair-ExchangeService.ps1 -Server EX01 -Fix -IncludeComponents -FixComponents Korrigiert Dienste und Serverkomponenten auf EX01, zum Beispiel nach einem abgebrochenen kumulativen Update. .NOTES Autor: Torsten Weise, powerscripting.de Starttyp-Änderungen auf einem entfernten Server nutzen Set-Service -ComputerName und laufen deshalb in Windows PowerShell 5.1, also in der Exchange Management Shell. Der Wartungsmodus wird an der Komponente ServerWideOffline erkannt und als Warnung gemeldet. ForwardSyncDaemon und ProvisioningRps sind bei lokalen Installationen standardmäßig inaktiv und werden deshalb nicht als Abweichung gewertet. #> [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Medium')] param( [string] $Server = $env:COMPUTERNAME, [switch] $Fix, [switch] $IncludePopImap, [switch] $IncludeComponents, [switch] $FixComponents ) if (-not (Get-Command Test-ServiceHealth -ErrorAction SilentlyContinue)) { throw 'Dieses Skript muss in der Exchange Management Shell laufen.' } $popImap = 'MSExchangePOP3', 'MSExchangePOP3BE', 'MSExchangeIMAP4', 'MSExchangeIMAP4BE' # 1. Pflichtdienste laut Exchange $required = Test-ServiceHealth -Server $Server | ForEach-Object { $_.ServicesRunning + $_.ServicesNotRunning } | Sort-Object -Unique if ($IncludePopImap) { $required = @($required) + $popImap | Sort-Object -Unique } # 2. Alle Dienste mit Starttyp lesen (CIM liefert StartMode auch für entfernte Server) $all = Get-CimInstance -ComputerName $Server -ClassName Win32_Service | Where-Object { $required -contains $_.Name -or $_.Name -like 'MSExchange*' -or $_.Name -in 'HostControllerService', 'wsbexchange' } $report = foreach ($svc in $all | Sort-Object Name) { $isRequired = $required -contains $svc.Name $startOk = -not $isRequired -or $svc.StartMode -eq 'Auto' $runOk = -not $isRequired -or $svc.State -eq 'Running' $action = '' if ($Fix -and $isRequired) { if (-not $startOk -and $PSCmdlet.ShouldProcess("$Server\$($svc.Name)", "Starttyp von $($svc.StartMode) auf Automatisch setzen")) { Set-Service -ComputerName $Server -Name $svc.Name -StartupType Automatic $action = 'Starttyp korrigiert' } if (-not $runOk -and $PSCmdlet.ShouldProcess("$Server\$($svc.Name)", 'Dienst starten')) { try { Get-Service -ComputerName $Server -Name $svc.Name | Start-Service -ErrorAction Stop $action = ($action, 'gestartet' | Where-Object { $_ }) -join ', ' } catch { $action = ($action, "Start fehlgeschlagen: $($_.Exception.Message)" | Where-Object { $_ }) -join ', ' } } } [pscustomobject]@{ Dienst = $svc.Name Anzeige = $svc.DisplayName Pflicht = $isRequired Starttyp = $svc.StartMode Status = $svc.State Ergebnis = if ($startOk -and $runOk) { 'OK' } elseif (-not $isRequired) { '' } else { 'Abweichung' } Aktion = $action } } # Hinweis auf nicht benötigte, aber deaktivierte Dienste foreach ($r in $report | Where-Object { -not $_.Pflicht -and $_.Starttyp -eq 'Disabled' -and $_.Dienst -notin $popImap }) { $r.Ergebnis = 'Prüfen: deaktiviert' } $report | Format-Table Dienst, Pflicht, Starttyp, Status, Ergebnis, Aktion -AutoSize $bad = @($report | Where-Object Ergebnis -eq 'Abweichung') if ($bad.Count -and -not $Fix) { Write-Warning "$($bad.Count) Pflichtdienste weichen ab. Mit -Fix korrigieren, vorher mit -Fix -WhatIf prüfen." } # 3. Serverkomponenten if ($IncludeComponents -or $FixComponents) { $components = Get-ServerComponentState -Identity $Server $maintenance = ($components | Where-Object Component -eq 'ServerWideOffline').State -eq 'Inactive' $inactive = $components | Where-Object { $_.State -ne 'Active' -and $_.Component -notin 'ForwardSyncDaemon', 'ProvisioningRps' } if ($maintenance) { Write-Warning "$Server ist im Wartungsmodus (ServerWideOffline = Inactive)." } if (-not $inactive) { Write-Host 'Alle Serverkomponenten sind aktiv.' -ForegroundColor Green } else { $inactive | Format-Table Component, State -AutoSize if ($FixComponents) { $impact = if ($maintenance) { 'Wartungsmodus beenden und ' } else { '' } foreach ($c in $inactive) { # Jeder Requester, der die Komponente deaktiviert hat, muss sie auch wieder aktivieren $requesters = @($c.LocalStates + $c.RemoteStates | Where-Object State -eq 'Inactive' | Select-Object -ExpandProperty Requester -Unique) if (-not $requesters) { $requesters = @('Functional') } foreach ($req in $requesters) { if ($PSCmdlet.ShouldProcess("$Server\$($c.Component)", "${impact}auf Active setzen (Requester $req)")) { Set-ServerComponentState -Identity $Server -Component $c.Component -State Active -Requester $req } } } Get-ServerComponentState -Identity $Server | Where-Object State -ne 'Active' | Format-Table Component, State -AutoSize } } } |