New-MailUser (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-05
La cmdlet New-MailUser permet de créer un utilisateur à extension messagerie.
Syntaxe
New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -OrganizationalUnit <OrganizationalUnitIdParameter> -Password <SecureString> -UserPrincipalName <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>]
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. |
OrganizationalUnit |
Obligatoire |
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). |
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 :
|
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 :
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 :
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 :
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. |
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 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 :
|
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. |
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