Send Graph Mail With Dialog
Zuletzt geändert: 14.03.2026 05:56

Send-GraphMailWithDialog #

ÜBERSICHT #

Versendet E-Mails über Microsoft Graph API mithilfe eines lokalen Mini-Webservers und HTML-basiertem Dialog.

SYNTAX #

Send-GraphMailWithDialog [-ClientId] <string> [-To] <string[]> [[-Cc] <string[]>] [[-Bcc]
    <string[]>] [-Subject] <string> [-Body] <string> [[-Attachments] <string[]>]
    [<CommonParameters>]

BESCHREIBUNG #

Send-GraphMailWithDialog öffnet einen HTML-basierten E-Mail-Dialog in einem lokalen Mini-Webserver. Der Benutzer kann E-Mail-Adressen, Betreff, HTML-Inhalt und Anhänge interaktiv bearbeiten und anschließend über die Microsoft Graph API senden. OAuth2-Authentifizierung (PKCE-Verfahren) erfolgt transparent über Graph API.

Unterstützte Features: #

  • HTML-basierte Eingabe mit Vorschau (auch formatiert, z.B.. fett, kursiv, usw.)
  • Verwaltung und Änderung von Anhängen während des Dialogs
  • OAuth2 PKCE-Authentifizierung gegenüber Microsoft Graph
  • Automatische Speicherung von OAuth-Tokens (Refresh-Handling)
  • Interaktive Kontrolle im Webdialog, direkt im Browser (standardmäßig Chrome im App-Modus)

PARAMETER #

-ClientId #

Type: string

Azure AD Client-ID (App-Registrierung) zur Authentifizierung gegenüber Microsoft Graph API.

-To #

Type: string[]

E-Mail-Adresse(n) des primären Empfängers. Mindestens eine Adresse erforderlich.

-Cc #

Type: string[]

Optional: Carbon-Copy-Empfängeradresse(n).

-Bcc #

Type: string[]

Optional: Blind-Carbon-Copy-Empfängeradresse(n).

-Subject #

Type: string

Betreffzeile der E-Mail.

-Body #

Type: string

HTML-formatierter Inhalt der E-Mail.

-Attachments #

Type: string[]

Optional: Pfade zu Anhängen, die mit der E-Mail gesendet werden sollen.

AUSGABEN #

void

Keine direkte Rückgabe. Status- und Fehlerinformationen werden auf der Host-Konsole ausgegeben.

BEISPIELE #

# Öffnet den Dialog im Browser und erlaubt interaktives Bearbeiten und Versenden.
Send-GraphMailWithDialog `
  -ClientId '2cf9f0cd-af06-4eb5-9f1d-bd0185f11d2c' `
  -To 'cn@outlook.de' `
  -Subject 'Test-E-Mail' `
  -Body 'Mein super Body-Text in <b>fett</b> oder <i>kursiv</i>.' `
  -Attachments @('C:\Dateien\Dokument.pdf') `
  -Verbose

HINWEISE #

  • Verwendet intern die Funktionen Start-MiniWebserver und Send-GraphMailUser.
  • Unterstützt OAuth 2.0 PKCE für sichere Authentifizierung mit Microsoft Graph API.
  • Tokens werden automatisch gespeichert und bei Bedarf erneuert.