Rule description
This hybrid rule queries the specified Active Directory groups, and for each group member checks if the corresponding Office 365 user has the selected plan assigned. The rule changes the selected license plan options on a user to match the On/Off option state specified in the rule. An Active Directory user account should have a corresponding Office 365 user account with an identical UserPrincipalName (UPN).
When to use this rule
Use this rule when you need to add or remove an Office 365 license plan option for group members who have this licensing plan assigned.
Rule Settings
Query Section
| Setting name | Description |
|---|---|
|
Include AD Group Members |
Specify Distinguished Names of AD groups, which members will be assigned Office 365 licenses. |
|
Properties to Display |
To display additional Office 365 properties for each object found by the query, add those properties to the list. |
|
Sort by |
Sort result objects list. |
|
Stop rule if tenant licensing change detected |
It is recommended to stop the rule execution if a tenant licensing change is discovered. Tip: If licensing change is detected, you should click Update License in Microsoft Office 365 extension. For details, see KB20181017-1.
|
|
More options |
|
|
Exclude AD Group Members |
Specify AD groups Distinguished Names, which members will be excluded from Office 365 license assignment. Tip: Use this setting to exclude some group members from assigning Office 365 license plan options.
If the group, specified in Include AD Group Members, contains the same members as the group, specified in Exclude AD Group Members, these users won't be assigned Office 365 license plans options. |
|
Exclude disabled users from hybrid mapping |
Excluding disabled AD user accounts from the hybrid mapping is possible. |
|
Maximum number of users |
The maximum number of users returned from Office 365 by default is 2000. Tip: It is possible to change the default value in Microsoft Office 365 extension settings.
|
|
Stop rule if errors exceed |
Too many errors may indicate rule misconfiguration or problems with connectivity. Set this value to some integer value, indicating the number of occurred errors, when the rule execution should stop. |
Action Section
| Setting name | Description |
|---|---|
|
Action |
You can remove the selected options from existing licenses or add the selected options to existing licenses. Important: This rule can't assign Office 365 license plans. It adds or removes options within the plan. But if you uncheck all Office 365 license plan options, this plan will be removed from Office 365 user account.
If you need to assign Office 365 plans to Office 365 user accounts, use Office 365 Groups | Enforce License rule. |
|
License options |
Select which Microsoft Office 365 license plans' options to add or remove to Office 365 user accounts. |
|
License update order |
Select a method to assign selected license plans and options:
Note: In most cases Revoke Previous then Assign New option should be used. Please contact Cayosoft support before changing the default value.
|
|
Enforce license precedence (Advanced) |
For details, see KB20181026-1.
|
Output Section
This section defines the output format of this rule.
To get more information about this section, please see the Output section article.
Enforce/Schedule section
This section defines the schedule for how often to run the rule.
To get more information about this section, please see the Enforce/Schedule section article.
Change History
| Version | Notes |
|---|---|
| 7.3.0 |
The rule supports mapping between Active Directory user account and Cloud user account by anchor attributes. |
Comments
0 comments
Please sign in to leave a comment.