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

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.

{
    "Name": "DistributionGroup1",
    "DisplayName": "DistributionGroup1",
    "PrimarySmtpAddress": "DistributionGroup1@mytestenvironment.dev",
    "Alias": "DistributionGroup1",
    "OU" : "testenvironment.dev/ExchangeDistributionGroups"
}

❗ 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