New-Mailbox

  • 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-Mailbox permet de créer un utilisateur dans le service d'annuaire Active Directory et d'activer une boîte aux lettres pour ce nouvel utilisateur.

Syntaxe

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Password <SecureString> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -LinkedDomainController <String> -LinkedMasterAccount <UserIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-LinkedCredential <PSCredential>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Equipment <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Shared <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Room <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet New-Mailbox, 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 dossiers personnalisés gérés sont une fonctionnalité essentielle de la gestion des enregistrements de messagerie (MRM). Les boîtes aux lettres avec des stratégies incluant des dossiers personnalisés gérés requièrent une licence d'accès client à Exchange Server Enterprise.

Paramètres

Paramètre Obligatoire Type Description

Database

Obligatoire

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Le paramètre Database spécifie la base de données Exchange devant contenir la boîte aux lettres du nouvel utilisateur. Vous pouvez utiliser les valeurs suivantes :

  • GUID de la base de données

  • Nom de la base de données

  • Nom de serveur\nom de base de données

  • Nom de serveur\groupe de stockage\nom de base de données

Equipment

Obligatoire

System.Management.Automation.SwitchParameter

LE paramètre Equipment spécifie que la ressource est du type équipement si cette boîte aux lettres est une boîte aux lettres de ressources. Ce paramètre est nécessaire uniquement si vous créez une boîte aux lettres de ressources.

LinkedDomainController

Obligatoire

System.String

Le paramètre LinkedDomainController spécifie le contrôleur de domaine dans la forêt où réside le compte d'utilisateur. Le contrôleur de domaine dans cette forêt est utilisé pour obtenir des informations de sécurité pour le compte spécifié par le paramètre LinkedMasterAccount. Ce paramètre est obligatoire uniquement si vous créez une boîte aux lettres liée.

LinkedMasterAccount

Obligatoire

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

Le paramètre LinkedMasterAccount spécifie le compte principal dans la forêt où réside le compte d'utilisateur. Le compte principal est celui auquel lier la boîte aux lettres. Le compte principal donne accès à la boîte aux lettres. Ce paramètre est obligatoire uniquement si vous créez une boîte aux lettres liée. Vous pouvez utiliser l'une des valeurs suivantes :

  • GUID

  • Nom unique

  • Domaine\Compte

  • Nom d'utilisateur principal (UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Name

Obligatoire

System.String

Le paramètre Name spécifie le nom de l'utilisateur. Il s'agit du nom qui s'affiche dans Utilisateurs et ordinateurs Active Directory. C'est également le nom d'utilisateur qui s'affiche dans Propriétés du destinataire sous l'onglet Informations utilisateur.

Password

Obligatoire

System.Security.SecureString

Le paramètre Password spécifie le mot de passe de l'utilisateur créé. Ce paramètre n'est pas obligatoire si vous créez une boîte aux lettres liée, une boîte aux lettres de ressources ou une boîte aux lettres partagée car le compte d'utilisateur pour ces types de boîtes aux lettres sera désactivé.

Room

Obligatoire

System.Management.Automation.SwitchParameter

Le paramètre Room spécifie que la ressource est du type salle si cette boîte aux lettres est une boîte aux lettres de ressources. Ce paramètre est nécessaire uniquement si vous créez une boîte aux lettres de ressources.

Shared

Obligatoire

System.Management.Automation.SwitchParameter

Le paramètre Shared spécifie que vous créez une boîte aux lettres partagée. Une boîte aux lettres partagée est une boîte aux lettres à laquelle plusieurs utilisateurs peuvent se connecter. Cette boîte aux lettres n'est associée à aucun des utilisateurs pouvant se connecter. Elle est associée à un compte d'utilisateur désactivé.

Ce paramètre est obligatoire uniquement si vous créez une boîte aux lettres partagée.

UserPrincipalName

Obligatoire

System.String

Le paramètre UserPrincipalName spécifie le nom d'utilisateur principal (UPN) pour cette boîte aux lettres. Il s'agit du nom de connexion de l'utilisateur. Le nom d'utilisateur principal est constitué d'un nom d'utilisateur et d'un suffixe. Généralement, le suffixe est le nom du domaine dans lequel le compte d'utilisateur réside.

ActiveSyncMailboxPolicy

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

Le paramètre ActiveSyncMailboxPolicy spécifie la stratégie de boîte aux lettres mobile à activer pour la boîte aux lettres que vous créez. Si vous ne spécifiez pas ce paramètre, la stratégie de boîte aux lettres par défaut est utilisée.

Alias

Facultatif

System.String

Le paramètre Alias spécifie l'alias de messagerie de l'utilisateur que vous créez.

L'alias peut être une combinaison de caractères séparés par un point, sans espace. N'utilisez pas de caractères spéciaux dans l'alias.

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 complet du nouvel utilisateur créé avec cette boîte aux lettres. DisplayName est le nom qui s'affiche dans la console de gestion Exchange sous Configuration du destinataire. DisplayName s'affiche également dans Utilisateurs et ordinateurs Active Directory sous l'onglet Propriétés générales.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Le paramètre DomainController spécifie le contrôleur de domaine à utiliser pour écrire cette modification de configuration dans Active Directory. Utilisez le nom de domaine complet (FQDN) du contrôleur de domaine que vous voulez utiliser.

FirstName

Facultatif

System.String

Le paramètre FirstName spécifie le prénom de l'utilisateur que vous créez.

Initials

Facultatif

System.String

Le paramètre Initials spécifie les initiales de l'utilisateur que vous créez.

LastName

Facultatif

System.String

Le paramètre LastName spécifie le nom de l'utilisateur que vous créez.

LinkedCredential

Facultatif

System.Management.Automation.PSCredential

Le paramètre LinkedCredential spécifie les informations d'identification à utiliser pour accéder au contrôleur de domaine spécifié par le paramètre LinkedDomainController. Ce paramètre est facultatif, même si vous activez une boîte aux lettres liée.

ManagedFolderMailboxPolicy

Facultatif

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

Le paramètre ManagedFolderMailboxPolicy spécifie la stratégie de boîte aux lettres de dossier géré à activer pour la boîte aux lettres que vous créez.

ManagedFolderMailboxPolicyAllowed

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre ManagedFolderMailboxPolicyAllowed ignore l’avertissement indiquant que les fonctionnalités de gestion des enregistrements de messagerie ne sont pas prises en charge pour les clients de messagerie électronique qui utilisent des versions de Microsoft Outlook antérieures à Outlook 2007. Lorsqu’une stratégie de boîte aux lettres de dossier géré est affectée à une boîte aux lettres utilisant le paramètre ManagedFolderMailboxPolicy, l’avertissement s’affiche par défaut sauf si le paramètre ManagedFolderMailboxPolicyAllowed est utilisé.

> [!Note] > Les clients Outlook 2003 Service Pack 3 sont pris en charge mais n'offrent que des fonctionnalités limitées pour la gestion des enregistrements de messagerie.

OrganizationalUnit

Facultatif

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Le paramètre OrganizationalUnit spécifie le conteneur dans lequel l'utilisateur sera créé.

ResetPasswordOnNextLogon

Facultatif

System.Boolean

S'il est défini sur $true, le paramètre ResetPasswordOnNextLogon spécifie que le mot de passe dans le paramètre Password doit être réinitialisé lors de la prochaine ouverture de session de l'utilisateur.

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 95, Windows 98 et LAN Manager. Cet attribut doit compter moins de 20 caractères pour être compatible avec des clients plus anciens.

Si vous ne spécifiez pas ce paramètre, Active Directory crée automatiquement un SAMAccountName basé sur le nom principal de l'utilisateur.

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.

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

Le premier exemple montre comment créer un utilisateur nommé Chris Ashton dans Active Directory, puis créer une boîte aux lettres pour cet utilisateur. La boîte aux lettres se trouve dans Storage Group 1, dans Mailbox Database 1. Le mot de passe doit être redéfini lors de l'ouverture de session suivante. Pour définir la valeur initiale du mot de passe, cet exemple crée une variable, $password, vous invite à entrer un mot de passe, et affecte ce mot de passe à la variable en tant qu'objet SecureString.

Le deuxième exemple montre comment créer un utilisateur dans Active Directory et une boîte aux lettres de ressources pour une salle de conférence. La boîte aux lettres de ressources se trouve dans Storage Group 1, dans Mailbox Database 1. Le mot de passe doit être redéfini lors de l'ouverture de session suivante. L'environnement de ligne de commande Exchange Management Shell invite à entrer la valeur du mot de passe initial car elle n'est pas spécifiée.

$password = Read-Host "Enter password" -AsSecureString
New-mailbox -UserPrincipalName chris@contoso.com -alias chris -database "Storage Group 1\Mailbox Database 1" -Name ChrisAshton -OrganizationalUnit Users -password $password -FirstName Chris -LastName Ashton -DisplayName "Chris Ashton" -ResetPasswordOnNextLogon $true

New-Mailbox -UserPrincipalName confmbx@contoso.com -alias confmbx -name ConfRoomMailbox -database "Storage Group 1\Mailbox Database 1" -OrganizationalUnit Users -Room -ResetPasswordOnNextLogon $true