Exchange Server 2010 SP1 Beta Hosting Deployment… Part #3 – Creating New Mailbox

Alright, let's continue with this. So, you have seen how we can enable the hosting mode in Exchange Server 2010 SP1 beta by using the installation with /hosting switch in the Part #1, the first look and also how to create a hosted organization/tenant in part #2. Now let us continue with creating a tenant mailbox in the tenant organization.

Do you remember how we do it in HMC? In order for us to create a mailbox for a tenant organization, we need to do the following,

  1. Use Hosted Active Directory to create a new user object.
  2. Use Hosted Email 2007 name space procedure to Mailbox enable the user using the appropriate user plan.

It isn't that bad really. Of course, there are a lot of stuff going on in the background when you call that 2 procedures such as address list stamping, checking for Offline Address Book (if it is not available, create it if it is a MAPI plan), apply the appropriate permissions, allocate the mailbox store resource, apply the user mailbox plan like quotas, stamping with the right email and the list goes on.

In Exchange Server 2010 SP1 beta, it isn't that different. The good news is that, it has been greatly simplified with just one cmdlet, that is New-Mailbox. This one cmdlet will create both the AD object as well as the mailbox. Sweet, eh? By introducing additional switch to the cmdlet for hosting mode, this one little cmdlet will do all the magic, well almost all. Let's go through the process first, then we will discuss more.

If you recall, in part #2, when we created a new tenant organization, each organization has it's own configuration unit in the Active Directory's configuration container and also it's own organization container with tons of other stuff like the Organization Admin groups and etc. (I will spend some time to blog about this in detail soon). Because of that, when we create a tenant mailbox, it is important to make sure we are creating the mailbox in the right organization context. To do that, the New-Mailbox cmdlet in hosting mode comes with a switch called -Organization. Here is a sample that allows you to create a new mailbox in our beloved tenant organization, AlpineSkihouse,

New-Mailbox -Organization AlpineSkiHouse -Name "John Doe" -UserPrincipalName

Of course, there are a lot more parameters accepted by this cmdlet and I am putting in the least number of switches here. The above will prompt you for password and then it will proceed with creating the user. Once it is done, you get the following and you can proceed to logon to Outlook Web Access with this user already.

Let me highlight a few things here,

  1. The above will create an Active Directory User Object in the appropriate OU
  2. Insert the users into appropriate group
  3. Apply the appropriate AD permissions
  4. It then mailbox enable the user object
  5. The UserPrincipalName switch will be the email as well as the login name. You cannot use a different domain than the domain you put as the accepted domain for this tenant organization.
  6. It will find the default mailbox plan and apply the appropriate attributes
  7. It then apply the Email Address Policy and also the address list. 

The above is by no mean the full list of what is being done. Now, notice that I didn't specify any mailbox database in the cmdlet. I want to take a moment to specially mention this. You can manually specify the database if you want but if you don't do that, it will utilize the Exchange Server 2010 mailbox provisioning load balancing mechanism to select the mailbox database. I think it is cool, however as hosters sometimes you want to have better control and you want to be able to track like HMC. In those situations, you may need to build your own logic to do that. For example, you can either run the tool periodically to discover the location of the database use by each organization and populate the report or find a way to retrieve what database right after the mailbox creation. Of course, there are tons of other ways to do it, I am just listing out 1-2 ways).

One more thing I should also highlight is this, we no longer need to fear RUS kicking in and re-stamp our address list like we did in the old HMC way. That's because Exchange Server 2010 SP1 beta has full segregation of that.

So, really, that's it, as simple as that. I really like the simplicity of this.

While I am on mailbox, I might as well talk about how to get and remove mailbox in the specific organization context.

Like New-Mailbox, the Get-Mailbox also has an additional -Organization switch. So, here is what you can do,

To get all the users in an organization

Get-Mailbox -Organization AlpineSkiHouse


To get a specific user in an organization

Get-Mailbox -Organization AlpineSkiHouse -Identity jdoe

Note: I don't even need to put in the full email address, the alias will do the job. I love it. 🙂


So, that's all good. What about removing a mailbox then? You will notice that in this SP1 beta, the remove-mailbox has no additional -Organization switch. So, if you try to delete a mailbox for a specific tenant user, you will get error like the following,

This is because it isn't operating in the right context and hence not able to locate the mailbox. Here is how you do it,

To remove a specific user in an organization

Get-Mailbox -Organization AlpineSkiHouse -Identity jdoe  | Remove-Mailbox


Next stop, we will go more into the transport and address list.

Previous Articles

Exchange Server 2010 SP1 Beta Hosting Deployment... Part #1 - The First Look

Exchange Server 2010 SP1 Beta Hosting Deployment... Part #2 - Creating New Organization

Continue Reading...

Exchange Server 2010 SP1 Beta Hosting Deployment

Comments (13)
  1. Anonymous says:

    Hi Mike,

    Download the migration guide,…/hmc-s-hosted-exchange-to-exchange-server-2010-sp1-hosting-deployment-migration-guide.aspx

    Have a look at the document, "HMC to Exchange 2010 SP1 Step-by-Step Migration Guide.pdf". Look at section 1.5. See if that answers your question.

  2. Anonymous says:

    i want to add new accepted domain to existing OU in hosting exchange 2010 if you can help me please ….PS script

  3. Anonymous says:

    Hi Mike,

    The steps should be quite similar to the steps in migrating from HMC to Exchange 2010, where you will need to first move the AD objects and then perform cross forest mailbox migration.

    I don't have the exact steps documented here but have a look at the migration guide, that should give you a pretty good idea what's involved.



  4. Anonymous says:

    There is a switch [-MailboxPlan <MailboxPlanIdParameter>] that yo can use when creating a new mailbox.

  5. Anonymous says:

    Haa.. Slow down, Mobay. It is still beta but having to say that, wait till you see my next few blog entries, those will really want to make you jump over. At the same time, if I manage to find more time, I will blog about how to do SharePoint 2010 hosting as well as I think that's something that many people will be looking at as Microsoft moves to remove Public Folder support from this Hosted Exchange 2010.

  6. Anonymous says:

    Hi Mike,

    The steps should be quite similar to the steps in migrating from HMC to Exchange 2010, where you will need to first move the AD objects and then perform cross forest mailbox migration.

    I don't have the exact steps documented here but have a look at the migration guide, that should give you a pretty good idea what's involved.



  7. Mobay says:

    I love this Exchange 2010 Hosting mode more and more! Makes me want to move all our users away from HMC and forget it ever existed! 🙂

  8. Jez says:

    When creating a new mailbox how do you select another mailbox plan that is in your .servicePlan?

  9. Ross says:

    Hi Kip!

    Trying to find a command that will remove a tenant organization.

    lots to do with removing mailboxes, but what about the client Organization, is there a clean way to delete it with powershell?



  10. Ross says:

    NVM Kip, Found it on page 2 of your previous part# blog thread.


  11. Mike Lewis says:

    How do I move a mailbox from a different exchange 2007 organization into this new exchange 2010 SP1 tenant organization?  I know how to do it in 2010 non tenant via the EMC, but there is no EMC in tenant sp1.  Please be specific.  Thanks.

  12. Mike Lewis says:

    Hello Kip, I don't have an HMC environment so I am not sure of that process; however, here is the process I use for migrating an inter organization 2007 to 2010 (non tenant setup) mailbox:  


    cd C:program filesmicrosoftexchange serverv14scripts

    $Local = Get-Credential (newdomainadministrator)

    $Remote = Get-Credential (olddomainadministrator)


    .Prepare-MoveRequest.Ps1 -Identity mailboxnamesgoeshere -RemoteForestDomainController olddomaincontroller.local -RemoteForestCredential $Remote -LocalForestDomainController newdomaincontroller.local LocalForestCredential $Local -UseLocalObject    


    New-MoveRequest -Identity mailboxnamesgoeshere -RemoteLegacy -TargetDatabase "Mailbox Database 0534644139" -RemoteGlobalCatalog olddomaincontroller.local -RemoteCredential $Remote -TargetDeliveryDomain "" -baditemlimit 10


    – disconnect mailbox then reconnect to new AD account

    The above works fine in non tenant mode.  In tenant mode, since there is no EMC, I cannot perform step 4.  Do you know how to disconnect the mailbox and reconnect it to the new AD account?

  13. Richard says:

    Hi Kip,

    Is used the next rule to create a user:

    New-Mailbox -Organization AlpineSkiHouse -Name "John Doe" -UserPrincipalName

    Now I want to change the userprincipalnamen to;


    Could you help me with this?

Comments are closed.

Skip to main content