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.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue)

Accepter les caractères génériques ?

false

-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> ».

Obligatoire ?

false

Position ?

named

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Body <string>

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

Obligatoire ?

false

Position ?

3

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-BodyAsHtml

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

Obligatoire ?

false

Position ?

named

Valeur par défaut

False

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-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> ».

Obligatoire ?

false

Position ?

named

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Obligatoire ?

false

Position ?

named

Valeur par défaut

Current user

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Obligatoire ?

false

Position ?

named

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Obligatoire ?

false

Position ?

named

Valeur par défaut

ASCII

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Obligatoire ?

true

Position ?

named

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Priority <MailPriority>

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

Obligatoire ?

false

Position ?

named

Valeur par défaut

Normal.

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Obligatoire ?

false

Position ?

4

Valeur par défaut

$PSEmailServer

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Subject <string>

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

Obligatoire ?

true

Position ?

2

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Obligatoire ?

true

Position ?

1

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-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é.

Obligatoire ?

false

Position ?

named

Valeur par défaut

False

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

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

Entrées

System.String

Vous pouvez diriger le chemin d'accès et le nom des pièces jointes vers Send-MailMessage.

Sorties

Aucun

Cette applet de commande ne génère aucune sortie.

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.









Table des matières