PowerShell Requires Chilkat v11.0.0+

Create Group

See more Microsoft Group Examples

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.

PowerShell

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

$success = $false

#  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 = New-Object Chilkat.HttpResponse
$success = $http.HttpJson("POST","https://graph.microsoft.com/v1.0/groups",$json,"application/json",$resp)
if ($success -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.")