Needless to say, creative naming of Groups and Team sites is a never-ending story. This guide, however, let you retrofit the name of those badly named groups.

Now, in order to perform these actions, there are some prerequisites where AzureADPreview and Teams (if you are to retrofit a Teams group) for PowerShell. These packages are installed with the following commands:

Install-Module -Name AzureADPreview
Install-Module -Name MicrosoftTeams

Connecting and retrofritting

In order to identify the groups that you desire to rename, you could type in the groups name, or E-mail. I prefer the latter for better control.
$UNIQ = Read-Host "Please type the group name/E-mail that you desire to change"

The following code will prompt you as a tenant admin to type in the new name for the group, and the domain for your alias

$NewName = Read-Host "Please type the desired name of the group"
$DomainName = Read-Host "Please type your domain, eg."

In order to clean up clutter (removal of invalid characters in the groups new E-mail), the following command create the new mail alias.

$NM = $NewPrefix + ($NewName -replace " ","" -replace '[^a-zA-Z0-9]', '')

In order to retrofit the group, the code below needs to be altered in line 2 for personalization of the note. The two last lines provides a visual outcome of the change that will happen.

$OldGroupDN = (Get-UnifiedGroup -Identity $UNIQ).DisplayName
$NewNote = (Get-UnifiedGroup -Identity "$UNIQ").Notes + "`n`n - New name by"
$NewMail = ("smtp:" + $NM + $DomainName)
$MailPool = (Get-UnifiedGroup -Identity $UNIQ).EmailAddresses + $NewMail
Write-Host "`t" $OldGroupDN "updated to" $NewName
Write-Host "`t" (Get-UnifiedGroup -Identity $UNIQ).EmailAddresses + "updated to" $NewMail

The changes will be committed to the tenant by executing the following commandline;
Set-UnifiedGroup -Identity $OldGroupDN -Alias $NM -DisplayName $NewName -Notes $NewNote -PrimarySmtpAddress ($NM + $DomainName)

Changes done to your group/teams should now be visible in your tenant – or by running the following command;
(Get-UnifiedGroup -Identity $NewName).EmailAddresses

As you may notice, the old E-mail alias is kept, while the new is set as primary SMTP, this ensures that any data or shared notes are still accessible from the old sharing and no new URLs are needed. Hence the outcome in PowerShell should look something like this;


  • Alex

Leave a Reply

  Category: Windows

7 posts
March 27th, 2018

Guide: Retrofit your Office 365 groups- and Teams name

Needless to say, creative naming of Groups and Team sites is a never-ending story. This guide, however, let you retrofit the name of those badly named groups

September 1st, 2017

CB or CBB for your clients?

Patch management is more important than ever and sometimes you might end up with questions like “what is the difference between CB and CBB – and how many days should I defer?”

August 10th, 2017

Say hello to the new PowerShell Module Browser

Ever since I started scripting and programming, features like “Get-Help” and javadoc have been my lifesaver – now I welcome a new tool: PowerShell Module Browser

July 12th, 2017

Meet me at TechDays Stockholm

I am honored to be invited to TechDays as a speaker for the third time. For those of you who […]

January 27th, 2017

Use PowerShell to generate driver- and batteryreport

Every now and then I get these questions regarding power management, sluggish performance in general. As a cheat-sheet, I’ve come up with this PowerShell script that gives you all you need in one run

May 22nd, 2016

Device management and troubleshooting DIY-style

In a changing IT landscape where we move from managed devices to more or less unmanaged dittos the need for self-healing systems and smart shortcuts are ever increasing.

February 1st, 2016

Microsoft Surface Deployment Accelerator now supporting Windows 10

A new version of Microsoft Surface Deployment Accelerator is now released from Microsoft. Version 1.9 now supports Window 10

February 12th, 2015

How-to: Fix PowerShell window on Surface

Have you ever tried to open PowerShell on a high-resolution, small-screen device? This is how you make the font readable.

June 30th, 2014

Changes to “Windows update” announced

Microsoft recently announced a update, focusing on protection for customers that further enhances the security of Windows Update / Microsoft Update (WU/MU) Client

February 3rd, 2014

Guide: The missing touch keyboard

Portable and touch devices using Windows 8 features a pop-up on-screen touch keyboard. This is how you add or fix the desktop shortcut