Отправляет сообщение электронной почты.

Синтаксис

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.