Send-MailMessage

Envoie un message électronique.

Syntaxe

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>]

Description

L'applet de commande Send-MailMessage envoie un message électronique à partir de Windows PowerShell.

Paramètres

-Attachments <string[]>

Spécifie le chemin d'accès et le nom des fichiers à joindre au message électronique. Vous pouvez utiliser ce paramètre ou diriger les chemins d'accès et noms de fichiers vers Send-MailMessage.

-Bcc <string[]>

Spécifie les adresses de messagerie qui reçoivent une copie du courrier mais qui ne sont pas répertoriées en tant que destinataires du message. Entrez les noms (facultatif) et l'adresse de messagerie, par exemple « Nom <xyz@example.com> ».

-Body <string>

Spécifie le corps (contenu) du message électronique.

-BodyAsHtml

Indique que la valeur du paramètre Body contient du code HTML.

-Cc <string[]>

Spécifie les adresses de messagerie auxquelles une copie conforme (CC) du message électronique est envoyée. Entrez les noms (facultatif) et l'adresse de messagerie, par exemple « Nom <xyz@example.com> ».

-Credential <PSCredential>

Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel.

Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 ». Vous pouvez également entrer un objet PSCredential, tel que celui généré par l'applet de commande Get-Credential.

-DeliveryNotificationOption <DeliveryNotificationOptions>

Spécifie les options d'accusé de réception du message électronique. Vous pouvez spécifier plusieurs valeurs. La valeur par défaut est « None ». L'alias de ce paramètre est « dno ».

Les accusés de réception sont envoyés dans un message électronique à l'adresse spécifiée dans la valeur du paramètre To.

Les valeurs valides sont :

-- None : pas d'accusé de réception.

-- OnSuccess : indique si le message a été remis.

-- OnFailure : indique si la réception du message a échoué.

-- Delay : indique si la remise du message a été différée.

-- Never : jamais aucun accusé de réception.

-Encoding <Encoding>

Spécifie l'encodage utilisé pour le corps et l'objet. Les valeurs valides sont ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default et OEM. La valeur par défaut est ASCII.

-From <string>

Spécifie l'adresse à partir de laquelle le courrier est envoyé. Entrez un nom (facultatif) et une adresse de messagerie, par exemple « Nom <xyz@exemple.com> ». Ce paramètre est obligatoire.

-Priority <MailPriority>

Spécifie la priorité du message électronique. Les valeurs valides sont Normal, High et Low. La valeur par défaut est Normal.

-SmtpServer <string>

Spécifie le nom du serveur SMTP qui envoie le message électronique.

La valeur par défaut est la valeur de la variable de préférence $PSEmailServer. Si la variable de préférence n'est pas définie et que ce paramètre est omis, la commande échoue.

-Subject <string>

Spécifie l'objet du message électronique. Ce paramètre est obligatoire.

-To <string[]>

Spécifie les adresses auxquelles le courrier est envoyé. Entrez les noms (facultatif) et l'adresse de messagerie, par exemple « Nom <xyz@example.com> ». Ce paramètre est obligatoire.

-UseSsl

Utilise le protocole SSL (Secure Sockets Layer) pour établir une connexion à l'ordinateur distant afin d'envoyer un message. Par défaut, SSL n'est pas utilisé.

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Exemple 1

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

Description
-----------
Cette commande envoie un message électronique d'User01 à User02. 

Le message électronique comporte un objet, qui est obligatoire, mais il n'a pas de corps, qui est facultatif. En outre, étant donné que le paramètre SmtpServer n'est pas spécifié, Send-MailMessage utilise la valeur de la variable de préférence $PSEmailServer pour le serveur SMTP.

Exemple 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

Description
-----------
Cette commande envoie un message électronique avec une pièce jointe d'User01 à deux autres utilisateurs. 

Elle spécifie la valeur de priorité « High » et demande un accusé de réception par messagerie électronique lorsque les messages électroniques sont remis ou qu'ils échouent.

Exemple 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

Description
-----------
Cette commande envoie un message électronique d'User01 à la liste de diffusion ITGroup avec une copie (CC) à User02 et une copie conforme invisible (CCI) au directeur IT (ITMgr).

Elle utilise les informations d'identification d'un administrateur de domaine et le paramètre UseSSL.