Send-MailMessage
Eine E-Mail sendet.
Syntax
Send-MailMessage
[-Attachments <String[]>]
[-Bcc <String[]>]
[[-Body] <String>]
[-BodyAsHtml]
[-Encoding <Encoding>]
[-Cc <String[]>]
[-DeliveryNotificationOption <DeliveryNotificationOptions>]
-From <String>
[[-SmtpServer] <String>]
[-Priority <MailPriority>]
[-ReplyTo <String[]>]
[[-Subject] <String>]
[-To] <String[]>
[-Credential <PSCredential>]
[-UseSsl]
[-Port <Int32>]
[<CommonParameters>] Beschreibung
Das Send-MailMessage Cmdlet sendet eine E-Mail-Nachricht aus PowerShell.
Sie müssen einen SMTP-Server (Simple Mail Transfer Protocol) angeben, oder der Send-MailMessage Befehl schlägt fehl. Verwenden Sie den SmtpServer-Parameter , oder legen Sie die $PSEmailServer Variable auf einen gültigen SMTP-Server fest.
Der zugewiesene $PSEmailServer Wert ist die Standard-SMTP-Einstellung für PowerShell. Weitere Informationen finden Sie unter about_Preference_Variables.
Warnung
Das Cmdlet Send-MailMessage ist veraltet. Dieses Cmdlet garantiert keine sicheren Verbindungen mit SMTP-Servern. Es ist zwar kein sofortiger Ersatz in PowerShell verfügbar, es wird jedoch empfohlen, die Verwendung nicht zu verwenden Send-MailMessage. Weitere Informationen finden Sie unter Plattformkompatibilitätshinweis DE0005.
Beispiele
Beispiel 1: Senden einer E-Mail von einer Person an eine andere Person
In diesem Beispiel wird eine E-Mail-Nachricht von einer Person an eine andere Person gesendet.
Die Parameter "From", "To" und "Subject" sind erforderlich.Send-MailMessage In diesem Beispiel wird die Standardvariable $PSEmailServer für den SMTP-Server verwendet, sodass der SmtpServer-Parameter nicht benötigt wird.
$sendMailMessageSplat = @{
From = 'User01 <user01@fabrikam.com>'
To = 'User02 <user02@fabrikam.com>'
Subject = 'Test mail'
}
Send-MailMessage @sendMailMessageSplatDas Send-MailMessage Cmdlet verwendet den Parameter From , um den Absender der Nachricht anzugeben. Der Parameter To gibt den Empfänger der Nachricht an. Der Parameter "Subject " verwendet die Textzeichenfolge "Test-E-Mail " als Nachricht, da der optionale Body-Parameter nicht enthalten ist.
Beispiel 2: Senden einer Anlage
In diesem Beispiel wird eine E-Mail-Nachricht mit einer Anlage gesendet.
$sendMailMessageSplat = @{
From = 'User01 <user01@fabrikam.com>'
To = 'User02 <user02@fabrikam.com>', 'User03 <user03@fabrikam.com>'
Subject = 'Sending the Attachment'
Body = "Forgot to send the attachment. Sending now."
Attachments = '.\data.csv'
Priority = 'High'
DeliveryNotificationOption = 'OnSuccess', 'OnFailure'
SmtpServer = 'smtp.fabrikam.com'
}
Send-MailMessage @sendMailMessageSplatDas Send-MailMessage Cmdlet verwendet den Parameter From , um den Absender der Nachricht anzugeben. Der Parameter To gibt die Empfänger der Nachricht an. Der Parameter "Subject " beschreibt den Inhalt der Nachricht. Der Parameter "Body" ist der Inhalt der Nachricht.
Der Parameter Attachments gibt die Datei im aktuellen Verzeichnis an, das an die E-Mail-Nachricht angefügt ist. Der Parameter Priority legt die Nachricht auf High Priorität fest. Der Parameter DeliveryNotificationOption gibt zwei Werte OnSuccess und OnFailure. Der Absender erhält E-Mail-Benachrichtigungen, um den Erfolg oder Fehler der Nachrichtenübermittlung zu bestätigen.
Der SmtpServer-Parameter legt den SMTP-Server auf smtp.fabrikam.com.
Beispiel 3: Senden von E-Mails an eine Adressenliste
In diesem Beispiel wird eine E-Mail-Nachricht an eine Adressenliste gesendet.
$sendMailMessageSplat = @{
From = 'User01 <user01@fabrikam.com>'
To = 'ITGroup <itdept@fabrikam.com>'
Cc = 'User02 <user02@fabrikam.com>'
Bcc = 'ITMgr <itmgr@fabrikam.com>'
Subject = "Don't forget today's meeting!"
Credential = 'domain01\admin01'
UseSsl = $true
}
Send-MailMessage @sendMailMessageSplatDas Send-MailMessage Cmdlet verwendet den Parameter From , um den Absender der Nachricht anzugeben. Der Parameter To gibt die Empfänger der Nachricht an. Der Parameter "Cc" sendet eine Kopie der Nachricht an den angegebenen Empfänger. Der Bcc-Parameter sendet eine Blindkopie der Nachricht. Eine Blindkopie ist eine E-Mail-Adresse, die von den anderen Empfängern ausgeblendet ist. Der Parameter "Subject " ist die Nachricht, da der optionale Body-Parameter nicht enthalten ist.
Der Parameter "Credential" gibt eine Do Standard Die Anmeldeinformationen des Administrators werden verwendet, um die Nachricht zu senden. Der Parameter UseSsl gibt an, dass Ssl (Secure Socket Layer) eine sichere Verbindung erstellt.
Parameter
-Attachments
Gibt den Pfad und Dateinamen von Dateien an, die an die E-Mail-Nachricht angefügt werden sollen. Sie können diesen Parameter verwenden oder die Pfade und Dateinamen an Send-MailMessagedie Datei übergeben.
| Type: | String[] |
| Aliases: | PsPath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Bcc
Gibt die E-Mail-Adressen an, die eine Kopie der E-Mail erhalten, aber nicht als Empfänger der Nachricht aufgeführt sind. Geben Sie Namen (optional) und die E-Mail-Adresse ein, z Name <someone@fabrikam.com>. B. .
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Body
Gibt den Inhalt der E-Mail-Nachricht an.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-BodyAsHtml
Gibt an, dass der Wert des Body-Parameters HTML enthält.
| Type: | SwitchParameter |
| Aliases: | BAH |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Cc
Gibt die E-Mail-Adressen an, an die eine Kopie (CC) der E-Mail-Nachricht gesendet wird. Geben Sie Namen (optional) und die E-Mail-Adresse ein, z Name <someone@fabrikam.com>. B. .
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Credential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer.
Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Do Standard 01\User01". Oder geben Sie ein PSCredential-Objekt ein, z. B. ein Objekt aus dem Get-Credential Cmdlet.
Anmeldeinformationen werden in einem PSCredential-Objekt gespeichert, und das Kennwort wird als SecureString gespeichert.
Hinweis
Weitere Informationen zum Schutz von SecureString finden Sie unter "Wie sicher ist SecureString?".
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DeliveryNotificationOption
Gibt die Zustellungsbenachrichtigungsoptionen für die E-Mail-Nachricht an. Sie können mehrere -Werte angeben. None ist der Standardwert. Der Alias für diesen Parameter ist DNO.
Die Übermittlungsbenachrichtigungen werden an die Adresse im Parameter "From" gesendet.
Die zulässigen Werte für diesen Parameter sind wie folgt:
None: Keine Benachrichtigung.OnSuccess: Benachrichtigen, wenn die Übermittlung erfolgreich ist.OnFailure: Benachrichtigen, wenn die Übermittlung nicht erfolgreich ist.Delay: Benachrichtigen, wenn die Zustellung verzögert wird.Never: Nie benachrichtigen.
Diese Werte werden als flagbasierte Enumeration definiert. Sie können mehrere Werte kombinieren, um mehrere Flags mithilfe dieses Parameters festzulegen. Die Werte können als Array von Werten oder als kommagetrennte Zeichenfolge dieser Werte an den DeliveryNotification-Parameter übergeben werden. Das Cmdlet kombiniert die Werte mithilfe eines Binary-OR-Vorgangs. Das Übergeben von Werten als Array ist die einfachste Option und ermöglicht ihnen auch die Verwendung des Tabstopps für die Werte.
| Type: | DeliveryNotificationOptions |
| Aliases: | DNO |
| Accepted values: | None, OnSuccess, OnFailure, Delay, Never |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Encoding
Gibt den Typ der Codierung für die Zieldatei an. Der Standardwert ist utf8NoBOM.
Die zulässigen Werte für diesen Parameter sind wie folgt:
ascii: Verwendet die Codierung für den ASCII-Zeichensatz (7-Bit).ansi: Verwendet die Codierung für die ANSI-Codeseite der aktuellen Kultur. Diese Option wurde in PowerShell 7.4 hinzugefügt.bigendianunicode: Codiert im UTF-16-Format mit der Big-End-Byte-Reihenfolge.bigendianutf32: Codiert im UTF-32-Format mithilfe der Big-End-Byte-Reihenfolge.oem: Verwendet die Standardcodierung für MS-DOS- und Konsolenprogramme.unicode: Codiert im UTF-16-Format mithilfe der Little-Endian-Bytereihenfolge.utf7: Codiert im UTF-7-Format.utf8: Codiert im UTF-8-Format.utf8BOM: Codiert im UTF-8-Format mit Bytereihenfolgezeichen (BOM)utf8NoBOM: Codiert im UTF-8-Format ohne Byte Order Mark (BOM)utf32: Codiert im UTF-32-Format.
Ab PowerShell 6.2 ermöglicht der Encoding-Parameter auch numerische IDs registrierter Codeseiten (z -Encoding 1251. B. ) oder Zeichenfolgennamen registrierter Codeseiten (z -Encoding "windows-1251". B. ). Weitere Informationen finden Sie in der .NET-Dokumentation für Encoding.CodePage.
Ab PowerShell 7.4 können Sie den Ansi Wert für den Codierungsparameter verwenden, um die numerische ID für die ANSI-Codeseite der aktuellen Kultur zu übergeben, ohne sie manuell angeben zu müssen.
Hinweis
UTF-7* wird nicht mehr empfohlen, zu verwenden. Ab PowerShell 7.1 wird eine Warnung geschrieben, wenn Sie für den Codierungsparameter angebenutf7.
| Type: | Encoding |
| Aliases: | BE |
| Accepted values: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
| Position: | Named |
| Default value: | ASCII |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-From
Der Parameter From ist erforderlich. Dieser Parameter gibt die E-Mail-Adresse des Absenders an. Geben Sie einen Namen (optional) und eine E-Mail-Adresse ein, z Name <someone@fabrikam.com>. B. .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Port
Gibt einen alternativen Port auf dem SMTP-Server an. Der Standardwert ist 25, wobei es sich um den SMTP-Standardport handelt.
| Type: | Int32 |
| Position: | Named |
| Default value: | 25 |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Priority
Gibt die Priorität der E-Mail-Nachricht an. Der Standardwert ist „Normal“. Die zulässigen Werte für diesen Parameter sind "Normal", "Hoch" und "Niedrig".
| Type: | MailPriority |
| Accepted values: | Normal, High, Low |
| Position: | Named |
| Default value: | Normal |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReplyTo
Gibt weitere E-Mail-Adressen (außer der Absenderadresse) an, die zum Beantworten dieser Nachricht verwendet werden sollen.
Geben Sie Namen (optional) und die E-Mail-Adresse ein, z Name <someone@fabrikam.com>. B. .
Dieser Parameter wurde in PowerShell 6.2 eingeführt.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SmtpServer
Gibt den Namen des SMTP-Servers an, der die E-Mail-Nachricht sendet.
Der Standardwert ist der Wert der $PSEmailServer Einstellungsvariable. Wenn die Einstellungsvariable nicht festgelegt ist und dieser Parameter nicht verwendet wird, schlägt der Send-MailMessage Befehl fehl.
| Type: | String |
| Aliases: | ComputerName |
| Position: | 3 |
| Default value: | $PSEmailServer |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Subject
Der Parameter "Subject" ist nicht erforderlich. Dieser Parameter gibt den Betreff der E-Mail-Nachricht an.
| Type: | String |
| Aliases: | sub |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-To
Der To-Parameter ist erforderlich. Dieser Parameter gibt die E-Mail-Adresse des Empfängers an. Geben Sie Namen (optional) und die E-Mail-Adresse ein, z Name <someone@fabrikam.com>. B. .
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UseSsl
Das SSL-Protokoll (Secure Sockets Layer) wird verwendet, um eine sichere Verbindung mit dem Remotecomputer herzustellen, um E-Mails zu senden. Standardmäßig wird SSL nicht verwendet.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Eingaben
Sie können den Pfad und dateinamen von Anlagen an dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
Das Cmdlet Send-MailMessage ist veraltet. Weitere Informationen finden Sie unter Plattformkompatibilitätshinweis DE0005. Dieses Cmdlet garantiert keine sicheren Verbindungen mit SMTP-Servern.
DE0005 schlägt vor, die Drittanbieterbibliothek MailKit zu verwenden. Wenn Sie Exchange Online verwenden, können Sie das Send-MgUserMail aus dem Microsoft Graph PowerShell SDK verwenden.
Ähnliche Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für