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
        }
    }
}