Set-ReceiveConnectorLimit.ps1

<#PSScriptInfo
.VERSION 1.0.0
.GUID b261db4b-e321-55e9-bdbe-e27d178f0f86
.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/set-receiveconnectorlimit.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
    Zeigt und erhöht die Verbindungslimits von Exchange-Empfangsconnectoren.
 
.DESCRIPTION
    Hilft, wenn Mailserver, Scanner oder Anwendungen bei vielen gleichzeitigen Verbindungen mit Fehlern wie
    "421 4.3.2 The maximum number of concurrent connections has exceeded a limit" abgewiesen werden.
 
    Ohne Änderungsparameter zeigt das Skript nur die aktuellen Werte aller (oder der angegebenen) Connectoren.
    Mit Werten setzt es die Limits und zeigt danach den neuen Stand.
 
.PARAMETER Identity
    Ein oder mehrere Connectoren, zum Beispiel "EX01\Default Frontend EX01". Ohne Angabe: alle Connectoren.
 
.PARAMETER MaxInboundConnection
    Maximale Anzahl gleichzeitiger Verbindungen insgesamt. Zahl oder "unlimited".
 
.PARAMETER MaxInboundConnectionPerSource
    Maximale Anzahl gleichzeitiger Verbindungen von einer einzelnen IP-Adresse. Zahl oder "unlimited".
 
.PARAMETER MaxInboundConnectionPercentagePerSource
    Maximaler Anteil der verfügbaren Verbindungen, den eine einzelne IP-Adresse belegen darf (1 bis 100).
 
.EXAMPLE
    .\Set-ReceiveConnectorLimit.ps1
 
    Zeigt die aktuellen Limits aller Empfangsconnectoren.
 
.EXAMPLE
    .\Set-ReceiveConnectorLimit.ps1 -Identity "EX01\Relay Scanner" -MaxInboundConnectionPerSource 100 -MaxInboundConnectionPercentagePerSource 10 -WhatIf
 
.NOTES
    Autor: Torsten Weise, powerscripting.de
    Hohe Limits auf Connectoren, die aus dem Internet erreichbar sind, erleichtern Missbrauch. Werte nur dort
    erhöhen, wo bekannte interne Systeme einliefern.
#>

[CmdletBinding(SupportsShouldProcess)]
param(
    [string[]] $Identity,
    [string] $MaxInboundConnection,
    [string] $MaxInboundConnectionPerSource,
    [ValidateRange(1, 100)] [int] $MaxInboundConnectionPercentagePerSource
)

if (-not (Get-Command Get-ReceiveConnector -ErrorAction SilentlyContinue)) {
    throw 'Dieses Skript muss in der Exchange Management Shell laufen.'
}

$connectors = if ($Identity) { $Identity | ForEach-Object { Get-ReceiveConnector -Identity $_ } } else { Get-ReceiveConnector }

$changes = @{}
foreach ($p in 'MaxInboundConnection', 'MaxInboundConnectionPerSource', 'MaxInboundConnectionPercentagePerSource') {
    if ($PSBoundParameters.ContainsKey($p)) { $changes[$p] = $PSBoundParameters[$p] }
}

if ($changes.Count) {
    foreach ($c in $connectors) {
        $text = ($changes.GetEnumerator() | ForEach-Object { "$($_.Key)=$($_.Value)" }) -join ', '
        if ($PSCmdlet.ShouldProcess($c.Identity, "Setzen: $text")) {
            Set-ReceiveConnector -Identity $c.Identity @changes
        }
    }
    $connectors = $connectors | ForEach-Object { Get-ReceiveConnector -Identity $_.Identity }
}

$connectors | Select-Object Identity, Enabled, MaxInboundConnection, MaxInboundConnectionPerSource,
    MaxInboundConnectionPercentagePerSource | Format-Table -AutoSize