Send-MailMessage

Send-MailMessage
    [-To] <string[]>
    [-Subject] <string>
    [[-Body] <string>]
    [[-SmtpServer] <string>]
    -From <string>
    [-Attachments <string[]>]
    [-Bcc <string[]>]
    [-BodyAsHtml]
    [-Encoding <Encoding>]
    [-Cc <string[]>]
    [-DeliveryNotificationOption <DeliveryNotificationOptions>]
    [-Priority <MailPriority>]
    [-Credential <pscredential>]
    [-UseSsl]
    [-Port <int>]
    [<CommonParameters>]

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

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

本示例将电子邮件从一个人发送到另一个人。

需要从、到，Subject 参数。 此示例使用 SMTP 服务器的默认 $PSEmailServer 变量，因此不需要 SmtpServer 参数。

Send-MailMessage -From 'User01 <user01@fabrikam.com>' -To 'User02 <user02@fabrikam.com>' -Subject 'Test mail'

cmdlet 使用 from 参数 来指定邮件的发件人。 To 参数指定邮件的收件人。 Subject 参数使用文本字符串 测试邮件 作为邮件，因为不包括可选的 正文 参数。

本示例发送带有附件的电子邮件。

Send-MailMessage -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'

cmdlet 使用 from 参数 来指定邮件的发件人。 To 参数指定邮件的收件人。 Subject 参数描述消息的内容。 正文 参数是消息的内容。

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

本示例将电子邮件发送到邮件列表。

Send-MailMessage -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

cmdlet 使用 from 参数 来指定邮件的发件人。 To 参数指定邮件的收件人。 Cc 参数将邮件的副本发送到指定的收件人。 密件抄送 参数发送消息的盲件副本。 盲件副本是其他收件人隐藏的电子邮件地址。 Subject 参数是消息，因为不包括可选的 正文 参数。

Credential 参数指定域管理员凭据用于发送消息。 UseSsl 参数指定安全套接字层（SSL）创建安全连接。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将附件的路径和文件名传递给 Send-MailMessage。

此 cmdlet 将不生成任何输出。