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.

Default user state filter value

Specify the state of users to include in the web query scope:

1. All
2. Enabled
3. Disabled

Default user type filter value

Specify the type of users to include in the web query scope:

1. All
2. Users
3. Guests

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 to use a 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.

See this article for examples: How to use Query Builder dialog for Query Criteria and Filter rule settings – Cayosoft Help Center.

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. You will get an overview of over-and under-use across departments.

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

Suspend Configuration

AD User Suspend configuration

Specify AD User Suspend configuration. By default, it is taken from the Admin Unit settings.

AD User Undo Suspend configuration

Specify AD User Undo Suspend configuration. By default, it is taken from the Admin Unit settings.

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.

1. Default user state filter value and Default user type filter value settings have been added.
2. Suspend Configuration section has been added.