Introduction
Azure AD PowerShell is an incredibly useful tool for management. V2 was released as GA (general availability) in Dec 2016.
This means that you could begin to utilize the new cmdlets in your production environment. There is currently not dual functionality from the V1 MSOL cmdlets so both will still need to be used as V2 continues to develop. There is also a preview set of cmdlets that you can download and use that has some extended features beyond just V2. The V1 module will begin to be deprecated as V2 continues to advance. I would recommend working with V2 when possible and only going back to V1 as needed.
I won’t be going through all of the differences between these versions but will be shedding some light on the differences for Office 365 Group management from V1 to now. This is a follow up to my original post: Managing Office 365 Group Creation via Azure AD.
Links:
- Azure AD PowerShell V1
- Azure AD PowerShell V2
- Azure AD PowerShell V2 – Preview
- when writing this its 2.0.0.52
- Updated to support 2.0.0.85
Licensing
Microsoft has made changes to the licensing for Office 365 Groups capabilities and the required Azure AD licensing to be able to use them. This is highlighted in the ‘Feature availability and licensing section’ of the following article: Learn about Office 365 Groups
Quick V1 vs. V2 Examples
The big difference from V1 to V2 is that the majority of cmdlets that used *-MSOL* cmdlets are now *-AzureAD*. The full list of cmdlets can be found through the links above.
To connect using V1 you would use:
Connect-MsolService
V2 you now use:
Connect-AzureAD
To get a user in V1 you would use:
Get-MSOLUser
V2 you now use:
Get-AzureADUser
Managing Groups using Azure AD PowerShell V2
To perform Group management you will need to use the V2 Preview cmdlets (download above) until they are rolled into V2. The same Office 365 groups settings in Azure AD PowerShell available in V1 are currently not available in V2. Hopefully when that happens they won’t change much from when I am writing this.
The primary cmdlets utilized in V1:
Get-MsolAllSettings Get-MsolAllSettingTemplate New-MsolSettings Set-MsolSettings Remove-MsolSettings
Their comparison in V2:
Get-AzureADDirectorySetting Get-AzureADDirectorySettingTemplate New-AzureADDirectorySetting Set-AzureADDirectorySetting Remove-AzureADDirectorySetting
The way that these are updated are also different. That means you can not simply replace “MsolAllSettings” with “AzureADDirectorySetting” in your scripts. There are different parameters that you need to pass and functions not available.
You can currently see these values but not all can bet set. Please ensure you review Microsoft’s latest supported parameters as these are updated frequently.
Name : ClassificationDescriptions
Description : A comma-delimited list of structured strings describing the classification values in the ClassificationList. The structure of the string is: Value: Description
Name : DefaultClassification
Description : The classification value to be used by default for Unified Group creation.
Name : PrefixSuffixNamingRequirement
Description : A structured string describing how a Unified Group displayName and mailNickname should be structured. Please refer to docs to discover how to structure a valid requirement.
Name : AllowGuestsToBeGroupOwner
Description : Flag indicating if guests are allowed to be owner in any Unified Group.
Name : AllowGuestsToAccessGroups
Description : Flag indicating if guests are allowed to access any Unified Group resources.
Name : GuestUsageGuidelinesUrl
Description : A link to the Group Usage Guidelines for guests.
Name : GroupCreationAllowedGroupId
Description : Guid of the security group that is always allowed to create Unified Groups.
Name : AllowToAddGuests
Description : Flag indicating if guests are allowed in any Unified Group.
Name : UsageGuidelinesUrl
Description : A link to the Group Usage Guidelines.
Name : ClassificationList
Description : A comma-delimited list of valid classification values that can be applied to Unified Groups.
Name : EnableGroupCreation
Description : Flag indicating if group creation feature is on.
Steps to Create new Directory Settings for Groups template
There are multiple templates that are part of your Azure AD tenant. This template can contain a settings object which has a collection of values. Within these values are where we can set the parameters above. This needs to be done before you can set any values. If you already have this you can move to the section below.
1 – Connect to Azure AD via PowerShell
Connect-AzureAD
2 – Review if you have any settings currently configured in your tenant
Get-AzureADDirectorySetting | ForEach Values
3a – If you have directory settings returned it will look like this (properties subject to change over time)
3b – If you have NO settings returned it will look like this and new directory settings will need to be created
Run this command to create the new directory settings
$template = Get-AzureADDirectorySettingTemplate | where-object {$_.displayname -eq “Group.Unified”}
$setting = $template.CreateDirectorySetting()
New-AzureADDirectorySetting -DirectorySetting $setting
4 – Review your updated settings; you can now see the default values for the directory settings object created for the Groups template
Get-AzureADDirectorySetting | ForEach Values
Steps to set Group Settings
1 – Connect to Azure AD via PowerShell
Connect-AzureAD
2 – Review if you have any settings currently configured in your tenant
Get-AzureADDirectorySetting | ForEach Values
3a – If you have directory settings returned it will look like this (properties subject to change over time)
3b – If you have NO settings returned it will look like this and new directory settings will need to be created and follow the steps above
4 – Examples of Group settings
All settings below will use the Get-AzureADDirectorySetting cmdlet and store that in a variable and then use the Set-AzureADDirectorySetting cmdlet with the updated settings. The full command to run a setting update is:
$settings = Get-AzureADDirectorySetting | where-object {$_.displayname -eq “Group.Unified”}
$settings["SETTING NAME"] = ""
Set-AzureADDirectorySetting -Id $settings.Id -DirectorySetting $settings
I will walk through some of the common scenarios and how to configure the settings parameters. If you run any of the
Restricting Group Creation for all except users in a specific group
Enter the group you want to use in the “ENTER..” section.
$group = Get-AzureADGroup -All $True | Where-Object {$_.DisplayName -eq “ENTER GROUP DISPLAY NAME HERE”}
$settings = Get-AzureADDirectorySetting | where-object {$_.displayname -eq “Group.Unified”}
$settings["EnableGroupCreation"] = "false"
$settings["GroupCreationAllowedGroupId"] = $group.ObjectId
Set-AzureADDirectorySetting -Id $settings.Id -DirectorySetting $settings
Setting Group classification
Use comma delimited values for the classifications.
$settings = Get-AzureADDirectorySetting | where-object {$_.displayname -eq “Group.Unified”}
$settings["ClassificationList"] = "Internal,External,Confidential"
Set-AzureADDirectorySetting -Id $settings.Id -DirectorySetting $settings
Setting Guidelines URL
Enter a valid URL to a page or document that holds your guidelines.
$settings = Get-AzureADDirectorySetting | where-object {$_.displayname -eq “Group.Unified”}
$settings["UsageGuidelinesUrl"] = "https://domain.sharepoint.com/sites/intranet/Pages/Groups-Usage-Guidelines.aspx"
Set-AzureADDirectorySetting -Id $settings.Id -DirectorySetting $settings
Restrict all access for guest users to Groups including ones that were already granted access
$settings = Get-AzureADDirectorySetting | where-object {$_.displayname -eq “Group.Unified”}
$settings["AllowGuestsToAccessGroups"] = "False"
Set-AzureADDirectorySetting -Id $settings.Id -DirectorySetting $settings
Restrict the ability to add any new guest users but not restrict existing
$settings = Get-AzureADDirectorySetting | where-object {$_.displayname -eq “Group.Unified”}
$settings["AllowToAddGuests"] = "False"
$settings["AllowGuestsToAccessGroups"] = "True"
Set-AzureADDirectorySetting -Id $settings.Id -DirectorySetting $settings
Setting all Group settings
With some examples.
$group = Get-AzureADGroup -All $True | Where-Object {$_.DisplayName -eq “ENTER GROUP DISPLAY NAME HERE WHO WILL HAVE ACCESS TO CREATE GROUPS”}
$settings = Get-AzureADDirectorySetting | where-object {$_.displayname -eq “Group.Unified”}
$settings["ClassificationDescriptions"] = "Internal:This is internal only,External:External users can access,Confidential:Highly secure"
$settings["DefaultClassification"] = "Confidential"
$settings["PrefixSuffixNamingRequirement"] = "ogrp-"
$settings["AllowGuestsToBeGroupOwner"] = "false"
$settings["AllowGuestsToAccessGroups"] = "true"
$settings["GuestUsageGuidelinesUrl"] = "https://domain.sharepoint.com/sites/intranet/Pages/Groups-Guest-Usage-Guidelines.aspx"
$settings["GroupCreationAllowedGroupId"] = $group.ObjectId
$settings["AllowToAddGuests"] = "true"
$settings["UsageGuidelinesUrl"] = "https://domain.sharepoint.com/sites/intranet/Pages/Groups-Usage-Guidelines.aspx"
$settings["ClassificationList"] = "Internal,External,Confidential"
$settings["EnableGroupCreation"] = "true"
Set-AzureADDirectorySetting -Id $settings.Id -DirectorySetting $settings
5 – Review your updated settings
Get-AzureADDirectorySetting | ForEach Values
Steps to remove Group Settings
1 – Connect to Azure AD via PowerShell
Connect-AzureAD
2 – Remove your directory settings, follow the steps above to create new
$settings = Get-AzureADDirectorySetting | where-object {$_.displayname -eq “Group.Unified”}
Remove-AzureADDirectorySetting -Id$settings.Id
More Scripts
All of these Office 365 Group scripts for V2 can be found on Github. Large thanks to Tony Redmond, Santhosh Balakrishnan, and Juan Carlos Martin for their work they have already done and multiple supporting scripts. The scripts from this post are under the file: DrewO365GroupsScripts – Azure AD Cmdlets
Please feel free to contribute!