{"id":2995,"date":"2022-02-23T03:00:08","date_gmt":"2022-02-23T03:00:08","guid":{"rendered":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/"},"modified":"2022-02-23T03:00:08","modified_gmt":"2022-02-23T03:00:08","slug":"troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades","status":"publish","type":"post","link":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/","title":{"rendered":"Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades"},"content":{"rendered":"
\n

Microsoft 365 Groups<\/a> are great for collaboration, while also providing some distribution list (DL) capabilities. Exchange Online provides a native way to upgrade distribution lists to Microsoft 365 Group<\/a>s<\/span>; however, sometimes DLs don\u2019t upgrade as expected and in these cases, there might be no feedback provided to the admin as to why.<\/p>\n

To help customers with these types of failures, we created a PowerShell-based tool, DLT365Groupsupgrade<\/em><\/a>,<\/em> that checks the DL being upgraded for any blockers<\/a> that might cause upgrade failure.<\/p>\n

Using the DL Upgrade Troubleshooter<\/span><\/h1>\n

In this example, we\u2019re upgrading a DL called DemoDL; however, it won\u2019t upgrade, and no error is reported:<\/p>\n

\"DLupgrade01.png\"<\/span><\/p>\n

Running the tool on DemoDL shows a blocker that causes the upgrade process to fail:<\/p>\n

\"DLupgrade02.png\"<\/span><\/p>\n

The blocker is an existing email address policy (EAP). The DL\u2019s PrimarySmtpAddress is \u201c@H<\/strong><\/font>azem.exohybridlabs.com\u201d but the EnabledPrimarySMTPAddressTemplate on the EAP is \u201c@h<\/strong><\/font>azem.exohybridlabs.com.\u201d This indicates that the EAP comparison condition is case-sensitive.<\/p>\n

There are 2 ways to remove this blocker. You can re<\/a>create<\/a> the DL with the correct primary smtp address, or you can use the following steps to remove the SMTP alias containing \u201c@H<\/strong><\/font>azem.exohybridlabs.com.\u201d<\/p>\n

Connect to Exchange Online PowerShell<\/a>.<\/span><\/p>\n

Use Set-DistributionGroup<\/a> to replace the primary SMTP address with another accepted domain in your organization:<\/p>\n

Set-DistributionGroup DemoDl -PrimarySmtpAddress DemoDl@anotheraccepteddomain.com<\/a><\/p>\n

Use Get-DistributionGroup<\/a> to validate the change:<\/p>\n

Get-DistributionGroup |fl PrimarySmtpAddress,EmailAddresses<\/p>\n

Use Set-DistributionGroup to remove the wrong SMTP address for H<\/strong><\/font>azem.exohybridlabs.com:<\/p>\n

Set-DistributionGroup DemoDl -EmailAddresses @{remove=”DemoDl@Hazem.exohybridlabs.com”}<\/p>\n

Use Get-DistributionGroup to validate the change:<\/p>\n

Get-DistributionGroup |fl PrimarySmtpAddress,EmailAddresses<\/p>\n

Use Set-DistributionGroup to add the correct SMTP address for h<\/strong><\/font>azem.exohybridlabs.com:<\/p>\n

Set-DistributionGroup DemoDl -EmailAddresses @{add=”DemoDl@hazem.exohybridlabs.com”}<\/p>\n

Use Get-DistributionGroup to validate the change:<\/p>\n

Get-DistributionGroup |fl PrimarySmtpAddress,EmailAddresses<\/p>\n

Use Set-DistributionGroup to set the DL\u2019s PrimarySmtpAddress with a domain value of h<\/strong><\/font>azem.exohybridlabs.com:<\/p>\n

Set-DistributionGroup DemoDl -PrimarySmtpAddress “DemoDl@hazem.exohybridlabs.com” -WindowsEmailAddress “DemoDL@hazem.exohybridlabs.com”<\/p>\n

Optionally use Set-DistributionGroup to remove the DL\u2019s secondary alias (if added):<\/p>\n

Set-DistributionGroup DemoDl -EmailAddresses @{remove=”DemoDl@anotheraccepteddomain.com”}<\/p>\n

After making these changes, the DL upgrade will now succeed.<\/p>\n

In this next example, we are trying to upgrade DemoDL3. The DL didn\u2019t upgrade, and an ambiguous error is reported. Using the tool, we can see the blocker that prevented the upgrade from succeeding.<\/p>\n

\"DLupgrade03.png\"<\/span><\/p>\n

The blocker is that unsupported DL owners were found. If a DL owner has RecipientTypeDetails other than UserMailbox or MailUser (as stated here<\/a>), the upgrade will fail.<\/p>\n

To remove this blocker, use the steps below to remove all unsupported owners:<\/p>\n

    \n
  1. \u00a0\u00a0\u00a0\u00a0 Connect to Exchange Online PowerShell<\/a>.<\/span><\/li>\n
  2. \u00a0\u00a0\u00a0\u00a0 Use Get-DistributionGroup<\/a> to retrieve the list of DL owners and use Set-DistributionGroup<\/a> to replace the recipient types:<\/li>\n<\/ol>\n

    $dl=Get-DistributionGroup DemoDL3@hazem.exohybridlabs.com<\/a>
    $dl.ManagedBy
    Set-DistributionGroup -Identity \u201cDemoDL3@hazem.exohybridlabs.com\u201d -ManagedBy \u201c<OwnerName(s)>\u201d<\/p>\n

    After making these changes, the DL upgrade will now succeed.<\/p>\n

    Special thanks to Bhalchandra Atre, Nino Bilic who reviewed and contributed to this post.<\/p>\n

    Hazem Embaby<\/span>
    Support Escalation Engineer<\/p>\n<\/div>\n

    Read full article (Microsoft Exchange Blog)<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"Microsoft 365 Groups are great for collaboration, while also providing some distribution list (DL) capabilities. Exchange Online provides…\n","protected":false},"author":2,"featured_media":2564,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"csco_singular_sidebar":"","csco_page_header_type":"","csco_appearance_grid":"","csco_page_load_nextpost":"","csco_post_video_location":[],"csco_post_video_location_hash":"","csco_post_video_url":"","csco_post_video_bg_start_time":0,"csco_post_video_bg_end_time":0,"footnotes":""},"categories":[15],"tags":[265,264,66],"coauthors":[48],"class_list":["post-2995","post","type-post","status-publish","format-standard","has-post-thumbnail","category-microsoft-exchange-server","tag-great","tag-groups","tag-microsoft","cs-entry","cs-video-wrap"],"yoast_head":"\nTroubleshooting issues with Distribution List to Microsoft 365 Group upgrades | Sebae Networks<\/title>\n<meta name=\"description\" content=\"View Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades for free, here at Sebae. Discover more great posts on our website.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/\" \/>\n<meta property=\"og:locale\" content=\"en_GB\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades | Sebae Networks\" \/>\n<meta property=\"og:description\" content=\"View Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades for free, here at Sebae. Discover more great posts on our website.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/\" \/>\n<meta property=\"og:site_name\" content=\"Sebae Networks\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/sebaenetworks\" \/>\n<meta property=\"article:published_time\" content=\"2022-02-23T03:00:08+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/techcommunity.microsoft.com\/t5\/image\/serverpage\/image-id\/350356iFC62553E020696DF\/image-size\/large?v=v2&px=999\" \/>\n<meta name=\"author\" content=\"James Dean\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@sebaenetworks\" \/>\n<meta name=\"twitter:site\" content=\"@sebaenetworks\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"James Dean\" \/>\n\t<meta name=\"twitter:label2\" content=\"Estimated reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades | Sebae Networks","description":"View Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades for free, here at Sebae. Discover more great posts on our website.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/","og_locale":"en_GB","og_type":"article","og_title":"Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades | Sebae Networks","og_description":"View Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades for free, here at Sebae. Discover more great posts on our website.","og_url":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/","og_site_name":"Sebae Networks","article_publisher":"https:\/\/www.facebook.com\/sebaenetworks","article_published_time":"2022-02-23T03:00:08+00:00","og_image":[{"url":"https:\/\/techcommunity.microsoft.com\/t5\/image\/serverpage\/image-id\/350356iFC62553E020696DF\/image-size\/large?v=v2&px=999","type":"","width":"","height":""}],"author":"James Dean","twitter_card":"summary_large_image","twitter_creator":"@sebaenetworks","twitter_site":"@sebaenetworks","twitter_misc":{"Written by":"James Dean","Estimated reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/#article","isPartOf":{"@id":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/"},"author":{"name":"James Dean","@id":"https:\/\/www.sebae.net\/blog\/#\/schema\/person\/6d07e05e3d3e4483117c4e2c3315a89f"},"headline":"Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades","datePublished":"2022-02-23T03:00:08+00:00","mainEntityOfPage":{"@id":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/"},"wordCount":510,"commentCount":0,"publisher":{"@id":"https:\/\/www.sebae.net\/blog\/#organization"},"image":{"@id":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/#primaryimage"},"thumbnailUrl":"https:\/\/www.sebae.net\/blog\/wp-content\/uploads\/2021\/11\/exchange-server-header.png","keywords":["great","Groups","Microsoft"],"articleSection":["Microsoft Exchange Server"],"inLanguage":"en-GB","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/","url":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/","name":"Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades | Sebae Networks","isPartOf":{"@id":"https:\/\/www.sebae.net\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/#primaryimage"},"image":{"@id":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/#primaryimage"},"thumbnailUrl":"https:\/\/www.sebae.net\/blog\/wp-content\/uploads\/2021\/11\/exchange-server-header.png","datePublished":"2022-02-23T03:00:08+00:00","description":"View Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades for free, here at Sebae. Discover more great posts on our website.","breadcrumb":{"@id":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/#breadcrumb"},"inLanguage":"en-GB","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/"]}]},{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/#primaryimage","url":"https:\/\/www.sebae.net\/blog\/wp-content\/uploads\/2021\/11\/exchange-server-header.png","contentUrl":"https:\/\/www.sebae.net\/blog\/wp-content\/uploads\/2021\/11\/exchange-server-header.png","width":1920,"height":1080,"caption":"exchange server header"},{"@type":"BreadcrumbList","@id":"https:\/\/www.sebae.net\/blog\/troubleshooting-issues-with-distribution-list-to-microsoft-365-group-upgrades\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.sebae.net\/blog\/"},{"@type":"ListItem","position":2,"name":"Troubleshooting issues with Distribution List to Microsoft 365 Group upgrades"}]},{"@type":"WebSite","@id":"https:\/\/www.sebae.net\/blog\/#website","url":"https:\/\/www.sebae.net\/blog\/","name":"Sebae Networks","description":"Tech Tips, News, Tutorials & Advice","publisher":{"@id":"https:\/\/www.sebae.net\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.sebae.net\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-GB"},{"@type":"Organization","@id":"https:\/\/www.sebae.net\/blog\/#organization","name":"Sebae","url":"https:\/\/www.sebae.net\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/www.sebae.net\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.sebae.net\/blog\/wp-content\/uploads\/2023\/06\/sebae-logo-icon.png","contentUrl":"https:\/\/www.sebae.net\/blog\/wp-content\/uploads\/2023\/06\/sebae-logo-icon.png","width":512,"height":512,"caption":"Sebae"},"image":{"@id":"https:\/\/www.sebae.net\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/sebaenetworks","https:\/\/x.com\/sebaenetworks"]},{"@type":"Person","@id":"https:\/\/www.sebae.net\/blog\/#\/schema\/person\/6d07e05e3d3e4483117c4e2c3315a89f","name":"James Dean","image":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/www.sebae.net\/blog\/wp-content\/uploads\/2021\/10\/avatar_user_2_1634496168-96x96.jpg72371c27260698ee55141397050ef40a","url":"https:\/\/www.sebae.net\/blog\/wp-content\/uploads\/2021\/10\/avatar_user_2_1634496168-96x96.jpg","contentUrl":"https:\/\/www.sebae.net\/blog\/wp-content\/uploads\/2021\/10\/avatar_user_2_1634496168-96x96.jpg","caption":"James Dean"},"sameAs":["https:\/\/www.sebae.net"],"url":"https:\/\/www.sebae.net\/blog\/author\/jdean\/"}]}},"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.sebae.net\/blog\/wp-json\/wp\/v2\/posts\/2995","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.sebae.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.sebae.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.sebae.net\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.sebae.net\/blog\/wp-json\/wp\/v2\/comments?post=2995"}],"version-history":[{"count":0,"href":"https:\/\/www.sebae.net\/blog\/wp-json\/wp\/v2\/posts\/2995\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.sebae.net\/blog\/wp-json\/wp\/v2\/media\/2564"}],"wp:attachment":[{"href":"https:\/\/www.sebae.net\/blog\/wp-json\/wp\/v2\/media?parent=2995"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.sebae.net\/blog\/wp-json\/wp\/v2\/categories?post=2995"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.sebae.net\/blog\/wp-json\/wp\/v2\/tags?post=2995"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.sebae.net\/blog\/wp-json\/wp\/v2\/coauthors?post=2995"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}