Office 365 Users | Mailbox post creation tasks
Rule description
This rule queries the matching Microsoft 365 user accounts and mailboxes then applies the Microsoft 365 mailbox settings defined in the Action section of this rule.
NOTE: It might take up to 15 minutes for Microsoft Platform to complete the user mailbox creation after a corresponding Microsoft 365 license is assigned. Before applying mailbox settings, the rule periodically checks whether the mailbox was created for the user. If a mailbox is not created within the period, defined by the Wait for Microsoft Mailbox creation (minutes) setting, a timeout occurred and is reported to the client.
When to use this rule
Use this rule when you need to apply mailbox settings to newly created Microsoft 365 user accounts.
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
You can find out the license plan ID in the cache file on the machine where the Cayosoft Administrator Service is installed: C:\ProgramData\Cayo Software\AdminAssistant\ItemCache\O365LicenseDefCache.xml This XML file contains friendly names of plans and their IDs. |
Query Filters | |
Display Name/E-mail starts with |
Specify the first letters of Name or Email attributes. |
|
Specify the value of the corresponding attributes.
|
More options | |
Properties to Display |
To display additional Microsoft 365 properties for each object found by the query, add those properties to the list. |
Sort by |
Sort result object list. |
|
Limit query for Office 365
|
The maximum number of users returned from Microsoft 365 by default is 2000. TIP: It is possible to change the default value in the Microsoft 365 extension settings. |
Initialization Script | |
Script |
Usually, rules use query criteria to limit the query search scope. It improves the performance of the executed rule. Due to the 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: Example: Update AD users, created in the last ten days.
|
Action section
| Setting name | Description* |
|---|---|
Wait for Microsoft Mailbox creation (minutes) |
Within a specified timeframe, the rule would periodically check whether the Microsoft Platform completed the creation of the user mailbox after a corresponding Microsoft 365 license was assigned. If a mailbox is not created within the defined period, a timeout error is reported to the client. |
Hide from GAL |
Specify whether this recipient is visible in address lists. |
Mailbox Size Limits | |
|
Maximum size of a message sent
|
Specify the maximum size of a message that can be sent by the mailbox. Provide an integer value, qualified with one of the following units:
The default value is 35840 KB. |
|
Maximum size of a message received
|
Specify the maximum size of a message that can be sent to the mailbox. Messages larger than the maximum size are rejected. Provide an integer value, qualified with one of the following units:
The default value is 35840 KB |
| Retention and Archival | |
Enable in-place archive |
Select Yes to create an in-place archive mailbox. |
Retention policy |
Select the retention policy enabled for your organization. |
|
Length of time to keep soft-deleted items
|
Specify the length of time to keep soft-deleted items for the mailbox. Soft-deleted items are items that have been deleted by using such methods as deleting items from the Deleted Items folder or using Shift + Delete. To specify a value, enter it as a time span: dd.hh:mm:ss where dd = days, hh = hours, mm = minutes, and ss = seconds. The default value is 14 days (14.00:00:00). The value range for this property is from 0 through 24,855 days. |
| Litigation hold | |
Enable Litigation Hold |
Specify Yes to place the mailbox on litigation hold. Specify No to disable the Litigation Hold. After a mailbox is placed on litigation hold, messages can't be deleted from the mailbox. Deleted items and all versions of changed items are retained in the Recoverable Items folder. Items that are purged from the dumpster are also retained and the items are held indefinitely. If you enable litigation hold, single-item recovery quotas aren't applied. |
Litigation hold duration (days) |
Specify the number of days the mailbox items are held if the mailbox is placed on litigation hold. The duration is calculated from the date a mailbox item is received or created. |
| Enable In-place Hold | Specify Yes to set an In-Place Hold on mailbox items. Specify No to disable an In-Place Hold. |
Enable In-place Hold duration (days) |
Specify the number of days for the In-Place Hold on the mailbox items. The duration is calculated from the time the item is received or created in the mailbox. |
| Regional Settings | |
|
Language
|
Specify the language preferences for this mailbox. Several Exchange components display information to a mailbox user in the preferred language if that language is supported. Some of those components include quota messages, non-delivery reports (NDRs), the Outlook on the web user interface, and Unified Messaging (UM) voice prompts. |
|
Time Zone
|
Specify the time zone for the mailbox. A valid value for this parameter is a supported time zone key name (for example, "Pacific Standard Time"). |
|
Date Format
|
Specify the date format string. For example, if the language is set to en-US, valid DateFormat parameter values include:
For more information about the date format strings, see Standard Date and Time Format Strings. TIP: The specified date format should be valid for the current or specified language for the mailbox. |
|
Time Format
|
Specify the time format based on the current or specified language value for the mailbox. For example, if the language is set to en-US, valid TimeFormat parameter values must include:
|
Wait before applying regional settings (seconds) |
Specify the number of seconds to wait before applying regional settings for the created mailbox. |
Mailbox Auditing | |
|
Enable Auditing
|
Specify Yes to enable mailbox audit logging and No to disable audit logging for the mailbox. If auditing is enabled, actions specified in the following parameters are logged:
|
|
Maximum age of audit log
|
Specify the maximum age of audit log entries for the mailbox. Log entries older than the specified value are removed. The default value is 14 days (14.00:00:00). To specify a value, enter it as a time span: Setting this parameter to the value |
|
Select the mailbox operations from the list to log as part of mailbox auditing logging for mailbox owners, delegate users, and administrators respectively.
|
Email Connectivity | |
|
Specify these settings to enable or disable access to the mailbox by using the corresponding protocol clients. You can add any required operation manually without using a picker. Use a comma as a delimiter. |
|
Select from the list or specify the name of the corresponding Exchange policy. |
| Outlook settings | |
|
Focused Inbox
|
Enable or disable Focused Inbox for the mailbox. Focused Inbox is a replacement for Clutter that separates the Inbox into the Focused and Other tabs in Outlook on the web and newer versions of Outlook. |
Reply all is the default response for messages |
Specify Yes to set Reply All as the default response for messages in Outlook on the web. |
| Junk Email | |
Enable junk email rule |
Specify if the junk email rule should be enabled. |
Treat contacts as trusted |
Specify if contacts should be treated as trusted. |
Don't trust email outside safe senders list |
In addition to Safe Senders, Recipients and Blocked Senders, you can use this setting to treat all email as junk unless it comes from someone included in your Safe Senders and Recipients list. |
Add to Safe Senders List |
Safe senders are domains and people whose email you don’t want diverting to your Junk Email folder. Add senders you trust and recipients that you don't want to block to this list. |
Add to Blocked Senders List |
Blocked senders are domains and people you don't want to receive email messages from. Messages received from any email address or domain in your blocked senders' list are sent directly to your Junk Email folder. |
* Certain details and information for the settings are taken from Microsoft Docs.
Output section
This section defines the output format of this rule.
To get more information about this section, please see the Rule 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 Rule Enforce/Schedule section article.
Comments
0 comments
Please sign in to leave a comment.