New-Mailbox (RTM)

  • Article

 

S’applique à : Exchange Server 2007

Dernière rubrique modifiée : 2008-03-13

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> -OrganizationalUnit <OrganizationalUnitIdParameter> -Password <SecureString> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

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

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

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

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

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.

Paramètres

Paramètre Obligatoire Type Description

Base de données

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.

OrganizationalUnit

Obligatoire

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

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 est une combinaison de caractères séparés par un point, sans espace. N'utilisez pas de caractères spéciaux dans l'alias.

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.

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.

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