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/`