Text File | Add Microsoft 365 Contacts to Distribution Groups
Rule description
This rule queries the specified CSV file containing a list of Microsoft 365 contacts and adds them as distribution group members according to the Action section settings.
NOTE: CSV-file should be in UTF-8 format in case of using letters with an accent: á, ä, é, í, ö, ü and etc.
When to use this rule
Use this rule when you need to add Active Directory or Microsoft 365 contacts that are defined in the CSV file to Azure Distribution Groups.
This rule requires a source text file in the comma-separated variable format (CSV). You can use the template CSV files provided with the rule, or create a file in Microsoft Excel and export it as CSV.
Rule settings
Query section
| Setting name | Description |
|---|---|
Select data source |
Specify the text file to be imported. The […] (three dots) button allows the user to browse for the file and the Create/Edit button allows the creation or editing of the existing file in the built-in Data Source editor. |
Data source anchor attribute |
Select a column in the data source that contains the attribute value for identifying and mapping a computer. |
More Options | |
Filter CSV data |
This setting specifies the filter that can remove data rows from the imported text file that satisfies the specific condition. |
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. |
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 |
|---|---|
| Target groups selection mode |
One of these values is possible:
|
| Action |
Specify one of these actions:
|
| Group names | Specify group names separated by ';' or click '...' to select from the cloud. |
| Dynamic Mapping from File Settings | |
| Data source |
This setting specifies the text file for import. The […] button allows the user to browse for the file and the Create button allows creation or editing of the file in the data source editor. |
| Separator used in file | Specify the separator used in the source CSV file. |
| Azure Active Directory anchor attribute | Specify cloud object attribute. For each object returned by the query, the selected attribute value will be used to map the object with the selected data source anchor. |
| CSV anchor match column | Select the CSV column that contains the values that will be matched to the AD anchor attribute values. |
| Azure AD group column | Select the CSV file column containing the Azure AD group name if using a dynamic mapping file. |
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.