Add ClearGroupId parameter to Set-PnPSite and Set-PnPTenantSite cmdlets to remove assigned Microsoft 365 group ID (#5192)

* Add ClearGroupId parameter to Set-PnPSite and Set-PnPTenantSite cmdlets to remove assigned Microsoft 365 group ID

* Add support for -ClearGroupId parameter in Set-PnPSite and Set-PnPTenantSite cmdlets

Author: gautamdsheth

CHANGELOG.md

@@ -25,6 +25,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
 - Added `Import-PnPFlow` cmdlet to import Power Automate in the tenant. [#4854](https://github.com/pnp/powershell/pull/4854)
 - Marked `-Force` as obsolete within Enable-PnPFeature cmdlet . [#5146](https://github.com/pnp/powershell/pull/5146)
 - Added `Remove-PnPPowerAppPermission` cmdlet to remove Power Apps permissions. [#5168](https://github.com/pnp/powershell/pull/5168)
+- Added support for `-ClearGroupId` parameter in `Set-PnPSite` and `Set-PnPTenantSite` cmdlets. [#5192](https://github.com/pnp/powershell/pull/5192)
 
 ### Changed
 - Improved `Get-PnPTerm` cmdlet to show a better error message. [#4933](https://github.com/pnp/powershell/pull/4933)

documentation/Set-PnPSite.md

@@ -52,6 +52,7 @@ Set-PnPSite
  [-ListsShowHeaderAndNavigation <Boolean>]
  [-RestrictContentOrgWideSearch <Boolean>]
  [-CanSyncHubSitePermissions <SwitchParameter>]
+ [-ClearGroupId]
  [-HidePeoplePreviewingFiles <Boolean>]
  [-HidePeopleWhoHaveListsOpen <Boolean>]
  [-RestrictedAccessControl <Boolean>]
@@ -693,6 +694,20 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ClearGroupId
+This parameter allows you to remove the assigned Microsoft 365 group ID on a site, when the group is permanently deleted.
+
+```yaml
+Type: Switch Parameter
+Parameter Sets: Set Properties
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -Wait
 Wait for the operation to complete
 

documentation/Set-PnPTenantSite.md

@@ -46,6 +46,7 @@ Set-PnPTenantSite [-Identity] <String> [-Title <String>] [-LocaleId <UInt32>] [-
  [-RestrictedAccessControl <Boolean>] [-ClearRestrictedAccessControl <SwitchParameter>] [-RestrictedAccessControlGroups <Guid[]>]
  [-AddRestrictedAccessControlGroups <Guid[]>] [-RemoveRestrictedAccessControlGroups <Guid[]>][-InheritVersionPolicyFromTenant <SwitchParameter>]
  [-AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled <Boolean>]
+ [-ClearGroupId]
  [-Wait] 
  [-Connection <PnPConnection>] 
 ```
@@ -816,6 +817,20 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ClearGroupId
+This parameter allows you to remove the assigned Microsoft 365 group ID on a site, when the group is permanently deleted.
+
+```yaml
+Type: Switch Parameter
+Parameter Sets: Set Properties
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -RemoveRestrictedAccessControlGroups
 You can remove the specified security group from restricted access control configuration. Members of the security group are no longer be able to access site content while the policy is enforced on the site. 
 

src/Commands/Admin/SetTenantSite.cs

@@ -232,6 +232,9 @@ public class SetTenantSite : PnPSharePointOnlineAdminCmdlet
         [Parameter(Mandatory = false, ParameterSetName = ParameterSet_PROPERTIES)]
         public SwitchParameter ReadOnlyForBlockDownloadPolicy;
 
+        [Parameter(Mandatory = false, ParameterSetName = ParameterSet_PROPERTIES)]
+        public SwitchParameter ClearGroupId;
+
         [Parameter(Mandatory = false)]
         public SwitchParameter Wait;
 
@@ -695,6 +698,12 @@ private void SetSiteProperties(Func<TenantOperationMessage, bool> timeoutFunctio
                 updateRequired = true;
             }
 
+            if (ParameterSpecified(nameof(ClearGroupId)))
+            {
+                props.ClearGroupId = ClearGroupId;
+                updateRequired = true;
+            }
+
             if (updateRequired)
             {
                 var op = props.Update();

src/Commands/Site/SetSite.cs

@@ -140,6 +140,9 @@ public class SetSite : PnPSharePointCmdlet
         [Parameter(Mandatory = false, ParameterSetName = ParameterSet_PROPERTIES)]
         public SwitchParameter ReadOnlyForBlockDownloadPolicy;
 
+        [Parameter(Mandatory = false, ParameterSetName = ParameterSet_PROPERTIES)]
+        public SwitchParameter ClearGroupId;
+
         [Parameter(Mandatory = false, ParameterSetName = ParameterSet_LOCKSTATE)]
         public SwitchParameter Wait;
 
@@ -458,6 +461,12 @@ protected override void ExecuteCmdlet()
                     executeQueryRequired = true;
                 }
 
+                if (ParameterSpecified(nameof(ClearGroupId)) && ClearGroupId.IsPresent)
+                {
+                    siteProperties.ClearGroupId = ClearGroupId.ToBool();
+                    executeQueryRequired = true;
+                }
+
                 if (executeQueryRequired)
                 {
                     siteProperties.Update();
@@ -515,8 +524,9 @@ private bool IsTenantProperty() =>
                 ParameterSpecified(nameof(ExcludedBlockDownloadGroupIds)) ||
                 ListsShowHeaderAndNavigation.HasValue ||
                 HidePeoplePreviewingFiles.HasValue ||
-                HidePeopleWhoHaveListsOpen.HasValue || 
-                ParameterSpecified(nameof(ExcludeBlockDownloadSharePointGroups)) || 
-                ReadOnlyForBlockDownloadPolicy.IsPresent;
+                HidePeopleWhoHaveListsOpen.HasValue ||
+                ParameterSpecified(nameof(ExcludeBlockDownloadSharePointGroups)) ||
+                ReadOnlyForBlockDownloadPolicy.IsPresent ||
+                ClearGroupId.IsPresent;
     }
 }