Office 365 Users | Assign Teams Policy
Rule description
This rule queries the specified Microsoft 365 user scope and assigns Microsoft Teams policies to each user that satisfies query criteria in Microsoft Teams.
When to use this rule
NOTE: Before using this rule in the Cayosoft Administrator Console, navigate to Configuration > Connected Systems Extensions > Microsoft 365 and set Connect to Microsoft Teams to Yes.
Use this rule when you need to perform bulk Teams policy assignment to Microsoft 365 users.
Rule settings
Query section
| Setting name | Description |
|---|---|
Account Status |
Select account state:
|
Filter |
To hide unwanted data returned by the query, select the filtering conditions. {$_.Licenses.AccountSkuId -match "STANDARDPACK"}
|
Filter AD query results |
To hide unwanted data based on criteria, not supported by the Active Directory query, set the filtering conditions here. Example: filter by the found object Distinguished Name. TIP: For optimal performance, use Query criteria above to filter objects whenever possible. |
Query Filters | |
Display Name/E-mail starts with |
Specify the first letters of the Name or Email attributes. |
|
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
|
Sort by |
Sort result objects list. |
Limit query for Office 365 |
Specify integer value. By default, all objects that you have in Microsoft Office 365 are returned. Tip: It is possible to change the default value in Microsoft Office 365 extension settings. |
Action section
| Setting name | Description |
|---|---|
|
Specify the values for the Teams policies. These policies are the same as in the Microsoft Teams admin center.
|
More Options | |
Wait for Microsoft account creation (minutes) |
This setting is applied only when this rule is used as a post rule for New user web action. |
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.
|
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.