Envía un mensaje de correo electrónico.

Sintaxis

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 <Encoding>] [-Priority {<Normal> | <Low> | <High>}] [-UseSsl] [<CommonParameters>]

Descripción

El cmdlet Send-MailMessage envía un mensaje de correo electrónico desde Windows PowerShell.

Parámetros

-Attachments <string[]>

Especifica la ruta de acceso y el nombre de los archivos que se van a adjuntar al mensaje de correo electrónico. Puede utilizar este parámetro o canalizar las rutas de acceso y los nombres de archivo a Send-MailMessage.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

true (ByValue)

¿Aceptar caracteres comodín?

false

-Bcc <string[]>

Especifica las direcciones de correo electrónico que reciben una copia del correo pero que no figuran como destinatarios del mensaje. Escriba nombres (opcional) y la dirección de correo electrónico, como "Nombre <alguien@example.com>".

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Body <string>

Especifica el cuerpo (contenido) del mensaje de correo electrónico.

¿Requerido?

false

¿Posición?

3

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-BodyAsHtml

Indica que el valor del parámetro Body contiene HTML.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

False

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Cc <string[]>

Especifica las direcciones de correo electrónico a las que se envía una copia carbón (CC) del mensaje de correo electrónico. Escriba nombres (opcional) y la dirección de correo electrónico, como "Nombre <alguien@example.com>".

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Credential <PSCredential>

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01". O bien, escriba un objeto PSCredential, como el devuelto por el cmdlet Get-Credential.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

Current user

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-DeliveryNotificationOption <DeliveryNotificationOptions>

Especifica las opciones de notificación de entrega para el mensaje de correo electrónico. Puede especificar varios valores. "None" es el valor predeterminado. El alias de este parámetro es "dno".

Las notificaciones de entrega se envían en un mensaje de correo electrónico a la dirección especificada en el valor del parámetro To.

Los valores válidos son:

-- None: ninguna notificación.

-- OnSuccess: se envía una notificación si la entrega se ha realizado correctamente.

-- OnFailure: se envía una notificación si la entrega no se ha realizado correctamente.

-- Delay: se envía una notificación si se retrasa la entrega.

-- Never: no se envía nunca una notificación.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Encoding <Encoding>

Especifica la codificación utilizada para el cuerpo y el asunto. Los valores válidos son ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default y OEM. El valor predeterminado es ASCII.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ASCII

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-From <string>

Especifica la dirección de origen del correo. Escriba un nombre (opcional) y una dirección de correo electrónico, como "Nombre <alguien@example.com>". Este parámetro es obligatorio.

¿Requerido?

true

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Priority <MailPriority>

Especifica la prioridad del mensaje de correo electrónico. Los valores válidos son Normal, High y Low. Normal es el valor predeterminado.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

Normal.

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-SmtpServer <string>

Especifica el nombre del servidor SMTP que envía el mensaje de correo electrónico.

El valor predeterminado es el valor de la variable de preferencia $PSEmailServer. Si no se establece la variable de preferencia y se omite este parámetro, el comando generará un error.

¿Requerido?

false

¿Posición?

4

Valor predeterminado

$PSEmailServer

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Subject <string>

Especifica el asunto del mensaje de correo electrónico. Este parámetro es obligatorio.

¿Requerido?

true

¿Posición?

2

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-To <string[]>

Especifica las direcciones de destino del correo. Escriba nombres (opcional) y la dirección de correo electrónico, como "Nombre <alguien@example.com>". Este parámetro es obligatorio.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-UseSsl

Se usa el protocolo Capa de sockets seguros (SSL) para establecer una conexión con el equipo remoto al que se va a enviar el correo. De forma predeterminada, no se usa SSL.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

False

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

System.String

Puede canalizar la ruta de acceso y los nombres de archivo de los datos adjuntos a Send-MailMessage.

Salidas

Ninguno

Este cmdlet no genera resultados.

Ejemplo 1

C:\PS>send-mailmessage -to "User01 <user01@example.com>" -from "User02 <user02@example.com>" -subject "Test mail"

Descripción
-----------
Este comando envía un mensaje de correo electrónico de User01 a User02. 

El mensaje de correo tiene un asunto, el cual es obligatorio, pero no tiene cuerpo, el cual es opcional. Además, dado que no se especifica el parámetro SmtpServer, Send-MailMessage usa el valor de la variable de preferencia $PSEmailServer para el servidor SMTP.






Ejemplo 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

Descripción
-----------
Este comando envía un mensaje de correo electrónico con datos adjuntos de User01 a otros dos usuarios. 

Especifica "High" como valor de prioridad y solicita una notificación de entrega por correo electrónico cuando se entregan los mensajes de correo electrónico o cuando no se entregan.






Ejemplo 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

Descripción
-----------
Este comando envía un mensaje de correo electrónico de User01 a la lista de distribución de correo ITGroup con una copia (CC) para User02 y una copia oculta (CCO) para el administrador de TI (ITMgr).

El comando utiliza las credenciales de un administrador de dominio y el parámetro UseSSL.









Tabla de contenido