Set-MailUser

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2010-10-21

La cmdlet Set-MailUser permet de modifier les attributs de messagerie pour un utilisateur existant dans le service d'annuaire Active Directory.

Syntaxe

set-MailUser -Identity <MailUserIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

set-MailUser [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <MailUser>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Description détaillée

La cmdlet Set-MailUser permet de modifier les attributs de messagerie d'un utilisateur à extension messagerie dans Active Directory.

Pour exécuter la cmdlet Set-MailUser, vous devez utiliser un compte auquel a été délégué :

  • le rôle Administrateur des destinataires Exchange.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Notes

Les attributs d'utilisateur ne peuvent pas tous être modifiés avec la cmdlet Set-MailUser. La cmdlet Set-User permet de définir des attributs utilisateur supplémentaires sans relation avec la messagerie.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

Le paramètre Identity prend l'une des valeurs suivantes :

  • ADObjectID

  • GUID

  • Nom unique

  • Domaine\SamAccountName

  • Nom d'utilisateur principal (UPN)

  • DN hérité

  • Adresse de messagerie

  • Alias de l'utilisateur

  • Vous ne pouvez pas utiliser le paramètre Identity si le paramètre Instance est spécifié.

AcceptMessagesOnlyFrom

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre AcceptMessagesOnlyFrom spécifie les utilisateurs de boîte aux lettres, les utilisateurs de messagerie et les contacts de messagerie qui peuvent envoyer des messages électroniques à cet utilisateur de messagerie. Vous pouvez également spécifier Microsoft Exchange comme destinataire valide pour ce paramètre. Si vous configurez un utilisateur de messagerie pour n'accepter des messages que du destinataire Microsoft Exchange, cet utilisateur ne reçoit que des messages générés par le système.

Le paramètre AcceptMessagesOnlyFrom peut prendre l'une des valeurs suivantes pour les expéditeurs valides :

  • Nom unique

  • Nom canonique

  • GUID

  • Name

  • Nom complet

  • Alias

  • DN Exchange

  • Adresse de messagerie SMTP principale

Par défaut, ce paramètre est vide. Cette valeur par défaut permet à l'utilisateur de messagerie d'accepter des messages de tous les expéditeurs.

AcceptMessagesOnlyFromDLMembers

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre AcceptMessagesOnlyFromDLMembers spécifie les groupes de distribution dont les membres sont autorisés à envoyer des messages électroniques à cet utilisateur de messagerie. Vous pouvez utiliser toutes les valeurs suivantes pour les groupes de distribution autorisés :

  • Nom unique

  • Nom canonique

  • GUID

  • Name

  • Nom complet

  • Nom unique Exchange hérité

  • Adresse de messagerie SMTP principale

Par défaut, ce paramètre est vide. Cette valeur par défaut permet à l'utilisateur de messagerie d'accepter des messages de tous les expéditeurs.

Alias

Facultatif

System.String

Le paramètre Alias spécifie l'alias de l'utilisateur. Un alias peut contenir des lettres, des chiffres ainsi que les signes de ponctuation et les symboles suivants :

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par 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 paramètre Confirm.

CreateDTMFMap

Facultatif

System.Boolean

Ce paramètre indique qu’une carte DTMF (multifréquence bi-tonalité) peut être créée pour l’utilisateur.

CustomAttribute1

Facultatif

System.String

Le paramètre CustomAttribute1 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute10

Facultatif

System.String

Le paramètre CustomAttribute10 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute11

Facultatif

System.String

Le paramètre CustomAttribute11 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute12

Facultatif

System.String

Le paramètre CustomAttribute12 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute13

Facultatif

System.String

Le paramètre CustomAttribute13 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute14

Facultatif

System.String

Le paramètre CustomAttribute14 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute15

Facultatif

System.String

Le paramètre CustomAttribute15 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute2

Facultatif

System.String

Le paramètre CustomAttribute2 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute3

Facultatif

System.String

Le paramètre CustomAttribute3 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute4

Facultatif

System.String

Le paramètre CustomAttribute4 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute5

Facultatif

System.String

Le paramètre CustomAttribute5 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute6

Facultatif

System.String

Le paramètre CustomAttribute6 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute7

Facultatif

System.String

Le paramètre CustomAttribute7 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute8

Facultatif

System.String

Le paramètre CustomAttribute8 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

CustomAttribute9

Facultatif

System.String

Le paramètre CustomAttribute9 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

DisplayName

Facultatif

System.String

Le paramètre DisplayName spécifie le nom complet de l'utilisateur.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory, incluez le paramètre DomainController dans la commande.

EmailAddresses

Facultatif

Microsoft.Exchange.Data.ProxyAddressCollection

Le paramètre EmailAddresses permet de spécifier l'alias de messagerie de l'utilisateur de messagerie. Vous pouvez utiliser tous les types d'adresses de messagerie Microsoft Exchange 2007 valides. Vous pouvez spécifier plusieurs valeurs pour le paramètre EmailAddresses sous la forme d'une liste délimitée par des virgules.

importantImportant :
Exchange 2007 ne valide pas d'adresses personnalisées pour une mise en forme appropriée. Vous devez veiller à ce que l'adresse personnalisée que vous spécifiez soit conforme aux exigences de mise en forme pour ce type d'adresse. Comme les adresses X.400 sont considérées comme des adresses personnalisées dans Exchange 2007, elles ne sont pas non plus validées. C'est pourquoi, vous devez introduire la syntaxe correcte lors de la spécification d'une adresse X.400.

EmailAddressPolicyEnabled

Facultatif

System.Boolean

Le paramètre EmailAddressPolicyEnabled spécifie si les adresses de messagerie de la boîte aux lettres seront automatiquement mises à jour sur la base des stratégies d'adresse de messagerie définies. Lorsque ce paramètre est défini sur $true, vous ne pouvez pas modifier les paramètres PrimarySmtpAddress ou WindowsEmailAddress.

Extensions

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie un ou plusieurs numéros de poste pour l'utilisateur. Une fois le paramètre défini, tous les numéros de poste dans le plan de numérotation doivent être uniques.

ExternalEmailAddress

Facultatif

Microsoft.Exchange.Data.ProxyAddress

Le paramètre ExternalEmailAddress spécifie une adresse de messagerie à l'extérieur de l'organisation. Les messages électroniques envoyés à l'utilisateur sont envoyés à cette adresse externe.

GrantSendOnBehalfTo

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Le paramètre GrantSendOnBehalfTo spécifie le nom unique (DN) des destinataires qui peuvent envoyer des messages au nom de cet utilisateur.

HiddenFromAddressListsEnabled

Facultatif

System.Boolean

Le paramètre HiddenFromAddressListsEnabled spécifie l'affichage ou non de l'utilisateur dans les listes d'adresses. La valeur par défaut est $false.

IgnoreDefaultScope

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre IgnoreDefaultScope donne pour instruction à la commande d'ignorer le paramétrage de la portée du destinataire par défaut pour l'environnement de ligne de commande Exchange Management Shell et d'utiliser l'ensemble de la forêt comme portée. Cela permet à la commande d'accéder à des objets Active Directory ne figurant pas actuellement dans la portée par défaut. L'utilisation du paramètre IgnoreDefaultScope introduit les restrictions suivantes :

  • Vous ne pouvez pas utiliser le paramètre DomainController. La commande utilisera automatiquement un serveur de catalogue global approprié.

  • Vous ne pouvez utiliser le nom unique que pour le paramètre Identity. D'autres formes d'identification, telles qu'un alias ou un GUID, ne sont pas acceptées.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.Management.MailUser

Le paramètre Instance permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande.

MacAttachmentFormat

Facultatif

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

Le paramètre MacAttachmentFormat spécifie le format de pièce jointe du système d'exploitation Apple Macintosh pour les messages envoyés à l'utilisateur de messagerie. Les valeurs possibles pour ce paramètre sont :

  • BinHex

  • AppleSingle

  • AppleDouble

Par défaut, ce paramètre est défini sur BinHex.

Les valeurs possibles pour le paramètre MacAttachmentFormat dépendent du paramètre MessageFormat. Si le paramètre MessageFormat est défini sur Texte, vous ne pouvez utiliser que les valeurs BinHex pour ce paramètre. Si le paramètre MessageFormat est défini sur Mime, vous ne pouvez utiliser que les valeurs BinHex, AppleSingle ou AppleDouble pour ce paramètre.

MaxReceiveSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre MaxReceiveSize spécifie la taille maximale des messages électroniques que peut recevoir l'utilisateur de messagerie, qui peut être comprise entre 1 Ko et 2 097 151 Ko.

Si aucune valeur n'est spécifiée, il n'y a pas de restriction de taille.

MaxSendSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre MaxSendSize spécifie la taille maximale des messages électroniques que peut envoyer l'utilisateur de messagerie, qui peut être comprise entre 1 Ko et 2 097 151 Ko.

Si aucune valeur n'est spécifiée, il n'y a pas de restriction de taille.

MessageBodyFormat

Facultatif

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

Le paramètre MessageBodyFormat spécifie le format du corps de message pour les messages envoyés à l'utilisateur de messagerie. Les valeurs possibles pour ce paramètre sont :

  • Text

  • Html

  • TextAndHtml

Par défaut, ce paramètre est défini sur TextAndHtml.

Les paramètres MessageFormat et MessageBodyFormat sont interdépendants. Si le paramètre MessageFormat est défini sur Mime, vous pouvez définir le paramètre MessageBodyFormat sur n'importe quelle valeur valide. En revanche, si le paramètre MessageFormat est défini sur Texte, le paramètre MessageBodyFormat ne peut être défini que sur Texte. C'est pourquoi, si vous voulez définir ce paramètre sur Html ou TextAndHtml, vous devez également définir le paramètre MessageFormat sur Mime.

MessageFormat

Facultatif

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

Le paramètre MessageFormat spécifie le format de message pour les messages envoyés à l'utilisateur de messagerie.

Les valeurs possibles pour ce paramètre sont :

  • Text

  • Mime

Par défaut, ce paramètre est défini sur Mime.

Les paramètres MessageFormat et MessageBodyFormat sont interdépendants. Si le paramètre MessageFormat est défini sur Mime, vous pouvez définir le paramètre MessageBodyFormat sur n'importe quelle valeur valide. En revanche, si le paramètre MessageFormat est défini sur Texte, le paramètre MessageBodyFormat ne peut être défini que sur Texte. C'est pourquoi, si vous voulez modifier le paramètre MessageFormat de Mime en Texte, vous devez également modifier le paramètre MessageBodyFormat en Texte.

Name

Facultatif

System.String

Le paramètre Name spécifie le nom de l'utilisateur.

PrimarySmtpAddress

Facultatif

Microsoft.Exchange.Data.SmtpAddress

Le paramètre PrimarySmtpAddress spécifie l'adresse SMTP principale.

RecipientLimits

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre RecipientLimits spécifie le nombre maximal de destinataires pour les messages de cet utilisateur.

RejectMessagesFrom

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre RejectMessagesFrom spécifie les destinataires dont les messages doivent être rejetés.

RejectMessagesFromDLMembers

Facultatif

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Le paramètre RejectMessagesFromDLMembers spécifie les membres de liste de distribution dont les messages doivent être rejetés.

RequireSenderAuthenticationEnabled

Facultatif

System.Boolean

Le paramètre RequireSenderAuthenticationEnabled spécifie la nécessité ou non d'accepter des messages de destinataires authentifiés uniquement. La valeur par défaut est $false.

SamAccountName

Facultatif

System.String

Le paramètre SamAccountName spécifie le nom de connexion utilisé pour prendre en charge des clients et des serveurs exécutant des versions plus anciennes du système d'exploitation, telles que Microsoft Windows NT 4.0, Windows 98, Windows 95 et LAN Manager. Cet attribut doit comporter moins de 20 caractères Un nom de compte peut contenir des lettres, des chiffres ainsi que les signes de ponctuation et les symboles suivants :

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

SecondaryAddress

Facultatif

System.String

Ce paramètre indique l’adresse secondaire utilisée par l’utilisateur à extension messagerie unifiée.

SecondaryDialPlan

Facultatif

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Ce paramètre spécifie un plan secondaire de commutation des appels de messagerie unifiée à utiliser. Ce paramètre est destiné à créer une adresse proxy secondaire.

SimpleDisplayName

Facultatif

System.String

Le paramètre SimpleDisplayName permet d'afficher une autre description de l'objet lorsque seul un jeu de caractères limité est autorisé. Le jeu de caractères limité comprend les caractères suivants :

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

UMDtmfMap

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre indique si vous voulez créer une carte DTMF définie par l'utilisateur pour l’utilisateur à extension messagerie unifiée.

UseMapiRichTextFormat

Facultatif

Microsoft.Exchange.Data.Directory.Recipient.UseMapiRichTextFormat

Le paramètre UseMapiRichTextFormat spécifie la manière dont les messages au format MAPI RTF (Rich Text Format) sont gérés pour cet utilisateur de messagerie. Définissez ce paramètre sur Never afin de convertir tous les messages envoyés à cet utilisateur en texte brut. Définissez ce paramètre sur Always afin de toujours envoyer à cet utilisateur des messages au format MAPI RTF. Définissez ce paramètre sur UseDefaultSettings pour que le choix du format soit basé sur le paramètre configuré dans le client MAPI ayant envoyé le message.

UsePreferMessageFormat

Facultatif

System.Boolean

Le paramètre UsePreferMessageFormat spécifie si les paramètres de format de message configurés pour l'utilisateur de messagerie remplaceront les paramètres globaux configurés pour le domaine distant. Définissez ce paramètre sur $true pour faire en sorte que les paramètres de format de message configurés pour l'utilisateur de messagerie remplacent tous les paramètres globaux.

UserPrincipalName

Facultatif

System.String

Le paramètre UserPrincipalName spécifie un nom d'utilisateur principal (UPN) pour l'utilisateur.

UseRusServer

Facultatif

System.String

 > [!Note] > Ce paramètre n'est disponible que dans Exchange 2007 SP2.

Le paramètre UseRusServer indique à la commande d'utiliser le serveur de boîtes aux lettres spécifié sur lequel le service de listes d'adresses est exécuté pour obtenir puis définir les attributs des boîtes aux lettres et des utilisateurs Active Directory.

Le service de listes d'adresses est un composant du service Surveillance du système Exchange. Le service de listes d'adresses crée et gère les valeurs des attributs spécifiques d'Exchange dans Active Directory. Vous pouvez utiliser le service de listes d'adresses pour mettre à jour les objets destinataire dans un domaine à l'aide d'informations spécifiques telles que l'appartenance à une liste d'adresses et des adresses de messagerie.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre 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 paramètre WhatIf.

WindowsEmailAddress

Facultatif

Microsoft.Exchange.Data.SmtpAddress

Le paramètre WindowsEmailAddress spécifie l'adresse de messagerie Windows pour cette boîte aux lettres. Cette adresse n'est pas utilisée par Exchange.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exceptions

Exceptions Description

 

Exemple

Dans cet exemple, la commande Set-MailUser est utilisée pour définir l'adresse de messagerie extérieure à l'organisation à laquelle les messages électroniques de l'utilisateur à extension messagerie John Peoples sont envoyés.

Set-MailUser john -ExternalEmailAddress john@tailspintoys.com