https://github.com/tools4everbv/helloid-conn-sa-full-ad-groupcreate
Active Directory - Group create
https://github.com/tools4everbv/helloid-conn-sa-full-ad-groupcreate
active-directory delegated-form groupmanagement import powershell service-automation
Last synced: about 1 year ago
JSON representation
Active Directory - Group create
- Host: GitHub
- URL: https://github.com/tools4everbv/helloid-conn-sa-full-ad-groupcreate
- Owner: Tools4everBV
- Created: 2020-09-07T13:13:41.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2023-08-21T14:42:02.000Z (almost 3 years ago)
- Last Synced: 2025-02-25T22:13:40.478Z (over 1 year ago)
- Topics: active-directory, delegated-form, groupmanagement, import, powershell, service-automation
- Language: PowerShell
- Homepage:
- Size: 59.6 KB
- Stars: 0
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Description
This HelloID Service Automation Delegated Form provides AD group creation functionality. The following options are available:
1. Enter group name, description and group type and scope
2. Enter group emailaddress is available for distribution groups
3. Select the manager (AD user account) of the new group
4. Available group name and emailaddress ar show based on configured naming convention and a lookup in Active Directory
5. New AD group is created after confirmation
## Versioning
| Version | Description | Date |
| - | - | - |
| 1.0.1 | Added version number and updated all-in-one script | 2021/11/03 |
| 1.0.0 | Initial release | 2020/09/07 |
## 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
ADusersSearchOU[{ "OU": "OU=Disabled Users,OU=HelloID Training,DC=veeken,DC=local"},{ "OU": "OU=Users,OU=HelloID Training,DC=veeken,DC=local"},{"OU": "OU=External,OU=HelloID Training,DC=veeken,DC=local"}]Array of Active Directory OUs for scoping AD user accounts as manager of the new AD group
ADgroupsCreateOUOU=Groups,OU=HelloID Training,DC=veeken,DC=localString value of Active Directory OU to create new AD groups
## Manual resources
This Delegated Form uses the following resources in order to run
### Powershell data source 'AD-user-generate-table-groupmanagers-create-group'
This Powershell data source runs an Active Directory query to search for "manager" AD user accounts. It uses an array of Active Directory OU's specified as HelloID user defined variable named _"ADusersSearchOU"_ to specify the search scope. It uses an optional input called _"selectedGroup"_ to default select the current group manager in the returned data
### Powershell data source 'AD-group-create-check-names'
This Powershell data source runs an Active Directory query to return the available group name and email address based on the configured naming convention.
### Delegated form task 'AD-group-create'
This delegated form task will create the configured new AD group.
## Getting help
_If you need help, feel free to ask questions on our [forum](https://forum.helloid.com/forum/helloid-connectors/service-automation/510-helloid-sa-active-directory-ad-group-create)_
## HelloID Docs
The official HelloID documentation can be found at: https://docs.helloid.com/