Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

New-MailMessage

 

Gilt für:Exchange Online, Exchange Server 2016

Letztes Änderungsdatum des Themas:2018-01-16

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im Cloud-basierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.

Verwenden Sie das Cmdlet New-MailMessage, um eine E-Mail für das angegebene Benutzerpostfach zu erstellen und die E-Mail im Ordner "Entwürfe" des Postfachs des Benutzers abzulegen.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

New-MailMessage [-Body <String>] [-BodyFormat <PlainText | Html | Rtf>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Subject <String>] [-WhatIf [<SwitchParameter>]]

In diesem Beispiel wird im Ordner "Entwürfe" eine E-Mail mit dem Betreff und dem Text erstellt, der in den Parametern Subject und Body angegeben ist. Der Nachrichtentext wird als Nur-Text wiedergegeben, da für den Nachrichtentext kein Format angegeben ist.

New-MailMessage -Subject "Delivery Report" -Body "Click here to view this report"

In diesem Beispiel wird im Ordner "Entwürfe" eine leere E-Mail erstellt, da kein Betreff und kein Nachrichtentext angegeben sind.

New-MailMessage

In diesem Beispiel wird im Ordner "Entwürfe" eine E-Mail mit dem Betreff und dem Text erstellt, der in den Parametern Subject und Body angegeben ist. Der Nachrichtentext wird im HTML-Format wiedergegeben.

New-MailMessage -Subject "Delivery Information" -Body "Click here to see details" -BodyFormat Html

Wenn das Cmdlet ohne Angabe des Parameters Subject oder des Parameters Body ausgeführt wird, wird im Ordner "Entwürfe" des Benutzers eine leere E-Mail abgelegt.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. In diesem Thema sind zwar alle Parameter für das Cmdlet aufgeführt, aber Sie verfügen möglicherweise nicht über Zugriff auf einige Parameter, falls diese nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Benutzerpostfächer" im Thema Empfängerberechtigungen.

 

Parameter Erforderlich Typ Beschreibung

Body

Optional

System.String

Der Parameter Body gibt den Inhalt des Textabschnitts der neuen E-Mail an.

BodyFormat

Optional

Microsoft.Exchange.Data.Providers.MailBodyFormat

Der Parameter BodyFormat gibt das Format des Nachrichtentexts an. Der Wert kann auf PlainText, Rtf (Rich Text Format) oder Html festgelegt werden. Standardmäßig wird der Nachrichtentext als Nur-Text wiedergegeben, wenn der Parameter BodyFormat bei Verwendung des Parameters Body nicht angegeben wird.

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Switch Confirm gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie dieser Switch sich auf das Cmdlet auswirkt, hängt davon ab, ob für den Switch vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pausefunktion, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie mithilfe der exakt folgenden Syntax die Bestätigungsaufforderung überspringen: -Confirm:$false.

  • Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pausefunktion. Bei diesen Cmdlets führt das Angeben des Confirm-Switches ohne einen Wert eine Pausefunktion ein, wodurch Sie gezwungen werden, den Befehl zu bestätigen, bevor Sie fortfahren.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter ist nur in der lokalen Exchange-Bereitstellung verfügbar.

Der Parameter DomainController gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Zum Beispiel dc01.contoso.com.

Betreff

Optional

System.String

Der Parameter Subject gibt den Inhalt des Felds "Betreff" der neuen E-Mail an.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Der Switch WhatIf simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Rückgabetypen bzw. Ausgabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

 
Anzeigen: