Managed Active Directory::CreateOrganization

  • Article

The CreateOrganization method creates an organization.

Arguments

Input Arguments Required Description

<Name>

Yes

The name of the new organization

<container>

Yes

The Lightweight Directory Access Protocol (LDAP) path to the organization container

<policyName>

No

The type of the new organization. Lowercase letters, for example, reseller

<description>

No

The description for the new organization

<properties>

No

Properties for the organizational unit to store with the organization

<preferredDomainController>

No

The domain controller to be used for this request

Remarks

Security

  • Impersonate caller.

Sample Code

Example XML Request

<request> 
  <procedure> 
    <execute namespace="Managed Active Directory" procedure="CreateOrganization" impersonate="1"> 
      <executeData> 
        <name>Reseller1</name> 
        <policyName>reseller</policyName> 
        <container>LDAP://ou=Hosting,dc=contoso,dc=com</container> 
        <description>The reseller of contoso @contoso.com</description> 
        <properties></properties> 
        <preferredDomainController>myPrimaryDC.contoso.com</preferredDomainController> 
      </executeData> 
      <after source="executeData" destination="data" sourcePath="org" /> 
    </execute> 
  </procedure> 
</request>

Example XML Response

<response> 
  <data> 
    <org path="LDAP://ou=Reseller1,ou=Hosting,dc=contoso,dc=com" name="Reseller1"> 
      <orgs> 
        <org path="LDAP://ou=Services,ou=Reseller1,ou=Hosting,dc=contoso,dc=com" 
            name="Services"> 
          <groups> 
            <group path="LDAP://cn=Admins@Reseller1,ou=Services,ou=Reseller1,ou=Hosting,dc=contoso,dc=com"  
                name="Admins@Reseller1" samName="A@Reseller1"></group> 
            <group path="LDAP://cn=CSRAdmins@Reseller1,ou=Services,ou=Reseller1,ou=Hosting,dc=contoso,dc=com"  
                name="CSRAdmins@Reseller1" samName="CA@Reseller1"></group> 
            <group path="LDAP://cn=AllCustomers@Reseller1,ou=Services,ou=Reseller1,ou=Hosting,dc=contoso,dc=com"  
                name="AllCustomers@Reseller1" samName="AC@Reseller1"></group> 
            <group path="LDAP://cn=AllUsers@Reseller1,ou=Services,ou=Reseller1,ou=Hosting,dc=contoso,dc=com"  
                name="AllUsers@Reseller1" samName="AU@Reseller1"> 
              <memberOfGroup  
                  name="LDAP://cn=AllUsersGroups,ou=Services,ou=Hosting,dc=contoso,dc=com"></memberOfGroup> 
            </group> 
          </groups> 
        </org> 
      </orgs> 
      <dacl> 
        <ace> 
          <permission>ADS_RIGHT_DS_LIST_OBJECT</permission> 
          <trustee>LDAP://cn=AllUsers@Reseller1,ou=Services,ou=Reseller1,ou=Hosting,dc=contoso,dc=com</trustee> 
          <trusteeType>TRUSTEE_IS_GROUP</trusteeType> 
          <trusteeForm>TRUSTEE_IS_SID</trusteeForm> 
          <mode>GRANT_ACCESS</mode> 
        </ace> 
        <ace> 
          <permission>ADS_RIGHT_ACTRL_DS_LIST</permission> 
          <permission>ADS_RIGHT_DS_READ_PROP</permission> 
          <permission>ADS_RIGHT_READ_CONTROL</permission> 
          <inheritance>SUB_CONTAINERS_AND_OBJECTS_INHERIT</inheritance> 
           <trustee>LDAP://cn=AllUsers@Reseller1,ou=Services,ou=Reseller1,ou=Hosting,dc=contoso,dc=com</trustee> 
          <trusteeType>TRUSTEE_IS_GROUP</trusteeType> 
          <trusteeForm>TRUSTEE_IS_SID</trusteeForm> 
          <mode>GRANT_ACCESS</mode> 
        </ace> 
        <ace> 
          <permission>ADS_RIGHT_DS_LIST_OBJECT</permission> 
          <trustee>LDAP://cn=AllCustomers@Reseller1,ou=Services,ou=Reseller1,ou=Hosting,dc=contoso,dc=com</trustee> 
          <trusteeType>TRUSTEE_IS_GROUP</trusteeType> 
          <trusteeForm>TRUSTEE_IS_SID</trusteeForm> 
          <mode>GRANT_ACCESS</mode> 
        </ace> 
        <ace> 
          <permission>ADS_RIGHT_DS_WRITE_PROP</permission> 
          <permission>ADS_RIGHT_WRITE_DAC</permission> 
          <permission>ADS_RIGHT_DS_CONTROL_ACCESS</permission> 
          <permission>ADS_RIGHT_DS_CREATE_CHILD</permission> 
          <inheritance>SUB_CONTAINERS_AND_OBJECTS_INHERIT</inheritance> 
          <trustee>LDAP://cn=Admins@Reseller1,ou=Services,ou=Reseller1,ou=Hosting,dc=contoso,dc=com</trustee> 
          <trusteeType>TRUSTEE_IS_GROUP</trusteeType> 
          <trusteeForm>TRUSTEE_IS_SID</trusteeForm> 
          <mode>GRANT_ACCESS</mode> 
        </ace> 
      </dacl> 
    </org> 
  </data> 
</response>

Applies To

Managed Active Directory Namespace APIManaged Active Directory Namespace API for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Managed Active Directory::DeleteOrganization
Managed Active Directory::ModifyOrganization
Managed Active Directory::RenameOrganization