Before using this snippet, verify you've met with the following requirements:
- AzureAD app registration
- The correct app permissions for the app registration
- User defined variables:
AADTenantID
,AADAppID
andAADAppSecret
created in your HelloID portal. - Please see our documentation on how to create custom variables: (https://docs.helloid.com/en/variables/custom-variables.html)
This code snippet executes the following tasks:
- Define a hash table
$formObject
. The keys of the hash table represent the properties of the `` 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.
{
"displayName": "Finance",
"description": "Group for finance",
"mailNickname": "Finance",
"mailEnabled": false,
"securityEnabled": true
}
โ 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
-
Receive a bearer token by making a POST request to:
https://login.microsoftonline.com/$AADTenantID/oauth2/token
, where$AADTenantID
is the ID of your Azure Active Directory tenant. -
Create a new group using the:
Invoke-RestMethod
cmdlet. The hash table called:$formObject
is passed to the body of the:Invoke-RestMethod
cmdlet as a JSON object.