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
、PowerShell 内から電子メール メッセージを送信します。
簡易メール転送プロトコル (SMTP) サーバーを指定する必要があります。または、コマンドが Send-MailMessage
失敗します。 SmtpServer パラメーターを使用するか、変数を$PSEmailServer
有効な SMTP サーバーに設定します。
に割り当てられる $PSEmailServer
値は、PowerShell の既定の SMTP 設定です。 詳細については、「 about_Preference_Variables」を参照してください。
例
例 1: あるユーザーから別のユーザーにメールを送信する
次の使用例は、あるユーザーから別のユーザーに電子メール メッセージを送信します。
From、To、Subject の各パラメーターは、 でSend-MailMessage
必要です。 この例では、SMTP サーバーの既定 $PSEmailServer
の変数を使用するため、 SmtpServer パラメーターは必要ありません。
Send-MailMessage -From 'User01 <user01@fabrikam.com>' -To 'User02 <user02@fabrikam.com>' -Subject 'Test mail'
コマンドレットではSend-MailMessage
、From パラメーターを使用してメッセージの送信者を指定します。 To パラメーターは、メッセージの受信者を指定します。 Subject パラメーターは、オプションの Body パラメーターが含まれていないため、テキスト文字列 Test mail をメッセージとして使用します。
例 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
、From パラメーターを使用してメッセージの送信者を指定します。 To パラメーターは、メッセージの受信者を指定します。 Subject パラメーターは、メッセージの内容を記述します。 Body パラメーターは、メッセージの内容です。
Attachments パラメーターは、電子メール メッセージに添付されている現在のディレクトリ内のファイルを指定します。 Priority パラメーターは、メッセージを高優先度に設定します。 -DeliveryNotificationOption パラメーターは、OnSuccess と OnFailure の 2 つの値を指定します。 送信者は、メッセージ配信の成功または失敗を確認する電子メール通知を受け取ります。 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
、From パラメーターを使用してメッセージの送信者を指定します。 To パラメーターは、メッセージの受信者を指定します。 Cc パラメーターは、指定した受信者にメッセージのコピーを送信します。 Bcc パラメーターは、メッセージのブラインド コピーを送信します。 ブラインド コピーは、他の受信者から非表示になっているメール アドレスです。 オプションの Body パラメーターが含まれていないため、Subject パラメーターはメッセージです。
Credential パラメーターは、ドメイン管理者の資格情報を使用してメッセージを送信することを指定します。 UseSsl パラメーターは、Secure Socket Layer (SSL) がセキュリティで保護された接続を作成することを指定します。
パラメーター
-Attachments
電子メール メッセージに添付するファイルのパスとファイル名を指定します。 このパラメーターを使用するか、パスとファイル名を に Send-MailMessage
パイプできます。
Type: | String[] |
Aliases: | PsPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Bcc
メールのコピーを受信するが、メッセージの受信者として表示されない電子メール アドレスを指定します。 名前 (省略可能) と電子メール アドレス (など Name <someone@fabrikam.com>
) を入力します。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Body
電子メール メッセージの内容を指定します。
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BodyAsHtml
Body パラメーターの値に HTML が含まれていることを指定します。
Type: | SwitchParameter |
Aliases: | BAH |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Cc
電子メール メッセージのカーボン コピー (CC) の送信先の電子メール アドレスを指定します。 名前 (省略可能) と電子メール アドレス (など Name <someone@fabrikam.com>
) を入力します。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
この処理を実行するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。
User01 や Domain01\User01 などのユーザー名を入力します。 または、 PSCredential オブジェクト (コマンドレットのオブジェクトなど) を Get-Credential
入力します。
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeliveryNotificationOption
電子メール メッセージの配信通知オプションを指定します。 複数の値を指定することができます。 None が既定値です。 このパラメーターの別名は DNO です。
配信通知は、 From パラメーターのアドレスに送信されます。
このパラメーターに使用できる値は次のとおりです。
- なし: 通知なし。
- OnSuccess: 配信が成功したかどうかを通知します。
- OnFailure: 配信が失敗した場合に通知します。
- 遅延: 配信が遅延した場合に通知します。
- [なし]: 通知しません。
Type: | DeliveryNotificationOptions |
Aliases: | DNO |
Accepted values: | None, OnSuccess, OnFailure, Delay, Never |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encoding
ターゲット ファイルのエンコードの種類を指定します。 既定値は Defaultです。
このパラメーターに使用できる値は次のとおりです。
- Ascii ASCII (7 ビット) 文字セットを使用します。
- BigEndianUnicode ビッグ エンディアンバイト順で UTF-16 を使用します。
- 既定 システムのアクティブなコード ページ (通常は ANSI) に対応するエンコードを使用します。
- Oem システムの現在の OEM コード ページに対応するエンコードを使用します。
- Unicode リトル エンディアンバイト順で UTF-16 を使用します。
- UTF7 UTF-7 を使用します。
- UTF8 UTF-8 を使用します。
- UTF32 リトル エンディアン バイト順で UTF-32 を使用します。
Type: | Encoding |
Aliases: | BE |
Accepted values: | ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32 |
Position: | Named |
Default value: | Default |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-From
From パラメーターが必要です。 このパラメーターは、送信者のメール アドレスを指定します。 名前 (省略可能) と電子メール アドレス (など Name <someone@fabrikam.com>
) を入力します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
SMTP サーバーの代替ポートを指定します。 既定値は 25 です。これは、既定の SMTP ポートです。
Type: | Int32 |
Position: | Named |
Default value: | 25 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Priority
電子メール メッセージの優先度を指定します。 既定値は Normal です。 このパラメーターに使用できる値は、Normal、High、Low です。
Type: | MailPriority |
Accepted values: | Normal, High, Low |
Position: | Named |
Default value: | Normal |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SmtpServer
電子メール メッセージを送信する SMTP サーバーの名前を指定します。
既定値は、ユーザー設定変数の $PSEmailServer
値です。 ユーザー設定変数が設定されておらず、このパラメーターが使用されていない場合、コマンドは Send-MailMessage
失敗します。
Type: | String |
Aliases: | ComputerName |
Position: | 3 |
Default value: | $PSEmailServer |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Subject
Subject パラメーターが必要です。 このパラメーターは、電子メール メッセージの件名を指定します。
Type: | String |
Aliases: | sub |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-To
To パラメーターが必要です。 このパラメーターは、受信者の電子メール アドレスを指定します。 受信者が複数ある場合は、アドレスをコンマ (,
) で区切ります。 名前 (省略可能) と電子メール アドレス (など Name <someone@fabrikam.com>
) を入力します。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSsl
Secure Sockets Layer (SSL) プロトコルは、メールを送信するリモート コンピューターへのセキュリティで保護された接続を確立するために使用されます。 既定では、SSL は使用されません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
添付ファイルのパスとファイル名を に Send-MailMessage
パイプできます。
出力
None
このコマンドレットは出力を生成しません。