Send-OutlookMail #
ÜBERSICHT #
Sendet eine E-Mail über Microsoft Outlook COM-Automatisierung (OLE).
SYNTAX #
Send-OutlookMail [[-From] <string>] [-To] <string[]> [[-Cc] <string[]>] [[-Bcc] <string[]>]
[-Subject] <string> [[-HtmlBody] <string>] [[-Body] <string>] [[-Attachments] <string[]>]
[-Display] [-Detailed] [<CommonParameters>]
BESCHREIBUNG #
Send-OutlookMail versendet E-Mails über die COM-Schnittstelle von Microsoft Outlook (Outlook.Application). Die Funktion erstellt ein MailItem, setzt alle Felder (Empfänger, Betreff, Body, Anhänge) und ruft Send() auf.
Der Versand erfolgt vollständig headless (ohne eigene UI). Outlook muss auf dem System installiert und mit mindestens einem E-Mail-Konto konfiguriert sein. Die Nachricht wird in Outlooks Outbox eingereiht und über den konfigurierten Exchange/IMAP/SMTP-Transportweg versendet.
Im Gegensatz zu Simple MAPI (Send-MapiMail) löst die COM-Automatisierung keinen Sicherheitsdialog mit Countdown-Timer aus. Outlook vertraut COM-Aufrufen von lokalen Prozessen, sofern kein Antivirenprogramm den Object Model Guard erzwingt.
HTML-UNTERSTÜTZUNG #
Outlook OLE unterstützt vollständiges HTML. Wird -HtmlBody übergeben, wird der Inhalt als MailItem.HTMLBody gesetzt — einschließlich aller HTML-Tags, CSS-Styles und eingebetteter Formatierungen. Der Empfänger sieht die E-Mail formatiert, genau wie im HTML-Editor von Outlook.
Wird stattdessen -Body (Plain Text) übergeben, wird MailItem.Body gesetzt. -Body hat Vorrang, wenn beides angegeben ist.
ABSENDER (FROM) #
Ohne -From wird das Standard-Outlook-Konto verwendet (primäres Profil). Send-EulandaMail übergibt dann den Wert aus der SQL-Registry \SYSTEM\Devices\EMail\OutlookOLE\From, falls gepflegt.
Mit -From 'rechnung@firma.de' gilt:
- Ist die Adresse ein eigenes Konto im Outlook-Profil (zusätzliches Postfach, IMAP- oder POP-Konto), wird
SendUsingAccountgesetzt. Die Mail geht über dieses Konto und landet in dessen „Gesendete Elemente“. - Sonst wird
SentOnBehalfOfNamegesetzt. Das gilt für freigegebene Postfächer (info@, rechnung@), Stellvertretungen und Verteilerlisten. Mit „Senden als“ sieht der Empfänger nur die Firmenadresse, mit „Senden im Auftrag von“ steht „im Auftrag von “ im Absender. Die Kopie liegt standardmäßig in „Gesendete Elemente“ des angemeldeten Benutzers.
Die Berechtigung vergibt der Exchange- bzw. Microsoft-365-Administrator. Fehlt sie, lehnt der Server die Mail ab, und Outlook stellt einen Unzustellbarkeitsbericht zu.
-From darf die Liste aus der Registry sein (info@firma.de;rechnung@firma.de): Es zählt nur der erste Eintrag, so wie EULANDA selbst ab 2026.115. Ein führendes Semikolon (leerer erster Eintrag) setzt keinen Absender, die Mail geht vom persönlichen Konto.
OUTLOOK-FENSTER (-Display) #
Mit -Display wird die Mail nicht gesendet, sondern fertig ausgefüllt im Outlook-Fenster geöffnet (MailItem.Display()). Der Anwender prüft sie dort, wählt bei Bedarf über die Schaltfläche „Von“ ein anderes Konto und sendet selbst. Unaufgelöste Empfänger brechen hier nicht ab, Outlook zeigt sie im Fenster an. Das Ergebnis meldet Success = $true und Displayed = $true, sobald das Fenster offen ist; ob der Anwender sendet, erfährt der Aufrufer nicht.
ANHÄNGE #
Dateipfade werden über MailItem.Attachments.Add() angehängt. Nicht existierende Dateien werden mit einer Warnung übersprungen (kein Abbruch). Outlook unterstützt alle gängigen Dateitypen und Größen bis zum Exchange/Server-Limit.
EMPFÄNGER-AUFLÖSUNG #
Alle Empfänger werden vor dem Versand über Recipients.ResolveAll() aufgelöst. Outlook prüft dabei gegen das Adressbuch (GAL, Kontakte). SMTP-Adressen werden direkt übernommen, Outlook-Kontaktnamen werden in E-Mail-Adressen aufgelöst.
DIALOG #
Diese Funktion enthält keinen eigenen Bearbeitungsdialog. Wenn ein interaktiver Dialog gewünscht ist (To/Cc/Bcc/Subject/Body bearbeiten), wird dieser von Send-EulandaMail über Show-MailDialog vorgeschaltet — einheitlich für alle Provider.
COM-BEREINIGUNG #
Alle COM-Objekte (MailItem, Outlook.Application) werden im finally-Block über Marshal.ReleaseComObject() freigegeben, um COM-Leaks zu vermeiden.
FEHLERMELDUNG (-Detailed) #
Ohne -Detailed liefert die Funktion nur $true/$false und schreibt den Fehlertext als Warnung. Warnungen sind im Plugin-Betrieb unsichtbar, ein defektes Outlook (fehlende TypeLibs, UAC-Mismatch, Object Model Guard) wirkt dann wie “es passiert nichts”.
Mit -Detailed kommt statt des Booleans ein Objekt zurück: Success, Cancelled, ErrorMessage. Damit kann der Aufrufer den Fehler weiterreichen, ohne dass mitten im Ablauf eine Exception fliegt. Send-EulandaMail nutzt diesen Weg.
PARAMETER #
-From #
Type: string
Absender-Adresse. Passt sie zu einem Konto im Outlook-Profil, wird SendUsingAccount gesetzt, sonst SentOnBehalfOfName (Stellvertretung, freigegebenes Postfach). Ohne Angabe wird das Standard-Outlook-Konto verwendet.
-To #
Type: string[]
Empfängeradresse(n). Erlaubt komma-/semikolongetrennten String oder String-Array. Mindestens ein Empfänger ist erforderlich.
-Cc #
Type: string[]
Optionale CC-Empfänger. Komma-/semikolongetrennt oder String-Array.
-Bcc #
Type: string[]
Optionale BCC-Empfänger. Komma-/semikolongetrennt oder String-Array.
-Subject #
Type: string
Betreffzeile der E-Mail.
-HtmlBody #
Type: string
HTML-formatierter Inhalt. Wird als MailItem.HTMLBody gesetzt — vollständiges HTML mit Tags, Styles und Formatierungen wird unterstützt.
-Body #
Type: string
Plain-Text-Inhalt. Hat Vorrang vor HtmlBody, wenn beides angegeben ist. Wird als MailItem.Body gesetzt (ohne Formatierung).
-Attachments #
Type: string[]
Optionale Dateipfade für Anhänge (String-Array). Nicht existierende Dateien werden mit Warnung übersprungen.
-Display #
Type: switch
Öffnet die fertig ausgefüllte Mail im Outlook-Fenster, statt sie zu senden. Der Anwender prüft, wählt bei Bedarf ein anderes Konto und sendet selbst. Siehe Abschnitt OUTLOOK-FENSTER.
-Detailed #
Type: switch
Liefert statt des Booleans ein Objekt mit Success, Cancelled, ErrorMessage und Displayed (wahr, wenn die Mail mit -Display im Outlook-Fenster geöffnet wurde). Ohne den Schalter bleibt das Verhalten unverändert (Boolean plus Warnung), damit bestehende Aufrufer nicht brechen.
AUSGABEN #
boolean
$true bei erfolgreichem Versand, $false bei Fehler. Bei Fehlern wird zusätzlich eine Warnung mit der Fehlermeldung ausgegeben. pscustomobject Mit -Detailed: Success (boolean), Cancelled (boolean, hier immer $false — Outlook OLE kennt keinen Benutzer-Abbruch) und ErrorMessage (Klartext, leer bei Erfolg).
BEISPIELE #
# HTML-Mail mit Anhang über das Standard-Outlook-Konto senden
Send-OutlookMail -To 'kunde@firma.de' -Subject 'Ihre Rechnung' `
-HtmlBody '<p>Sehr geehrter Kunde,</p><p>anbei Ihre <b>Rechnung</b>.</p>' `
-Attachments 'C:\Rechnungen\RE-123.pdf'
# Plain-Text-Mail über ein Shared Mailbox senden
Send-OutlookMail -From 'info@firma.de' -To 'kunde@firma.de' `
-Subject 'Auftragsbestätigung' -Body 'Ihr Auftrag wurde bestätigt.'
# Mail mit CC, BCC und mehreren Anhängen
Send-OutlookMail -To 'kunde@firma.de' -Cc 'vertrieb@firma.de' `
-Bcc 'archiv@firma.de' -Subject 'Angebot' `
-HtmlBody '<h2>Angebot Nr. 4711</h2><p>Details im Anhang.</p>' `
-Attachments 'C:\Temp\Angebot.pdf', 'C:\Temp\AGB.pdf'
HINWEISE #
Voraussetzung: Microsoft Outlook muss installiert und mit mindestens einem E-Mail-Konto konfiguriert sein. Funktioniert mit Outlook 2016, 2019, 2021 und Microsoft 365 (Desktop-App).
Kompatibel mit PowerShell 5.1+