Step-by-step Starting with Exchange 2010 SP1 multi-tenant: Create and delete organizations


This tutorial is part of 4 parts tutorial on Exchange 2010 multi-tenancy support
Part 1: Installation of Exchange 2010 SP1 in hosting mode
Part 2: Creating and deleting Organizations in Exchange 2010 SP1 hosting mode
Part 3: Managing Organization in Exchange 2010 SP1 hosting mode
Part 4: Sending and receiving emails in Exchange 2010 SP1 hosting mode

In part 1 of this tutorial I have showed you how to install Exchange 2010 SP1 multi-tenant (or in hosting mode).

Today we will go over the process of creating and deleting organizations and mailboxes mailboxes.

A look at Service Plans

Before doing a jump start and create an organization we need to take a look at some files located on your CAS server called Service Plans.

Service plans are located by default in “C:\Program Files\Microsoft\Exchange Server\V14\ClientAccess\ServicePlans” of your CAS server and they define the different services your hosted organization provides to its customer.

15

We have 2 things to notice here

  1. Since the files are located on the CAS then editing a file means updating it on all your CAS servers
  2. You have 2 kinds of files the .ServicePlan files that actually defines all permissions you give to an organization and the .csv file that maps Hosting Plans with Service Plans

.ServicePlan files

Each .SevicePlan above presents a set of permissions/features/quotas etc.. and their names are self explanatory. However if you need to change or create you own ServicePlan the file itself is an xml file, just start with the HostingAllFeatures_Sample.ServicePlan and remove any entry you don’t want and/or change any value.

N.B.: Make sure NOT to use the sample plans if you edit them since they will replaced by any update done on the server.

16

.csv file

The other kind of file in this folder is the ServicePlanHostingRemap.csv that is pretty simple as it maps a specific hosting plan name and offerID to a service plan defined above. Nothing really complicated her but definitely worth a look

17

Creating your first organization

So now that you have grasp the general idea about ServicePlan files let’s create our first organization. We will start by running

$c = get-credential

This will prompt you for a username and password, you can input any username you want since all we need from this command is the password. The password specified is going to be used for the administrator of the organization you are about to create.
Then run

New-organization -name TestOrg -DomainName TestOrg.com -ProgramId HostingSample -OfferId 2 -location en-US -AdministratorPassword $c.password

05
Let’s focus on this command a bit

  1. Name parameter defines the Organization name you are about to create
  2. DomainName parameter defines the SMTP domain of this organization, so users in the TestOrg organization will have emails @TestOrg.com
  3. ProgramID is coming right from the .csv file we have just discussed so this organization will have the HostingSample hosting plan<
  4. OfferID is also defined in the .csv file above, so we need to match HostingSample with ProgramID 2 we are giving to this organization the HostingAllFeatures_sample ServicePlan
  5. AdministratorPassword: As you can notice the parameter is only concerned with the password of this organization’s administrator, not the username, so we are using on the password provided in the get-credentials command only by using $c.password

That was not that complicated right ! But what happened on the Active Directory side ?

07

As you can see a dedicated OU was created for the TestOrg organization with its Administrator user and its own Security groups. Pretty cool hein !
Don’t worry yet about the extra user “Antoine Khater” we will see how to create it in the Part 3 of this tutorial.

Deleting an Organization

To finish today’s article I will go over the process of deleting an organization.

Deleting all mailboxes

You will not be allowed of purging an organization as long as it has mailboxes so we will need to, as a start, delete all the mailboxes of the organization. You will now notice that the “get-mailbox” command has, in hosting mode, an extra parameter -organization. So to delete all mailboxes in the TestOrg organization we will run

get-mailbox -Organization TestOrg | remove-mailbox

08

Deleting the organization

Now that the organization is empty of all mailboxes it can be deleting using

Remove-Organization TestOrg

09
And as you can imagine in will do all the cleaning from Active Directory as well.
10

Conclusion

That’s it for today, in part 3 of this tutorial we will see how to manage your organization.


This tutorial is part of 4 parts tutorial on Exchange 2010 multi-tenancy support
Part 1: Installation of Exchange 2010 SP1 in hosting mode
Part 2: Creating and deleting Organizations in Exchange 2010 SP1 hosting mode
Part 3: Managing Organization in Exchange 2010 SP1 hosting mode
Part 4: Sending and receiving emails in Exchange 2010 SP1 hosting mode

I have been working in IT consultancy and solution integration since 1998 and I consider myself lucky to be, one in a few, making a living out of my passion. I am also member of the famous Experts Exchange (profile here) online community where I try my best to share what I have learned along the road.

Posted in Messaging & Collaboration Tagged with: , , ,
12 comments on “Step-by-step Starting with Exchange 2010 SP1 multi-tenant: Create and delete organizations
  1. mouhamad says:

    I have created 2 organizations.

    mydomain.com and yourdomain.com

    [PS] C:Windowssystem32>get-mailboxdatabase

    Name Server Recovery ReplicationType

    —- —— ——– —————

    Mailbox Database 1274405931 WEB1 False None

    shouldnt there be 2 databases??

  2. Timo Haapavuori says:

    Hi, Can I use same domain name for multiple orgs? If we have some generic domain which smaller orgs can use which dont have own domain?

  3. Steve Gordon says:

    Great Posts btw… Was wondering if anyone had any nicely configured service plans already in production that they wanted to share… Done my versions but would like to compare with some that are already tried and true…

    Thanks,
    Steve

  4. Garcetto says:

    when you specify a password with get-credencial REMEMBER to give a complex one otherwise the others command will give you many errors.

    • akhater says:

      Hi Gracetto,
      When you use the get-credential you should use the actual password of the user complex or not it depends on your policy

  5. How would you create an organization that has multiple domains.

    Ex: TestOrg has domain TestOrg.com and TestOrg.ca. TestOrg.com would be primary, but some users would have TestOrg.ca alias addresses. How can this be done?
    New-organization -name TestOrg -DomainName TestOrg.com -ProgramId HostingSample -OfferId 2 -location en-US -AdministratorPassword $c.password

  6. Yahya says:

    One of the few brilliant step by step guide of something very rare. Hosted Exchange is something which you dont usually find on web but this site is amazing. Followed all the steps and I have Mail Exchange with hosted environment.
    Thanks
    Yahya

  7. Btracht00 says:

    I have followed step 1 – everything installed without a hitch. I tried to setup new OU and am getting an error. Am I doing something wrong? Any help would be appreciated.

    • Dennis Tap says:

      I had the same problem. You need to use the new-organization command in the ‘Exchange Management Shell’ and not the normal ‘PowerShell’

      • Btracht00 says:

        Thanks for the reply. However, I am using exchange management shell. I just did a fresh install (windows server and exchange) to make sure I am doing everything right and still getting the same error. Any ideas???

  8. Brad Hitchinson says:

    Hi Antoine, followed your steps but get the following error? Can you help?
    Great tutorial by the way these are rare!

    The process failed to read the Exchange topology in the allotted time.
    + CategoryInfo : NotSpecified: (0:Int32) [New-Organization], ReadTopologyTimeoutException
    + FullyQualifiedErrorId : D57C9CC1,Microsoft.Exchange.Management.Deployment.NewOrganizationTask

4 Pings/Trackbacks for "Step-by-step Starting with Exchange 2010 SP1 multi-tenant: Create and delete organizations"
  1. […] part 1 of this tutorial we have seen how to install exchange 2010 SP1 in hosting mode and in part 2 we learned to Create and Delete organizations. I will show you today in this tutorial the basic […]

  2. […] 2010 multi-tenancy support Part 1: Installation of Exchange 2010 SP1 in hosting mode Part 2: Creating and deleting Organizations in Exchange 2010 SP1 hosting mode Part 3: Managing Organization in Exchange 2010 SP1 hosting mode Part 4: Sending and receiving […]

  3. […] 2010 multi-tenancy support Part 1: Installation of Exchange 2010 SP1 in hosting mode Part 2: Creating and deleting Organizations in Exchange 2010 SP1 hosting mode Part 3: Managing Organization in Exchange 2010 SP1 hosting mode Part 4: Sending and receiving […]

Leave a Reply to Yahya Cancel reply

Your email address will not be published. Required fields are marked *

*