https://github.com/tools4everbv/helloid-task-sa-target-exchangeonline-mailcontactcreate
Exchange Online - Mail contact create
https://github.com/tools4everbv/helloid-task-sa-target-exchangeonline-mailcontactcreate
delegated-form exchange-online powershell product service-automation task
Last synced: 21 days ago
JSON representation
Exchange Online - Mail contact create
- Host: GitHub
- URL: https://github.com/tools4everbv/helloid-task-sa-target-exchangeonline-mailcontactcreate
- Owner: Tools4everBV
- Created: 2023-03-30T11:19:49.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-01-15T13:24:13.000Z (over 2 years ago)
- Last Synced: 2025-02-25T22:13:02.656Z (over 1 year ago)
- Topics: delegated-form, exchange-online, powershell, product, service-automation, task
- Language: PowerShell
- Homepage:
- Size: 68.4 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-MailContactCreate
## 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 [Exchange-online-powershell-v2](https://learn.microsoft.com/en-us/powershell/exchange/exchange-online-powershell-v2?view=exchange-ps) for instructions
- [ ] User defined variables: `ExchangeOnlineAdminUsername` and `$ExchangeOnlineAdminPassword` 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 room mailbox to be created, 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" : "James Doe",
"DisplayName": "Jamie Doe",
"FirstName": "James",
"Initials": "J.E.",
"LastName": "Doe",
"Alias": "jedoe",
"ExternalEmailAddress": "Jdoe@mytest.local"
}
```
> :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-mailcontact?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-MailContact` cmdlet to create the new mail contact.
5. Disconnects from the Exchange environment by means of the `Disconnect-ExchangeOnline` cmdlet