Отправляет сообщение электронной почты.
Синтаксис
Send-MailMessage [-To] <string[]> [-Subject] <string> -From <string> [[-Body] <string>] [[-SmtpServer] <string>] [-Attachments <string[]>] [-Bcc <string[]>] [-BodyAsHtml] [-Cc <string[]>] [-Credential <PSCredential>] [-DeliveryNotificationOption {<None> | <OnSuccess> | <OnFailure> | <Delay> | <Never>}] [-Кодирование <Encoding>] [-Priority {<Normal> | <Low> | <High>}] [-UseSsl] [<CommonParameters>]
Описание
Командлет Send-MailMessage отправляет из Windows PowerShell сообщение электронной почты.
Параметры
-Attachments <string[]>
Задает путь и имена файлов, отправляемых с сообщением электронной почты в качестве вложения. Можно использовать этот параметр или передать пути и имена файлов командлету Send-MailMessage по конвейеру.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByValue) |
|
Принимать подстановочные знаки? |
false |
-Bcc <string[]>
Задает адреса электронной почты, которые получают копию сообщения, но не указываются в списке получателей. Введите имена (необязательно) и адрес электронной почты, например "Имя <someone@example.com>".
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Body <string>
Задает текст (содержимое) сообщения электронной почты.
|
Обязательно? |
false |
|
Позиция? |
3 |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-BodyAsHtml
Указывает, что значение параметра Body содержит код HTML.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
False |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Cc <string[]>
Задает адреса электронной почты, по которым отправляется копия сообщения. Введите имена (необязательно) и адрес электронной почты, например "Имя <someone@example.com>".
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Credential <PSCredential>
Задает учетную запись пользователя, который располагает разрешением для выполнения этого действия. По умолчанию используется значение "Текущий пользователь".
Введите имя пользователя, например "User01" или "Domain01\User01". Или укажите объект PSCredential, например один из объектов, возвращенных командлетом Get-Credential.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
Current user |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-DeliveryNotificationOption <DeliveryNotificationOptions>
Задает параметры уведомления о доставке для сообщения электронной почты. Можно задать несколько значений. По умолчанию используется значение "None". У этого параметра имеется псевдоним "dno".
Уведомления о доставке отправляются в сообщениях электронной почты по адресу, заданному в значении параметра To.
Допустимые значения:
-- None: уведомление отсутствует.
-- OnSuccess: уведомить в случае успешной доставки.
-- OnFailure: уведомить в случае неудачной доставки.
-- Delay: уведомить в случае задержки доставки.
-- Never: не уведомлять никогда.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Кодирование <Encoding>
Задает кодировку текста и темы письма. Допустимые значения: ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default и OEM. По умолчанию используется значение ASCII.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
ASCII |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-From <string>
Задает адрес, с которого отправляется сообщение. Введите имя (необязательно) и адрес электронной почты, например "Имя <someone@example.com>". Это обязательный параметр.
|
Обязательно? |
true |
|
Позиция? |
named |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Priority <MailPriority>
Задает важность сообщения электронной почты. Допустимые значения: Normal, High и Low. По умолчанию используется значение Normal.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
Normal. |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-SmtpServer <string>
Задает имя SMTP-сервера, через который отправляется сообщение электронной почты.
Значением по умолчанию является привилегированная переменная $PSEmailServer. Если привилегированная переменная не задана, а этот параметр опущен, выполнение команды завершается сбоем.
|
Обязательно? |
false |
|
Позиция? |
4 |
|
Значение по умолчанию |
$PSEmailServer |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Subject <string>
Задает тему сообщения электронной почты. Это обязательный параметр.
|
Обязательно? |
true |
|
Позиция? |
2 |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-To <string[]>
Задает адрес, по которому отправляется сообщение. Введите имена (необязательно) и адрес электронной почты, например "Имя <someone@example.com>". Это обязательный параметр.
|
Обязательно? |
true |
|
Позиция? |
1 |
|
Значение по умолчанию |
нет |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-UseSsl
Использует протокол SSL (Secure Sockets Layer) для установки подключения к удаленному компьютеру для отправки почты. По умолчанию SSL не используется.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
False |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
System.String Путь и имена файлов вложений можно передать командлету Send-MailMessage по конвейеру. |
|
Выходные данные |
Нет Этот командлет не формирует никаких выходных данных. |
Пример 1
C:\PS>send-mailmessage -to "User01 <user01@example.com>" -from "User02 <user02@example.com>" -subject "Test mail" Описание ----------- Эта команда отправляет сообщение электронной почты от пользователя User01 пользователю User02. У сообщения имеется тема, которая является обязательной, но нет текста, который задавать необязательно. Кроме того, поскольку параметр SmtpServer не задан, командлет Send-MailMessage использует в качестве SMTP-сервера значение привилегированной переменной $PSEmailServer.
Пример 2
C:\PS>send-mailmessage -from "User01 <user01@example.com>" -to "User02 <user02@example.com>", "User03 <user03@example.com>" -subject "Sending the Attachment" -body "Forgot to send the attachment. Sending now." -Attachment "data.csv" -priority High -dno onSuccess, onFailure -smtpServer smtp.fabrikam.com Описание ----------- Эта команда отправляет сообщение электронной почты с вложением от пользователя User01 двум другим пользователям. Она устанавливает уровень важности "High" и запрашивает уведомление по электронной почте в случае доставки сообщений или сбоя доставки.
Пример 3
C:\PS>send-mailmessage -to "User01 <user01@example.com>" -from "ITGroup <itdept@example.com>" -cc "User02 <user02@example.com>" -bcc ITMgr <itmgr@example.com> -subject "Don't forget today's meeting!" -credential domain01\admin01 -useSSL Описание ----------- Эта команда отправляет сообщение электронной почты от пользователя User01 в список рассылки ITGroup с копией (CC) пользователю User02 и скрытой копией (BCC) ИТ-менеджеру (ITMgr). Команда использует учетные данные администратора домена и параметр UseSSL.