.png)
New-MailMessage
S’applique à : Exchange Server 2013, Exchange Online
Dernière rubrique modifiée : 2012-09-18
La cmdlet New-MailMessage permet de créer un message électronique pour la boîte aux lettres utilisateur spécifiée et de placer le message électronique dans le dossier Brouillons de la boîte aux lettres de l’utilisateur.
Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe.
New-MailMessage [-Body <String>] [-BodyFormat <PlainText | Html | Rtf>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Subject <String>] [-WhatIf [<SwitchParameter>]]
Cet exemple crée un message électronique dans le dossier Brouillons dont l’objet et le corps sont spécifiés par les paramètres Subject et Body. Le corps du message est restitué en texte brut, car aucun format pour le corps du message n’est spécifié.
New-MailMessage -Subject "Delivery Report" -Body "Click here to view this report"
Cet exemple crée un message électronique vide dans le dossier Brouillons car aucun objet ni corps de message n’est spécifié.
New-MailMessage
Cet exemple crée un message électronique dans le dossier Brouillons dont l’objet et le corps sont spécifiés par les paramètres Subject et Body. Le corps du message est restitué au format HTML.
New-MailMessage -Subject "Delivery Information" -Body "Click here to see details" -BodyFormat Html
Si la cmdlet est exécutée sans spécifier les paramètres Subject ou Body, un message électronique vide est placé dans le dossier Brouillons de l’utilisateur.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir Entrée « Boîtes aux lettres d’utilisateurs » dans la rubrique Autorisations des destinataires.
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
| Body | Facultatif | System.String | Le paramètre Body spécifie le contenu de la section du corps du nouveau message électronique. |
| BodyFormat | Facultatif | Microsoft.Exchange.Data.Providers.MailBodyFormat | Le paramètre BodyFormat spécifie le format du corps du message. Les valeurs peuvent être |
| Confirm | Facultatif | System.Management.Automation.SwitchParameter | Le commutateur Confirm suspend la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n’est pas nécessaire de spécifier une valeur pour le commutateur Confirm. |
| DomainController | Facultatif | Microsoft.Exchange.Data.Fqdn | Le paramètre DomainController spécifie le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory. |
| Subject | Facultatif | System.String | Le paramètre Subject spécifie le contenu du champ Objet du nouveau message électronique. |
| WhatIf | Facultatif | System.Management.Automation.SwitchParameter | Le commutateur WhatIf donne pour instruction à la commande de simuler les actions qu’elle va appliquer à l’objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n’est pas nécessaire de spécifier une valeur pour le commutateur WhatIf. |
Pour visualiser les types d’entrées acceptées par cette cmdlet, voir Types d’entrée et de sortie de la cmdlet. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.
Pour visualiser les types de retour, connus également en tant que types de sortie, acceptés par cette cmdlet, voir Types d’entrée et de sortie de la cmdlet. Si le champ Type de sortie est vide, la cmdlet ne retourne pas de données.
