https://github.com/tools4everbv/helloid-task-sa-target-exchangeonline-distributiongroupcreate

Exchange Online - Distribution group create
https://github.com/tools4everbv/helloid-task-sa-target-exchangeonline-distributiongroupcreate

delegated-form exchange-online powershell product service-automation task

Last synced: about 1 month ago
JSON representation

Exchange Online - Distribution group create

• Host: GitHub
• URL: https://github.com/tools4everbv/helloid-task-sa-target-exchangeonline-distributiongroupcreate
• Owner: Tools4everBV
• Created: 2023-04-03T09:44:34.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-01-15T12:56:01.000Z (11 months ago)
• Last Synced: 2024-01-15T16:38:02.562Z (11 months ago)
• Topics: delegated-form, exchange-online, powershell, product, service-automation, task
• Language: PowerShell
• Homepage:
• Size: 70.3 KB
• Stars: 0
• Watchers: 4
• 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:

- [ ] The PowerShell EXO v3 module must be installed on the server running the Agent. [See instructions](https://learn.microsoft.com/en-us/powershell/exchange/exchange-online-powershell-v2?view=exchange-ps)

- [ ] User defined variables: `$ExchangeOnlineAdminUsername` and `$ExchangeOnlineAdminPassword` created in your HelloID portal. [See also](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

{

    "GroupIdentity": "DistributionGroup1",

    "DisplayName": "DistributionGroup1",

    "PrimarySmtpAddress": "[email protected]",

    "Alias": "DistributionGroupAlias"

}

```

> :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. [See the Microsoft Docs page](https://learn.microsoft.com/en-us/powershell/module/exchange/new-distributiongroup?view=exchange-ps)

2. Constructs a PowerShell credential object from the supplied administrative username and password

3. Connects with the credentials to the Exchange online environment by means of the `Connect-ExchangeOnline` cmdlet

4. Calls the `New-DistributionGroup` cmdlet to create the new Distribution Group

5. Disconnects from the Exchange environment by means of the `Disconnect-ExchangeOnline` cmdlet