New-MailUser

  • Article

 

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

Dernière rubrique modifiée : 2009-05-12

La cmdlet New-MailUser permet de créer un utilisateur à extension messagerie.

Syntaxe

New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -Password <SecureString> -UserPrincipalName <String> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet New-MailUser crée un objet utilisateur à extension messagerie dans le service d'annuaire Active Directory.

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

  • le rôle Administrateur des destinataires Exchange ;

  • le rôle Opérateur de compte pour les conteneurs Active Directory applicables.

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 définis avec la cmdlet New-MailUser. Vous pouvez définir des paramètres supplémentaires avec la cmdlet Set-User.

Paramètres

Paramètre Obligatoire Type Description

ExternalEmailAddress

Obligatoire

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 à extension messagerie sont envoyés à cette adresse externe.

Name

Obligatoire

System.String

Le paramètre Name spécifie le nom commun (CN) de l'utilisateur à extension messagerie.

Password

Obligatoire

System.Security.SecureString

Le paramètre Password spécifie le mot de passe utilisé par l'utilisateur de messagerie pour sécuriser son compte.

UserPrincipalName

Obligatoire

System.String

Le paramètre UserPrincipalName définit le nom d'un utilisateur du système dans un format d'adresse de messagerie (par exemple, ted@contoso.com).

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.

DisplayName

Facultatif

System.String

Le paramètre DisplayName spécifie le nom qui s'affiche dans Microsoft Outlook pour l'utilisateur de messagerie.

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.

FirstName

Facultatif

System.String

Le paramètre FirstName spécifie le prénom de l'utilisateur de messagerie.

Initials

Facultatif

System.String

Le paramètre Initials spécifie les initiales de l'utilisateur de messagerie.

LastName

Facultatif

System.String

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

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

  • UUENCODE

  • 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 ou UUENCODE 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.

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.

OrganizationalUnit

Facultatif

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Le paramètre OrganizationalUnit spécifie l'unité d'organisation à laquelle l'utilisateur est ajouté (par exemple, redmond.contoso.com/contacts).

PrimarySmtpAddress

Facultatif

Microsoft.Exchange.Data.SmtpAddress

Ce paramètre permet de spécifier l'adresse SMTP principale de l'utilisateur de messagerie. Par défaut, l'adresse SMTP principale est générée sur la base de la stratégie d'adresse de messagerie par défaut. Si vous spécifiez une adresse SMTP principale à l'aide de ce paramètre, la cmdlet définit l'attribut EmailAddressPolicyEnabled de l'utilisateur de messagerie sur $false, et les adresses de messagerie de cet utilisateur de messagerie ne sont pas automatiquement mises à jour en fonction des stratégies d'adresse de messagerie.

ResetPasswordOnNextLogon

Facultatif

System.Boolean

Si le paramètre ResetPasswordOnNextLogon est défini sur $true, l'utilisateur devra modifier le mot de passe lors de la prochaine ouverture de session.

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 le Gestionnaire LAN. 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 :

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

TemplateInstance

Facultatif

System.Management.Automation.PSObject

Quand un objet existant est fourni au paramètre TemplateInstance, la commande utilise la configuration de cet objet pour créer une copie exacte de celui-ci sur un serveur local ou cible.

UsePreferMessageFormat

Facultatif

System.Boolean

Le paramètre UsePreferMessageFormat spécifie si les paramètres de format de message configurés pour la boîte aux lettres remplacent les paramètres globaux configurés pour le domaine. Définissez ce paramètre sur $true pour faire en sorte que les paramètres de format de message configurés pour la boîte aux lettres remplacent tous les paramètres globaux.

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.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exceptions

Exceptions Description

 

Exemple

L'exemple suivant comprend deux commandes.

Dans la première commande, un mot de passe, $password, du type System.Security.SecureString est créé. Si la commande est exécutée, l'invite « Entrer le mot de passe » s'affiche. La chaîne tapée par l'utilisateur devient la nouvelle chaîne de mot de passe, $password.

La seconde commande crée un objet utilisateur à extension messagerie nommé Ted Bremer et attribue le nouveau mot de passe à l'objet à l'aide du paramètre Password. Ted est employé chez Tailspin Toys mais, comme il travaille en étroite collaboration avec des employés de Contoso Corporation, il reçoit une adresse de messagerie portant le nom de domaine contoso.com. Ted n'a pas de boîte aux lettres Exchange Server chez Contoso. Les messages électroniques envoyés à l'adresse contoso.com de Ted sont transférés à son adresse de messagerie externe, ted@tailspintoys.com.

$password = Read-Host "Enter password" -AsSecureString
New-MailUser -Name "Ted Bremer" -Password $password -ExternalEmailAddress ted@tailspintoys.com -UserPrincipalName ted@contoso.com -OrganizationalUnit contoso.com