Rule description
This rule queries Office 365 and for each user that satisfies specific criteria and then adds or removes selected license plan options depending on the specified action.
When to use this rule
Use this rule when you need to add or remove an Office 365 license plan options for users who have this license plan assigned.
Rule Settings
Query Section
| Setting name | Description |
|---|---|
|
General Settings |
|
|
Account Status |
Select user account status: enabled, disabled or both. |
|
Filter |
To hide unwanted data returned by the query, select the filtering conditions. Example: Find all users with E1 plan assigned {$_.Licenses.AccountSkuId -match "STANDARDPACK"}
You can find out the license plan ID in the cache file on the machine where the Cayosoft service is installed: C:\ProgramData\Cayo Software\AdminAssistant\ItemCache\O365LicenseDefCache.xml This XML file contains friendly names of plans and their IDs. |
|
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.
|
|
Query Filters |
|
|
Display Name/E-mail starts with |
Specify the first letters of Name or Email attributes. |
|
Filter by Title Filter by Department Filter by City Filter by State Filter by Country Filter by Usage Location |
Specify the value of corresponding attributes.
|
|
More options |
|
|
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. |
|
Limit query for Office 365
|
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's 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 Users | 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.
Comments
0 comments
Please sign in to leave a comment.