Creating Common Azure AD Groups for Intune – Scripted

I often find myself having to create the same selection of Azure AD groups when deploying a new Intune environment and whilst the Azure Portal is easy to use, I always look to find a way to cut down how long each task takes. The more I can automate, the more I can get done in a day.

To that end, I have created a new PowerShell script to automate the creation of the following groups:

As always, my script is available on GitHub here or on the PS Gallery

Install-Script -Name create-intune-groups
  • Autopilot Devices (a dynamic group on the ZTID)
  • Microsoft Project Install (a dynamic group based on users who have a MS Project license for desktop apps applied to their account)
  • Microsoft Project Uninstall (those who don’t)
  • Microsoft Visio Install (a dynamic group for users who have a Visio license for desktop apps)
  • Microsoft Visio Uninstall (those who don’t)
  • Microsoft Office Install (a dynamic group for users who have O365 Enterprise Apps license)
  • Microsoft Office Uninstall (those who don’t)
  • Deployment Rings Groups – Preview Users, Pilot Users and VIP Users (Static, assigned groups)

The script can be called programmatically using a parameter (GroupName) with the options of Autopilot, Visio, Office, Project or Deployment. For example:

create-intune-apps.ps1 -GroupName Autopilot

Alternatively, if no parameter is supplied, it will popup a small GUI with buttons to create the groups:

The script uses the Azure AD Preview module which it will install if required and load upon launch.

After that, the PowerShell command New-AzureADMSGroup sorts out the group creation. As an example, for Project Users:

New-AzureADMSGroup -DisplayName "Project-Install" -Description "Dynamic group for Licensed Project Users" -MailEnabled $False -MailNickName "group" -SecurityEnabled $True -GroupTypes "DynamicMembership" -MembershipRule "(user.assignedPlans -any (assignedPlan.servicePlanId -eq ""fafd7243-e5c1-4a3a-9e40-495efcb1d3c3"" -and assignedPlan.capabilityStatus -eq ""Enabled""))" -MembershipRuleProcessingState "On"

As you can see, we are creating a Security Group (non mail-enabled) with the dynamic membership rule applied which queries the users servicePlanId.

If you are creating these manually, make sure the capabilityStatus is set to Enabled. Once a user has a license assigned, that serviceplan remains in place throughout and the status switches to Disabled. If you miss off that part of the query, removing a license will not remove them from the group (I found this out the hard way!)

Hope you find this useful.

Posted in AzureIntune