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.