Share via

Managed Active Directory::GetPolicy

  • Article

The GetPolicy procedure obtains the permissions and other policy elements for an object. The GetPolicy procedure defines:

  • Security permissions that must be applied to all new system objects.

  • Group memberships that must be granted to new group and user objects.

  • Child organizational units and child groups that must be created within new organizational units.

Arguments

Input Arguments Required Description

<policyName>

Yes

The type of organization for this policy. Possible types are:

  • default

  • hosting

  • reseller

  • customer

Dd229933.note(en-us,TechNet.10).gifNote
If you do not include this element, the request uses the default value.

<containerPath>

Yes

The Lightweight Directory Access Protocol (LDAP) path of the domain in which Hosting is to be created.

<objectName>

Yes

The type of object on which to get the policy.

<objectType>

Yes

The LDAP path of the domain in which Hosting is to be created.

<objectPath>

No

The LDAP path as an alternative way of providing the <containerPath> and <objectName> parameters.

Remarks

No remarks.

Sample Code

Example XML Request

<request> 
  <procedure> 
    <execute namespace="Managed Active Directory" procedure="GetPolicy"> 
      <executeData> 
        <policyName>reseller</policyName> 
        <containerPath>LDAP://ou=Reseller,ou=Hosting,dc=contoso,dc=com</containerPath> 
        <objectName>ResellerGuy</objectName> 
        <objectType>user</objectType> 
      </executeData> 
    </execute> 
  </procedure> 
</request>

Example XML Response

This procedure returns as extensive response; the details will vary depending on your particular deployment.

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