https://github.com/tools4everbv/helloid-conn-sa-full-ad-reportgroupsmailenabled
Active Directory - List groups with an email address
https://github.com/tools4everbv/helloid-conn-sa-full-ad-reportgroupsmailenabled
active-directory delegated-form import powershell reporting service-automation
Last synced: about 1 year ago
JSON representation
Active Directory - List groups with an email address
- Host: GitHub
- URL: https://github.com/tools4everbv/helloid-conn-sa-full-ad-reportgroupsmailenabled
- Owner: Tools4everBV
- Created: 2020-11-02T13:40:56.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2022-09-12T13:39:25.000Z (over 3 years ago)
- Last Synced: 2025-01-08T10:45:46.616Z (about 1 year ago)
- Topics: active-directory, delegated-form, import, powershell, reporting, service-automation
- Language: PowerShell
- Homepage:
- Size: 34.2 KB
- Stars: 0
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Description
This HelloID Service Automation Delegated Form provides an Active Directory report containing the Group objects that have an email address. The following options are available:
1. Overview of AD Group objects that match this report
2. Export data to a local CSV file on the HelloID Agent server (optional)
## Versioning
| Version | Description | Date |
| - | - | - |
| 1.0.2 | Added version number and updated code for SA-agent and auditlogging | 2022/08/03 |
| 1.0.1 | Added version number and updated all-in-one script | 2021/11/03 |
| 1.0.0 | Initial release | 2020/11/24 |
## Table of Contents
* [Description](#description)
* [All-in-one PowerShell setup script](#all-in-one-powershell-setup-script)
* [Getting started](#getting-started)
* [Post-setup configuration](#post-setup-configuration)
* [Manual resources](#manual-resources)
* [Getting help](#getting-help)
## All-in-one PowerShell setup script
The PowerShell script "createform.ps1" contains a complete PowerShell script using the HelloID API to create the complete Form including user defined variables, tasks and data sources.
_Please note that this script asumes none of the required resources do exists within HelloID. The script does not contain versioning or source control_
### Getting started
Please follow the documentation steps on [HelloID Docs](https://docs.helloid.com/hc/en-us/articles/360017556559-Service-automation-GitHub-resources) in order to setup and run the All-in one Powershell Script in your own environment.
## Post-setup configuration
After the all-in-one PowerShell script has run and created all the required resources. The following items need to be configured according to your own environment
1. Update the following [user defined variables](https://docs.helloid.com/hc/en-us/articles/360014169933-How-to-Create-and-Manage-User-Defined-Variables)
Variable nameExample valueDescription
HIDreportFolderC:\HIDreports\Local folder on HelloID Agent server for exporting CSV reports
ADGroupReportOU[{ "OU": "OU=HelloIDCreated,OU=Groups,OU=Enyoi,DC=enyoi-media,DC=local"}]Array of Active Directory OUs for scoping shown AD Group objects in this report
## Manual resources
This Delegated Form uses the following resources in order to run
### Powershell data source 'AD-group-generate-table-report-mail-enabled'
This Powershell data source runs an Active Directory query to select the AD goups that match this report. It uses an array of Active Directory OU's specified as HelloID user defined variable named _"ADGroupReportOU"_ to specify the report scoping.
### Delegated form task 'AD - Report - Groups with email enabled'
This delegated form task runs the same Active Directory query as the task data source (AD query is defined at two places) and export the data to a local CSV file if selected in the form.
## Getting help
_If you need help, feel free to ask questions on our [forum](https://forum.helloid.com/forum/helloid-connectors/service-automation/515-helloid-sa-active-directory-report-ad-groups-with-an-email-address)_
## HelloID Docs
The official HelloID documentation can be found at: https://docs.helloid.com/