Send-MailMessage
Envoie un e-mail.
Syntaxe
All
Send-MailMessage
[-To] <string[]>
[-Subject] <string>
[[-Body] <string>]
[[-SmtpServer] <string>]
-From <string>
[-Attachments <string[]>]
[-Bcc <string[]>]
[-BodyAsHtml]
[-Encoding <Encoding>]
[-Cc <string[]>]
[-DeliveryNotificationOption <DeliveryNotificationOptions>]
[-Priority <MailPriority>]
[-Credential <pscredential>]
[-UseSsl]
[-Port <int>]
[<CommonParameters>]
Description
L’applet de commande Send-MailMessage envoie un e-mail à partir de PowerShell.
Vous devez spécifier un serveur SMTP (Simple Mail Transfer Protocol) ou la commande Send-MailMessage échoue. Utilisez le paramètre smtpServer $PSEmailServer est le paramètre SMTP par défaut pour PowerShell. Pour plus d'informations, consultez about_Preference_Variables.
Exemples
Exemple 1 : Envoyer un e-mail d’une personne à une autre personne
Cet exemple envoie un e-mail d’une personne à une autre personne.
Les paramètres De, Àet Objet sont requis par Send-MailMessage. Cet exemple utilise la variable $PSEmailServer par défaut pour le serveur SMTP. Par conséquent, le paramètre SmtpServer n’est pas nécessaire.
Send-MailMessage -From 'User01 <user01@fabrikam.com>' -To 'User02 <user02@fabrikam.com>' -Subject 'Test mail'
L’applet de commande Send-MailMessage utilise le paramètre From pour spécifier l’expéditeur du message. Le paramètre À spécifie le destinataire du message. Le paramètre objet
Exemple 2 : Envoyer une pièce jointe
Cet exemple envoie un message électronique avec une pièce jointe.
Send-MailMessage -From 'User01 <user01@fabrikam.com>' -To 'User02 <user02@fabrikam.com>', 'User03 <user03@fabrikam.com>' -Subject 'Sending the Attachment' -Body "Forgot to send the attachment. Sending now." -Attachments .\data.csv -Priority High -DeliveryNotificationOption OnSuccess, OnFailure -SmtpServer 'smtp.fabrikam.com'
L’applet de commande Send-MailMessage utilise le paramètre From pour spécifier l’expéditeur du message. Le paramètre To spécifie les destinataires du message. Le paramètre Objet décrit le contenu du message. Le paramètre Body est le contenu du message.
Le paramètre Pièces jointes spécifie le fichier dans le répertoire actif attaché au message électronique. Le paramètre Priority définit le message sur priorité élevée. Le paramètre
Exemple 3 : Envoyer un e-mail à une liste de diffusion
Cet exemple envoie un e-mail à une liste de diffusion.
Send-MailMessage -From 'User01 <user01@fabrikam.com>' -To 'ITGroup <itdept@fabrikam.com>' -Cc 'User02 <user02@fabrikam.com>' -Bcc 'ITMgr <itmgr@fabrikam.com>' -Subject "Don't forget today's meeting!" -Credential domain01\admin01 -UseSsl
L’applet de commande Send-MailMessage utilise le paramètre From pour spécifier l’expéditeur du message. Le paramètre To spécifie les destinataires du message. Le paramètre Cc envoie une copie du message au destinataire spécifié. Le paramètre cci envoie une copie aveugle du message. Une copie aveugle est une adresse e-mail masquée par les autres destinataires. Le paramètre Objet est le message, car le paramètre facultatif Body n’est pas inclus.
Le paramètre Credential spécifie les informations d’identification d’un administrateur de domaine sont utilisées pour envoyer le message. Le paramètre UseSsl spécifie que ssl (Secure Socket Layer) crée une connexion sécurisée.
Paramètres
-Attachments
Spécifie le chemin d’accès et les noms de fichiers à joindre au message électronique. Vous pouvez utiliser ce paramètre ou diriger les chemins d’accès et les noms de fichiers vers Send-MailMessage.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | PsPath |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Bcc
Spécifie les adresses e-mail 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 e-mail, telles que Name <someone@fabrikam.com>.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Body
Spécifie le contenu du message électronique.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-BodyAsHtml
Spécifie que la valeur du paramètre Body contient du code HTML.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | BAH |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Cc
Spécifie les adresses e-mail auxquelles une copie carbone (CC) du message électronique est envoyée. Entrez les noms (facultatif) et l’adresse e-mail, telles que Name <someone@fabrikam.com>.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Credential
Spécifie un compte d’utilisateur autorisé à effectuer 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 qu’un objet à partir de l’applet de commande Get-Credential.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | Current user |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DeliveryNotificationOption
Spécifie les options de notification de remise pour le message électronique. Vous pouvez spécifier plusieurs valeurs. Aucune n’est la valeur par défaut. L’alias de ce paramètre est DNO .
Les notifications de remise sont envoyées à l’adresse dans le paramètre From.
Les valeurs acceptables pour ce paramètre sont les suivantes :
- Aucun: aucune notification.
- OnSuccess: informez si la livraison réussit.
- OnFailure: notifier si la remise échoue.
- retard: notifier si la remise est retardée.
- Jamais: ne jamais notifier.
Propriétés du paramètre
| Type: | DeliveryNotificationOptions |
| Valeur par défaut: | None |
| Valeurs acceptées: | None, OnSuccess, OnFailure, Delay, Never |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | DNO |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Encoding
Spécifie le type d’encodage du fichier cible. La valeur par défaut est Default.
Les valeurs acceptables pour ce paramètre sont les suivantes :
- ASCII utilise un jeu de caractères ASCII (7 bits).
- BigEndianUnicode utilise UTF-16 avec l’ordre d’octet big-endian.
- par défaut utilise l’encodage qui correspond à la page de codes active du système (généralement ANSI).
- oem utilise l’encodage correspondant à la page de codes OEM actuelle du système.
- l' Unicode utilise UTF-16 avec l’ordre d’octet little-endian.
- UTF7 utilise UTF-7.
- UTF8 utilise UTF-8.
- UTF32 utilise UTF-32 avec l’ordre d’octet little-endian.
Propriétés du paramètre
| Type: | Encoding |
| Valeur par défaut: | Default |
| Valeurs acceptées: | ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32 |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | ÊTRE |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-From
Le paramètre From est requis. Ce paramètre spécifie l’adresse e-mail de l’expéditeur. Entrez un nom (facultatif) et une adresse e-mail, comme Name <someone@fabrikam.com>.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Port
Spécifie un autre port sur le serveur SMTP. La valeur par défaut est 25, qui est le port SMTP par défaut.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | 25 |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Priority
Spécifie la priorité du message électronique. Normal est la valeur par défaut. Les valeurs acceptables pour ce paramètre sont Normal, High et Low.
Propriétés du paramètre
| Type: | MailPriority |
| Valeur par défaut: | Normal |
| Valeurs acceptées: | Normal, High, Low |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SmtpServer
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 n’est pas utilisé, la commande Send-MailMessage échoue.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | $PSEmailServer |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Nom de l'ordinateur |
Jeux de paramètres
(All)
| Position: | 3 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Subject
Le paramètre Subject est requis. Ce paramètre spécifie l’objet du message électronique.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | sous |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-To
Le paramètre À est requis. Ce paramètre spécifie l’adresse e-mail du destinataire. S’il existe plusieurs destinataires, séparez leurs adresses par une virgule (,). Entrez les noms (facultatif) et l’adresse e-mail, telles que Name <someone@fabrikam.com>.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-UseSsl
Le protocole SSL (Secure Sockets Layer) est utilisé pour établir une connexion sécurisée à l’ordinateur distant pour envoyer du courrier. Par défaut, SSL n’est pas utilisé.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
String
Vous pouvez diriger le chemin d’accès et les noms de fichiers des pièces jointes vers Send-MailMessage.
Sorties
None
Cette applet de commande ne génère aucune sortie.