Benutzerdefinierten Exchange Benachrichtigungstext (DSN) erstellen

Ausgangssituation

Wenn bei der Zustellung einer Nachricht (z.B. an einen internen Empfänger) ein Problem auftritt,  so erhält der Absender eine Benachrichtigung, dass die Nachricht nicht zugestellt werden kann. In der Unzustellbarkeitsnachricht wird ein Fehlercode ausgegeben, dessen Antwortnachricht angepasst werden kann. In diesem Beispiel möchte ich euch zeigen wie eine individuelle Antwortnachricht erstellt werden kann.

In meinem Beispiel versende ich eine interne Nachricht an eine E-Mail Adresse welche nicht existiert und erhalte prompt die folgende Systemnachricht von Exchange:

Hier ist zu sehen, dass der Fehlercode 5.1.10 lautet.

Lösungsansatz

Exchange Management Shell Skript:

New-SystemMessage -DSNCode 5.1.10 `
-Text "
    <hr>
    <b>Die eingegebene E-Mail-Adresse konnte nicht gefunden werden.</b><br/>
    <br/>
    Überprüfen Sie die E-Mail-Adresse des Empfängers, und versuchen Sie, die Nachricht erneut zu senden. Wenn das Problem weiterhin besteht, wenden Sie sich bitte an den Service-Desk.  
    <hr>
    <br/>
    IT Service-Desk <br/>
    0800 123 456 <br/>
    URL: <a href='http://servicedesk.genesislab.de'>Service-Desk</a>
" `
-Internal $True `
-Language de

Download: [ddownload id=”3528″]

Nachdem das Skript ausgeführt wurde, wird beim erneuten Test der folgende Antworttext ausgegeben:

An diesem Beispiel habe ich Kontaktinformationen hinterlegt, an die sich der Absender wenden kann.

Weiteres Beispiel:

New-SystemMessage -QuotaMessageType WarningMailbox `
-Text "
     <hr>
     <b>Ihr Postfach erreicht bald die maximale Postfachgröße.</b><br/>
     <br/>
     Bitte räumen Sie Ihr Postfach auf und löschen nicht mehr benötigte Nachrichten.<br/>
     Sollten Sie diesbezüglich weitere Fragen haben, wenden Sie sich bitte an den Service-Desk.
     <hr>
     <br/>
     IT Service-Desk <br/>
     0800 123 456 <br/>

" `
-Language DE

Weitere Informationen

Die erstellte Systemnachricht kann mit dem folgenden CommandLet eingesehen werden:

Get-SystemMessage

• Mit dem Parameter “-Language” kann die Sprache der Systemnachricht festgelegt werden.
• z.B englisch:

  New-SystemMessage -DSNCode 5.1.10 `
  -Text "
      <hr>
      <b>The E-Mail-Address does not exist...</b><br/>
      <br/>
      Please contact the Service-Desk for further information.
      <hr>
      <br/>
      IT Service-Desk <br/>
      0800 123 456 <br/>
      URL: <a href='http://servicedesk.genesislab.de'>Service-Desk</a>
  " `
  -Internal $True `
  -Language en

  New-SystemMessage -QuotaMessageType WarningMailbox -Language en -Text "Your mailbox has exceeded the warning limit specified by your email administrator. Please reduce the size of your mailbox."

• Mit dem Parameter “-Internal $False” kann festgelegt werden,  ob die Systemnachricht nach extern versendet werden soll. Dies ist jedoch nicht zu empfehlen, wenn interne Informationen enthalten sind.

Alle Systemnachrichten auflisten:

$systemmessages = Get-SystemMessage -Original -wa 0
$systemmessages | ?{$_.Language -eq "de" } | more

Entfernen einer benutzerdefinierten Systemnachricht:

Remove-SystemMessage -Identity "de\Internal\5.1.10"

Microsoft Auszug der Fehlercodes:
https://docs.microsoft.com/de-de/exchange/dsn-message-text-exchange-2013-help

Häufig vorkommende erweiterte Statuscodes

Erweiterte Statuscodes sind in RFC 3463 definiert und verwenden die Syntax _ <Klasse>. <subject>. <detail>:

• Klasse: 4 gibt einen temporären Zustellungsfehler an. **** _ <> 5 gibt einen dauerhaften Übermittlungsfehler an.
• Betreff: die RFC kategorisiert die Werte wie folgt: _ <>
  • 1: Adressierung
  • 2: Postfach (der Empfänger)
  • 3: e-Mail-System (das Ziel-e-Mail-System)
  • 4: Netzwerk und Routing
  • 5: e-Mail-Übermittlungsprotokoll
  • 7: Sicherheit oder Richtlinie
• Detail: eine 1-bis 3-stellige Zahl, die den Fehler weiter klassifiziert. _ <>

Die folgende Tabelle enthält die erweiterten Statuscodes, die in NDRs bei den am häufigsten vorkommenden Nachrichtenzustellungsfehlern zurückgegeben werden.

Temporäre Übermittlungsfehler

Dauerhafte Übermittlungsfehler