Send Graph Mail User
Zuletzt geändert: 14.03.2026 05:56

Send-GraphMailUser #

ÜBERSICHT #

Versendet E-Mails via Microsoft Graph API mit OAuth 2.0 PKCE-Authentifizierung (Benutzerkontext).

SYNTAX #

Send-GraphMailUser [-ClientId] <string> [-To] <string[]> [[-Cc] <string[]>] [[-Bcc] <string[]>]
    [-Subject] <string> [-HtmlBody] <string> [[-Attachments] <string[]>] [[-TokenPath] <string>]
    [[-VerboseLevel] <string>] [<CommonParameters>]

BESCHREIBUNG #

Die Funktion Send-GraphMailUser versendet HTML-formatierte E-Mails über die Microsoft Graph API. Die Authentifizierung erfolgt über den OAuth 2.0 Authorization Code Flow mit PKCE im Benutzerkontext.

Alle Empfängerfelder (To, Cc, Bcc) werden stets als Array an die Graph API übergeben, selbst wenn nur ein einzelner Empfänger vorhanden ist.

Das OAuth-Token wird automatisch verwaltet, gespeichert und bei Ablauf erneuert.

PARAMETER #

-ClientId #

Type: string

Die Client-ID der registrierten Microsoft Azure-Anwendung.

-To #

Type: string[]

Empfänger-E-Mail-Adresse(n). Mindestens eine Adresse erforderlich.

-Cc #

Type: string[]

Optionale Cc-Empfänger-E-Mail-Adresse(n).

-Bcc #

Type: string[]

Optionale Bcc-Empfänger-E-Mail-Adresse(n).

-Subject #

Type: string

Betreff der E-Mail.

-HtmlBody #

Type: string

HTML-formatierter Inhalt der E-Mail.

-Attachments #

Type: string[]

Optionale Dateipfade zu Anhängen.

-TokenPath #

Type: string
Default: "$env:APPDATA\Eulanda\tokens.json"

Optionaler Pfad zur Token-Datei. Standardpfad: $env:APPDATA\Eulanda\tokens.json

-VerboseLevel #

Type: string
Default: 'Basic'

Detailgrad der Verbose-Ausgabe (‘Basic’ oder ‘Detailed’). Standard: ‘Basic’.

AUSGABEN #

void

Gibt keinen Wert zurück. Statusmeldungen erfolgen auf der Konsole (Host-Ausgabe).

BEISPIELE #

# Versendet eine einfache HTML-E-Mail an einen Empfänger.
Send-GraphMailUser -ClientId '1234-...' `
                    -To 'empfaenger@firma.de' `
                    -Subject 'Testnachricht' `
                    -HtmlBody '<b>Hallo Welt!</b>'

# Versendet eine E-Mail mit mehreren Empfängern, einem CC-Empfänger und einem PDF-Anhang.
Send-GraphMailUser -ClientId '1234-...' `
                    -To 'user1@firma.de','user2@firma.de' `
                    -Cc 'chef@firma.de' `
                    -Subject 'Bericht' `
                    -HtmlBody '<h1>Monatsbericht</h1>' `
                    -Attachments 'C:\berichte\monat.pdf'

HINWEISE #

  • Verwendet OAuth 2.0 Authorization Code Flow mit PKCE.
  • Das Token wird lokal gespeichert und automatisch bei Ablauf erneuert.
  • Anhänge werden automatisch base64-codiert übergeben.
  • Benötigt Berechtigungen im Microsoft Azure AD: Mail.Send (Delegierte Berechtigungen).

Voraussetzungen zur Nutzung:

  • Azure-App mit OAuth 2.0-PKCE-Flow eingerichtet.
  • Redirect-URI: http://localhost:8080/