发送邮件消息 (Microsoft.PowerShell.Utility)

Send-MailMessage

发送电子邮件。

句法

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>]

描述

Send-MailMessage cmdlet 从 PowerShell 中发送电子邮件。

您必须指定简单邮件传输协议 (SMTP) 服务器，否则 Send-MailMessage 命令将失败。使用 SmtpServer 参数或将 $PSEmailServer 变量设置为有效的 SMTP 服务器。分配给 $PSEmailServer 的值是 PowerShell 的默认 SMTP 设置。有关详细信息，请参阅 about_Preference_Variables。

警告

Send-MailMessage cmdlet 已过时。此 cmdlet 不保证与 SMTP 服务器的安全连接。虽然 PowerShell 中没有立即可用的替代方案，但我们建议您不要使用 Send-MailMessage。有关详细信息，请参阅平台兼容性说明 DE0005。

示例

示例 1：从一个人向另一个人发送一封电子邮件

此示例将一封电子邮件从一个人发送给另一个人。

Send-MailMessage 需要 From、To 和 Subject 参数。此示例使用 SMTP 服务器的默认 $PSEmailServer 变量，因此不需要 SmtpServer 参数。

$sendMailMessageSplat = @{
    From = 'User01 <[email protected]>'
    To = 'User02 <[email protected]>'
    Subject = 'Test mail'
}
Send-MailMessage @sendMailMessageSplat

Send-MailMessage cmdlet 使用From 参数指定邮件的发件人。 To 参数指定邮件的收件人。 Subject 参数使用文本字符串Test mail 作为消息，因为不包含可选的Body 参数。

示例 2：发送附件

此示例发送一封带有附件的电子邮件。

$sendMailMessageSplat = @{
    From = 'User01 <[email protected]>'
    To = 'User02 <[email protected]>', 'User03 <[email protected]>'
    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 @sendMailMessageSplat

Send-MailMessage cmdlet 使用From 参数指定邮件的发件人。 To 参数指定邮件的收件人。 主题参数描述消息的内容。 Body 参数是消息的内容。

Attachments 参数指定当前目录中附加到电子邮件的文件。 优先级参数将消息设置为高优先级。 DeliveryNotificationOption 参数指定两个值：OnSuccess 和 OnFailure。发件人将收到电子邮件通知，以确认邮件发送成功或失败。 SmtpServer 参数将 SMTP 服务器设置为 smtp.fabrikam.com。

示例 3：向邮件列表发送电子邮件

此示例将电子邮件消息发送到邮件列表。

$sendMailMessageSplat = @{
    From = 'User01 <[email protected]>'
    To = 'ITGroup <[email protected]>'
    Cc = 'User02 <[email protected]>'
    Bcc = 'ITMgr <[email protected]>'
    Subject = "Don't forget today's meeting!"
    Credential = 'domain01\admin01'
    UseSsl = $true
}
Send-MailMessage @sendMailMessageSplat

Send-MailMessage cmdlet 使用From 参数指定邮件的发件人。 To 参数指定邮件的收件人。 抄送参数将邮件的副本发送给指定的收件人。 Bcc 参数发送消息的密件副本。密件副本是对其他收件人隐藏的电子邮件地址。 Subject 参数是消息，因为不包含可选的 Body 参数。

Credential 参数指定用于发送邮件的域管理员的凭据。 UseSsl 参数指定安全套接字层 (SSL) 创建安全连接。

参数

-Attachments

指定要附加到电子邮件的文件的路径和文件名。您可以使用此参数或通过管道将路径和文件名传递给 Send-MailMessage。

String[]

PsPath

命名

None

False

True

False

-Bcc

指定接收邮件副本但未列为邮件收件人的电子邮件地址。输入姓名（可选）和电子邮件地址，例如Name