Users web query

Limit scope to this Azure AD Administrative Unit

You can select Azure AD Administrative Unit to limit the Web Query scope.

By default, the value is taken from the Virtual Admin Unit setting.

Query criteria

Query criteria are sent to the target platform with other query parameters to reduce the number of returned objects and may improve query performance.

Other Query Settings

Properties to display

Each object property defined in this setting matches the column that will be displayed in the Cayosoft Web portal for this web query.

To display additional columns, add the required properties to the Properties to display list.

Tip: To add extension attribute 1 that is synchronized from AD you need use value like "OnPremisesExtensionAttributes/extensionAttribute1~Extension Attribute 1".

System properties

List of properties required for this rule to be executed correctly.

Post-query filter

To hide unwanted data based on criteria, not supported by the target system in the query criteria, set the filtering conditions here.

Sort by

Sort result object list.

Limit result set

The maximum number of user accounts returned from Microsoft 365. The default value is taken from the Users web query Show setting in Cayosoft Web Portal.

MS Graph query condition (OData)

By default Query criteria are used. But when the MS Graph query condition is specified, it overrides the Query criteria setting.

Example: find all Microsoft 365 user accounts with displayName starting with 'Adam.'

(startswith(displayName,'Adam'))

Initialization script

Usually, rules use query criteria to limit the query search scope. It improves the performance of the executed rule.

Due to PowerShell limitations, it is not possible to use calculated expressions in query criteria. That is the point where the initialization script can help. You can initialize a global variable in this setting and then use it in query criteria.

MS Graph advanced queries

Enables consistency level eventual which uses an index that might not be up-to-date with recent changes to the object.

Office 365 License Quota

Enable quota management

Licenses list with settings

Licensing quota notification contacts

Cayosoft Administrator allows allocating Microsoft 365 licenses and assigning quota limits by Administrative Units. Having configured an Administrative Unit per department and then configured License Quotas in Users web queries on these Administrative Units, you will prevent local department IT to over-use the Microsoft 365 licenses and will get an overview of over-and under-use across departments.

For step-by-step configuration instructions, please see Office 365 License Quotas article.

Replace Web UI Help URL

In Cayosoft Web Portal each web query has a help link that opens the corresponding section in Cayosoft documentation.

If you need you can replace the default link with your custom link to your intranet portal.