(PowerShell) Create Group

Create a new group as specified in the request body. You can create one of three types of groups:

• Office 365 Group (unified group)
• Dynamic group
• Security group

This operation returns by default only a subset of the properties for each group. These default properties are noted in the Properties section.

See https://docs.microsoft.com/en-us/graph/api/group-post-groups?view=graph-rest-1.0 for more information.

Chilkat .NET Downloads Chilkat .NET Assemblies

Add-Type -Path "C:\chilkat\ChilkatDotNet47-9.5.0-x64\ChilkatDotNet47.dll"

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

$http = New-Object Chilkat.Http

# Use your previously obtained access token as shown here:
#    Get Microsoft Graph OAuth2 Access Token with Group.ReadWrite.All scope.

$jsonToken = New-Object Chilkat.JsonObject
$success = $jsonToken.LoadFile("qa_data/tokens/msGraphGroup.json")
if ($success -eq $false) {
    $($jsonToken.LastErrorText)
    exit
}

$http.AuthToken = $jsonToken.StringOf("access_token")

# Create a JSON body for the HTTP POST
# Use this online tool to generate the code from sample JSON: 
# Generate Code to Create JSON

# {
#   "description": "Self help community for library",
#   "displayName": "Library Assist",
#   "groupTypes": [
#     "Unified"
#   ],
#   "mailEnabled": true,
#   "mailNickname": "library",
#   "securityEnabled": false
# }

$json = New-Object Chilkat.JsonObject
$json.UpdateString("description","Self help community for library")
$json.UpdateString("displayName","Library Assist")
$json.UpdateString("groupTypes[0]","Unified")
$json.UpdateBool("mailEnabled",$true)
$json.UpdateString("mailNickname","library")
$json.UpdateBool("securityEnabled",$false)

# POST the JSON to https://graph.microsoft.com/v1.0/groups

$resp = $http.PostJson3("https://graph.microsoft.com/v1.0/groups","application/json",$json)
if ($http.LastMethodSuccess -eq $false) {
    $($http.LastErrorText)
    exit
}

$json.Load($resp.BodyStr)
$json.EmitCompact = $false

if ($resp.StatusCode -ne 201) {
    $($json.Emit())
    $("Failed, response status code = " + $resp.StatusCode)

    exit
}

$($json.Emit())

# A sample response:
# (See code for parsing this response below..)

# {
#     "id": "b320ee12-b1cd-4cca-b648-a437be61c5cd",
# 	  "deletedDateTime": null,
# 	  "classification": null,
# 	  "createdDateTime": "2018-12-22T00:51:37Z",
# 	  "creationOptions": [],
# 	  "description": "Self help community for library",
# 	  "displayName": "Library Assist",
# 	  "groupTypes": [
# 	      "Unified"
# 	  ],
# 	  "mail": "library7423@contoso.com",
# 	  "mailEnabled": true,
# 	  "mailNickname": "library",
# 	  "onPremisesLastSyncDateTime": null,
# 	  "onPremisesSecurityIdentifier": null,
# 	  "onPremisesSyncEnabled": null,
# 	  "preferredDataLocation": "CAN",
# 	  "proxyAddresses": [
# 	      "SMTP:library7423@contoso.com"
# 	  ],
# 	  "renewedDateTime": "2018-12-22T00:51:37Z",
# 	  "resourceBehaviorOptions": [],
# 	  "resourceProvisioningOptions": [],
# 	  "securityEnabled": false,
# 	  "visibility": "Public",
# 	  "onPremisesProvisioningErrors": []
# }

# Use this online tool to generate parsing code from sample JSON: 
# Generate Parsing Code from JSON

$id = $json.StringOf("id")
$deletedDateTime = $json.StringOf("deletedDateTime")
$classification = $json.StringOf("classification")
$createdDateTime = $json.StringOf("createdDateTime")
$description = $json.StringOf("description")
$displayName = $json.StringOf("displayName")
$mail = $json.StringOf("mail")
$mailEnabled = $json.BoolOf("mailEnabled")
$mailNickname = $json.StringOf("mailNickname")
$onPremisesLastSyncDateTime = $json.StringOf("onPremisesLastSyncDateTime")
$onPremisesSecurityIdentifier = $json.StringOf("onPremisesSecurityIdentifier")
$onPremisesSyncEnabled = $json.StringOf("onPremisesSyncEnabled")
$preferredDataLocation = $json.StringOf("preferredDataLocation")
$renewedDateTime = $json.StringOf("renewedDateTime")
$securityEnabled = $json.BoolOf("securityEnabled")
$visibility = $json.StringOf("visibility")
$i = 0
$count_i = $json.SizeOfArray("creationOptions")
while ($i -lt $count_i) {
    $json.I = $i
    $i = $i + 1
}

$i = 0
$count_i = $json.SizeOfArray("groupTypes")
while ($i -lt $count_i) {
    $json.I = $i
    $strVal = $json.StringOf("groupTypes[i]")
    $i = $i + 1
}

$i = 0
$count_i = $json.SizeOfArray("proxyAddresses")
while ($i -lt $count_i) {
    $json.I = $i
    $strVal = $json.StringOf("proxyAddresses[i]")
    $i = $i + 1
}

$i = 0
$count_i = $json.SizeOfArray("resourceBehaviorOptions")
while ($i -lt $count_i) {
    $json.I = $i
    # ...
    $i = $i + 1
}

$i = 0
$count_i = $json.SizeOfArray("resourceProvisioningOptions")
while ($i -lt $count_i) {
    $json.I = $i
    # ...
    $i = $i + 1
}

$i = 0
$count_i = $json.SizeOfArray("onPremisesProvisioningErrors")
while ($i -lt $count_i) {
    $json.I = $i
    # ...
    $i = $i + 1
}

$("Success.")