Rule description
This rule runs a selected Microsoft 365 usage report and presents the results in the selected output format.
When to use this rule
Use this rule to get the selected Microsoft 365 Usage report.
Rule Settings
Query Section
| Setting name | Description |
|---|---|
|
Microsoft 365 usage report |
Select Microsoft 365 usage report.
|
|
Period or date |
Specify period or date. Note: Before specifying a period or date please check if the selected report supports these parameters: Working with Microsoft 365 usage reports in Microsoft Graph - Microsoft Graph beta | Microsoft Docs.
|
|
Other Query Settings |
|
|
Properties to display |
To display additional properties for each object found by the query, add those properties to the list. |
|
Filter |
To hide unwanted data based on criteria, not supported by the target system in the query criteria, set the filtering conditions here. Example: filter by the found object Distinguished Name. Tip: For optimal performance, use the Query criteria above to filter objects whenever possible.
|
|
Sort by |
Sort result object list. |
|
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. Important: To use a variable, declared in the initialization script, in the query scope, it must be global: $global:<variable name>.
Example: Update AD users, created in the last ten days.
{$global:DatePeriod = (Get-Date).AddDays(-10)}
|
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 |
|---|---|
| 8.2.0 | The rule is introduced in the product. |
Comments
0 comments
Please sign in to leave a comment.