Skip to main content

Articles in this section

See more
Print

Office 365 Users | OneDrive post creation tasks

  • Updated

Office 365 Users | OneDrive post creation tasks

Rule description

This rule queries the matching Microsoft 365 user accounts and applies Microsoft 365 OneDrive settings defined in the Action section of this rule.

NOTE: Before using this rule in the Cayosoft Administrator Console, navigate to Configuration > Connected Systems Extensions > Microsoft 365, and set Connect to SharePoint Online service to Yes.

It might take up to 15 minutes for the Microsoft Platform to complete the OneDrive service enablement for the user after a corresponding Microsoft 365 license is assigned. Before applying OneDrive settings, the rule periodically checks whether the service was enabled. If OneDrive is not enabled within the period, defined by Time-out (minutes) setting, a timeout occurred and reported to the client.

When to use this rule

Use this rule when you need to apply OneDrive 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

{$_.Licenses.AccountSkuId -match "STANDARDPACK"}

You can find out the license plan ID in the cache file on the machine where 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 the 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 the corresponding attributes.

 

More options

Properties to Display

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

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

To add extension attribute 1 that is synchronized from AD, you need to use a value like:

Copy
"OnPremisesExtensionAttributes/extensionAttribute1~Extension Attribute 1"

Sort by

Sort result objects 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: $global:<variable name>.

Example: Update AD users, created in the last ten days.

  1. Add this initialization script

    Copy
    {$global:DatePeriod = (Get-Date).AddDays(-10)}

  2. Use the $DatePeriod variable in the query criteria builder:

Action section

Setting name Description

Time-out (minutes)

 

 Withing a specified timeframe the rule would periodically check whether the Microsoft Platform completed enablement of OneDrive service for the user after a corresponding Office 365 license was assigned. If service was not enabled within the defined period, a timeout error is reported to the client.

Create Personal Site

 

Set to Yes to create a personal site for a user.

NOTE: All other settings make sense only if this setting is set to Yes.

Storage quota in GB 

Specify storage quota per user in GB. By default, it is 1024 GB. 

External Sharing

Let people outside the organization to access your site

Specify if people outside the organization can access the user's site.

Access type

If people outside the organization can access the user's site then you should specify the access type for the user site:

  • Allow sharing to authenticated guest users with invitations.

  • Allow sharing with anonymous guest links and authenticated users.

  • Only allow sharing with existing guest users in the directory. 

Secondary Site Collections Admins

Add Secondary Site Collection Admins

 

Set to Yes to add secondary site collection admins. Site Collection Admins manage users content and users activity.

 

Administrator account(s)

 

It is possible to specify one or more administrator accounts - for this specify UserPrincipalName (s), separated by ";".

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.

© Copyright 2013-2026 Cayosoft Inc. All rights reserved.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Return to top

Related articles

Comments

0 comments

Please sign in to leave a comment.