https://github.com/tools4everbv/helloid-task-sa-target-exchangeonpremises-distributiongroupcreate
Exchange On Premises - Distribution Group create
https://github.com/tools4everbv/helloid-task-sa-target-exchangeonpremises-distributiongroupcreate
delegated-form exchange-on-premises powershell product service-automation task
Last synced: over 1 year ago
JSON representation
Exchange On Premises - Distribution Group create
- Host: GitHub
- URL: https://github.com/tools4everbv/helloid-task-sa-target-exchangeonpremises-distributiongroupcreate
- Owner: Tools4everBV
- Created: 2023-10-05T09:34:02.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-15T12:54:27.000Z (over 2 years ago)
- Last Synced: 2025-01-08T10:45:36.046Z (over 1 year ago)
- Topics: delegated-form, exchange-on-premises, powershell, product, service-automation, task
- Language: PowerShell
- Homepage:
- Size: 81.1 KB
- Stars: 0
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# HelloID-Task-SA-Target-ExchangeOnline-DistributionGroupCreate
## Prerequisites
Before using this snippet, verify you've met with the following requirements:
- [ ] User defined variables: `$ExchangeAdminUsername`, `$ExchangeAdminPassword` and `$ExchangeConnectionUri` created in your HelloID portal. [See also Custom Variables](https://docs.helloid.com/en/variables/custom-variables.html)
## Description
This code snippet executes the following tasks:
1. Define a hash table `$formObject`. The keys of the hash table represent the properties of the `New-DistributionGroup` cmdlet, while the values represent the values entered in the form.
> To view an example of the form output, please refer to the JSON code pasted below.
```json
{
"Name": "DistributionGroup1",
"DisplayName": "DistributionGroup1",
"PrimarySmtpAddress": "DistributionGroup1@mytestenvironment.dev",
"Alias": "DistributionGroup1",
"OU" : "testenvironment.dev/ExchangeDistributionGroups"
}
```
> :exclamation: It is important to note that the names of your form fields might differ. Ensure that the `$formObject` hashtable is appropriately adjusted to match your form fields.
2. Constructs a PowerShell credential object from the supplied administrative username and password
3. Connects with the credentials to the Exchange on premises environment by means of the `New-PSSession` cmdlet
4. Calls the `New-DistributionGroup` cmdlet to create the new Distribution Group
5. Disconnects from the Exchange session by means of the `Remove-PsSession` cmdlet