Exchange Mobility Provider::SetUserPolicyExemption

The SetUserPolicyExemption method sets a user's policy exempt status. The exemption is stored in the msExchOmaAdminWirelessEnable attribute, as follows:

"0x00000020: whether or not policy is to be enforced for this user. When enabled, the user will be subject to policy checks. The default state is enabled, which corresponds to a value of 0 for this field. This is not a typo."

The exemption is also stored in the msExchOmaAdminExtendedSettings multivalued attribute to a value of "PolicyDataExemption:true" which allows ESM to display a list of exempted users.

Arguments

Input argument Required Description

<path>

Yes

The Lightweight directory access protocol (LDAP) path of the user. Type=string.

<preferredDomainController>

Yes

The name of the preferred domain controller in the Service Provider domain. Type=string.

Remarks

Rollback

For the SetUserPolicyExemption method, the previous policy status is restored upon rollback.

Sample Code

Example XML Request

The following is an example of an XML request for the SetUserPolicyExemption method of the Exchange Mobility Provider:

<request> 
        <procedure> 
                <execute namespace="Exchange Mobility Provider" procedure="SetUserPolicyExemption" impersonate="1"> 
                        <executeData> 
<preferredDomainController>ad01.fabrikam.com</preferredDomainController> 
                                <path>LDAP://CN=user@alpineskihouse.com, OU=AlpineSkiHouse,OU=ConsolidatedMessengerOU=Hosting,DC=Fabrikam,DC=Com</path> 
                        </executeData> 
                        <after source="executeData" destination="data" mode="merge"/> 
                </execute> 
        </procedure> 
</request> 

Example XML Response

No example XML response.

Applies To

API Name [HMC SDK] for:

  • Hosted Messaging and Collaboration version 3.5

See also

Tasks

Exchange Mobility Provider::ClearUserPolicyExemption