Send-MailMessage
傳送電子郵件訊息。
語法
All
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>]
Description
Send-MailMessage Cmdlet 會從 PowerShell 內傳送電子郵件訊息。
您必須指定簡單郵件傳輸通訊協定 （SMTP） 伺服器或 Send-MailMessage 命令失敗。 使用 SmtpServer 參數，或將 $PSEmailServer 變數設定為有效的 SMTP 伺服器。
指派給 $PSEmailServer 的值是 PowerShell 的預設 SMTP 設定。 如需詳細資訊，請參閱 about_Preference_Variables。
範例
範例 1：將電子郵件從一個人傳送到另一個人
本範例會將電子郵件訊息從一個人傳送到另一個人。
$PSEmailServer 變數，因此不需要 SmtpServer 參數。
Send-MailMessage -From 'User01 <user01@fabrikam.com>' -To 'User02 <user02@fabrikam.com>' -Subject 'Test mail'
Send-MailMessage Cmdlet 會使用 From 參數來指定訊息的寄件者。
To 參數會指定郵件的收件者。
Subject 參數會使用文字字串 Test mail 做為訊息，因為不包含選擇性的 Body 參數。
範例 2：傳送附件
本範例會傳送含有附件的電子郵件訊息。
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'
Send-MailMessage Cmdlet 會使用 From 參數來指定訊息的寄件者。
To 參數會指定郵件的收件者。
Subject 參數描述訊息的內容。
Body 參數是訊息的內容。
Attachments 參數會指定目前目錄中附加至電子郵件訊息的檔案。 Priority 參數會將訊息設定為 高 優先順序。 -DeliveryNotificationOption 參數會指定兩個值，OnSuccess 和 OnFailure。 寄件者會收到電子郵件通知，以確認郵件傳遞成功或失敗。 SmtpServer 參數會將 SMTP 伺服器設定為 smtp.fabrikam.com。
範例 3：將電子郵件傳送至郵件清單
本範例會將電子郵件訊息傳送至郵件清單。
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
Send-MailMessage Cmdlet 會使用 From 參數來指定訊息的寄件者。
To 參數會指定郵件的收件者。
Cc 參數會將郵件的複本傳送給指定的收件者。
密件抄送 參數會傳送訊息的盲目複本。 盲目的復本是從其他收件者隱藏的電子郵件位址。
Subject 參數是訊息，因為不包含選擇性 Body 參數。
Credential 參數會指定網域系統管理員的認證用來傳送訊息。 UseSsl 參數會指定安全套接字層 （SSL） 會建立安全連線。
參數
-Attachments
指定要附加至電子郵件訊息之檔案的路徑和檔名。 您可以使用此參數，或使用管線將路徑和檔案名傳送至 Send-MailMessage。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | PsPath |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Bcc
指定接收郵件復本但未列為郵件收件者的電子郵件位址。 輸入名稱（選擇性）和電子郵件位址，例如 Name <someone@fabrikam.com>。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Body
指定電子郵件訊息的內容。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-BodyAsHtml
指定 Body 參數的值包含 HTML。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 呸 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Cc
指定傳送電子郵件訊息之副本 （CC） 的電子郵件位址。 輸入名稱（選擇性）和電子郵件位址，例如 Name <someone@fabrikam.com>。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Credential
指定具有執行此動作許可權的用戶帳戶。 預設值為目前的使用者。
輸入使用者名稱，例如 User01 或 Domain01\User01。 或者，輸入 PSCredential 物件，例如 Get-Credential Cmdlet 中的一個。
參數屬性
| 類型: | PSCredential |
| 預設值: | Current user |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DeliveryNotificationOption
指定電子郵件訊息的傳遞通知選項。 您可以指定多個值。 None 是預設值。 此參數的別名 DNO。
傳遞通知會傳送至 From 參數中的位址。
此參數可接受的值如下：
- 無：沒有通知。
- OnSuccess：如果傳遞成功，請通知。
- OnFailure：如果傳遞失敗，請通知。
- 延遲：通知傳遞是否延遲。
- 永不：永不通知。
參數屬性
| 類型: | DeliveryNotificationOptions |
| 預設值: | None |
| 接受的值: | None, OnSuccess, OnFailure, Delay, Never |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | DNO |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Encoding
指定目標檔案的編碼類型。 預設值為 Default。
此參數可接受的值如下：
- ASCII 使用 ASCII （7 位） 字元集。
- BigEndianUnicode 使用 UTF-16 與 big-endian 位元組順序。
- 預設 使用對應至系統使用中代碼頁的編碼方式（通常是 ANSI）。
- OEM 使用對應至系統目前 OEM 代碼頁的編碼方式。
- Unicode 使用 UTF-16 搭配位元組順序。
- UTF7 使用 UTF-7。
- UTF8 使用 UTF-8。
- UTF32 使用 UTF-32 搭配位元組順序。
參數屬性
| 類型: | Encoding |
| 預設值: | Default |
| 接受的值: | ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32 |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | BE |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-From
需要 From 參數。 此參數會指定寄件者的電子郵件位址。 輸入名稱（選擇性）和電子郵件位址，例如 Name <someone@fabrikam.com>。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Port
指定 SMTP 伺服器上的替代埠。 默認值為 25，這是預設 SMTP 連接埠。
參數屬性
| 類型: | Int32 |
| 預設值: | 25 |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Priority
指定電子郵件訊息的優先順序。 一般是預設值。 此參數可接受的值為 Normal、High 和 Low。
參數屬性
| 類型: | MailPriority |
| 預設值: | Normal |
| 接受的值: | Normal, High, Low |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SmtpServer
指定傳送電子郵件訊息的 SMTP 伺服器名稱。
預設值是 $PSEmailServer 喜好設定變數的值。 如果未設定喜好設定變數，而且未使用此參數，則 Send-MailMessage 命令會失敗。
參數屬性
| 類型: | String |
| 預設值: | $PSEmailServer |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 電腦名稱 |
參數集
(All)
| Position: | 3 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Subject
需要 Subject 參數。 此參數會指定電子郵件訊息的主旨。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 分支 |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-To
需要 To 參數。 此參數會指定收件者的電子郵件位址。 如果有多個收件者，請以逗號分隔其位址（,）。 輸入名稱（選擇性）和電子郵件位址，例如 Name <someone@fabrikam.com>。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseSsl
安全套接字層 （SSL） 通訊協定可用來建立與遠端電腦的安全連線，以傳送郵件。 根據預設，不會使用 SSL。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
String
您可以使用管線將附件的路徑和檔案名傳送至 Send-MailMessage。
輸出
None
此 Cmdlet 不會產生任何輸出。