Applies to: Exchange Server 2007 SP3, Exchange Server
2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2009-05-12
Use the Enable-Mailbox cmdlet to mailbox-enable an existing user or InetOrgPerson.
Syntax
enable-Mailbox -Identity <UserIdParameter>
-Database <DatabaseIdParameter> [-ActiveSyncMailboxPolicy
<MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm
[<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-ManagedFolderMailboxPolicy
<MailboxPolicyIdParameter>]
[-ManagedFolderMailboxPolicyAllowed <SwitchParameter>]
[-PrimarySmtpAddress <SmtpAddress>] [-UseRusServer
<String>] [-WhatIf [<SwitchParameter>]]
|
enable-Mailbox -Identity <UserIdParameter>
-Database <DatabaseIdParameter> -Room <SwitchParameter>
[-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias
<String>] [-Confirm [<SwitchParameter>]] [-DisplayName
<String>] [-DomainController <Fqdn>]
[-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
[-ManagedFolderMailboxPolicyAllowed <SwitchParameter>]
[-PrimarySmtpAddress <SmtpAddress>] [-UseRusServer
<String>] [-WhatIf [<SwitchParameter>]]
|
enable-Mailbox -Identity <UserIdParameter>
-Database <DatabaseIdParameter> -Equipment
<SwitchParameter> [-ActiveSyncMailboxPolicy
<MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm
[<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-ManagedFolderMailboxPolicy
<MailboxPolicyIdParameter>]
[-ManagedFolderMailboxPolicyAllowed <SwitchParameter>]
[-PrimarySmtpAddress <SmtpAddress>] [-UseRusServer
<String>] [-WhatIf [<SwitchParameter>]]
|
enable-Mailbox -Identity <UserIdParameter>
-Database <DatabaseIdParameter> -Shared
<SwitchParameter> [-ActiveSyncMailboxPolicy
<MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm
[<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-ManagedFolderMailboxPolicy
<MailboxPolicyIdParameter>]
[-ManagedFolderMailboxPolicyAllowed <SwitchParameter>]
[-PrimarySmtpAddress <SmtpAddress>] [-UseRusServer
<String>] [-WhatIf [<SwitchParameter>]]
|
enable-Mailbox -Identity <UserIdParameter>
-Database <DatabaseIdParameter> -LinkedDomainController
<String> -LinkedMasterAccount <UserIdParameter>
[-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias
<String>] [-Confirm [<SwitchParameter>]] [-DisplayName
<String>] [-DomainController <Fqdn>] [-LinkedCredential
<PSCredential>] [-ManagedFolderMailboxPolicy
<MailboxPolicyIdParameter>]
[-ManagedFolderMailboxPolicyAllowed <SwitchParameter>]
[-PrimarySmtpAddress <SmtpAddress>] [-UseRusServer
<String>] [-WhatIf [<SwitchParameter>]]
|
Parameters
Parameter | Required | Type | Description | ||
---|---|---|---|---|---|
Database |
Required |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
The Database parameter specifies which Exchange database will contain the new mailbox. You can use one of the following values:
If you do not specify the server name, the cmdlet will search for the database on the local server. If you have multiple databases with the same name on the same server, you must specify the storage group. |
||
Equipment |
Required |
System.Management.Automation.SwitchParameter |
The Equipment parameter specifies that the type of resource is equipment, if this mailbox is a resource mailbox. This parameter is required only if you are enabling a resource mailbox. |
||
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.UserIdParameter |
The Identity parameter specifies the user or InetOrgPerson that you want to mailbox-enable. You can use one of the following values:
|
||
LinkedDomainController |
Required |
System.String |
The LinkedDomainController parameter specifies the domain controller in the forest where the user account resides. The domain controller in this forest is used to get security information for the account specified by the LinkedMasterAccount parameter. This parameter is required only if you are creating a linked mailbox. Use the fully qualified domain name (FQDN) of the domain controller you want to use as the value for this parameter. |
||
LinkedMasterAccount |
Required |
Microsoft.Exchange.Configuration.Tasks.UserIdParameter |
The LinkedMasterAccount parameter specifies the master account in the forest where the user account resides. The master account is the account to link the mailbox to. The master account will grant access to the mailbox. This parameter is required only if you are creating a linked mailbox. You can use one of the following values:
|
||
Room |
Required |
System.Management.Automation.SwitchParameter |
The Room parameter specifies that the type of resource is a room, if this mailbox is a resource mailbox. This parameter is required only if you are enabling a resource mailbox. |
||
Shared |
Required |
System.Management.Automation.SwitchParameter |
The Shared parameter specifies that you are creating a shared mailbox. A shared mailbox is a mailbox to which multiple users can log on. This mailbox is not associated with any of the users that can log on. It is associated with a disabled user account. This parameter is required only if you are creating a shared mailbox. |
||
ActiveSyncMailboxPolicy |
Optional |
Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter |
The ActiveSyncMailboxPolicy parameter specifies the mailbox policy to enable for the mailbox that you create. If you do not specify this parameter, the default mailbox policy is used. |
||
Alias |
Optional |
System.String |
The Alias parameter modifies the e-mail alias of the mailbox that you are enabling. The alias can be a combination of characters separated by a period with no intervening spaces. Do not use special characters in the alias. |
||
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm parameter. |
||
DisplayName |
Optional |
System.String |
The DisplayName parameter specifies the display name for the mailbox. The DisplayName is the name that appears in the Exchange Management Console under Recipient Configuration. |
||
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
The DomainController parameter specifies the domain controller to use to write this configuration change to Active Directory. Use the fully qualified domain name (FQDN) of the domain controller that you want to use. |
||
LinkedCredential |
Optional |
System.Management.Automation.PSCredential |
The LinkedCredential parameter specifies credentials to use to access the domain controller specified by the LinkedDomainController parameter. This parameter is optional, even if you are enabling a linked mailbox. |
||
ManagedFolderMailboxPolicy |
Optional |
Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter |
The ManagedFolderMailboxPolicy parameter specifies the managed folder mailbox policy to enable for the mailbox that you create. If you do not specify this parameter, the default managed folder mailbox policy is used. |
||
ManagedFolderMailboxPolicyAllowed |
Optional |
System.Management.Automation.SwitchParameter |
The ManagedFolderMailboxPolicyAllowed parameter bypasses the warning that messaging records management features are not supported for e-mail clients using versions of Outlook earlier than Outlook 2007. When a managed folder mailbox policy is assigned to a mailbox using the ManagedFolderMailboxPolicy parameter, the warning appears by default unless ManagedFolderMailboxPolicyAllowed is used.
|
||
PrimarySmtpAddress |
Optional |
Microsoft.Exchange.Data.SmtpAddress |
Use this parameter to specify the primary SMTP address for the
mailbox. By default, the primary SMTP address is generated based on
the default e-mail address policy. If you specify a primary SMTP
address by using this parameter, the cmdlet will set the
EmailAddressPolicyEnabled attribute of the mailbox to
|
||
UseRusServer |
Optional |
System.String |
The UseRusServer parameter instructs the command to use the specified Mailbox server on which the Address List service is running to obtain and then set mailbox and Active Directory user attributes. The Address List service is a component in the Exchange System Attendant service. The Address List service creates and maintains Exchange-specific attribute values in Active Directory. You can use the Address List service to update recipient objects in a domain by using specific information, such as address list membership and e-mail addresses. |
||
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf parameter. |
Detailed Description
The Enable-Mailbox cmdlet mailbox-enables an existing user or InetOrgPerson. This creates additional mailbox attributes on the user object in the Active Directory directory service. When the user logs on to the mailbox or receives e-mail messages, a mailbox object in the Exchange database is created.
Use the Identity parameter to specify the user or InetOrgPerson for whom the mailbox is enabled. Use the Database parameter to specify the Exchange database that will contain the mailbox.
To run the Enable-Mailbox cmdlet, the account you use must be delegated the following:
- Exchange Recipient Administrator role
For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.
Important: |
---|
When mailbox-enabling an existing user, if an alias is not specified, Microsoft Exchange Server 2007 uses the user principal name (UPN) and converts all non-ASCII characters to underscore characters. In some languages that use non-standard character sets, the user account may have a non-ASCII value for the UPN. In this case, when you mailbox-enable the user, the alias will be changed to all underscore characters. To avoid this, confirm that the user account has an ASCII UPN before you create the new mailbox, or make sure you specify a value for the alias. |
Note: |
---|
Managed custom folders are a premium feature of messaging records management (MRM). Mailboxes with policies that include managed custom folders require an Exchange Server Enterprise client access license (CAL). |
Input Types
Return Types
Errors
Error | Description |
---|---|
|
Example
The following example shows how to create a mailbox for an existing user Ted Bremer. The mailbox will be created in Database01 on Exchange server Mail01.
Copy Code | |
---|---|
Enable-Mailbox -Identity Contoso\TedBremer -Database Mail01\Database01 |