Add -KnowledgeAgentSelectedSitesList parameter to Set-PnPTenant cmdlet (#5091)

Author: gautamdsheth

documentation/Set-PnPTenant.md

@@ -2584,6 +2584,23 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -KnowledgeAgentSelectedSitesList
+
+Specifies a list of site collection URLs that should be selected for the tenant Knowledge Agent. Each entry must be a full site URL (for example: "https://contoso.sharepoint.com/sites/team1"). The cmdlet will resolve each URL to the corresponding site id and configure the tenant Knowledge Agent to target those sites.
+
+Note: Running `Set-PnPTenant` with `-KnowledgeAgentSelectedSitesList` will overwrite any existing configured Knowledge Agent sites in the tenant with the supplied list. To clear the configured list, pass an empty array: `-KnowledgeAgentSelectedSitesList @()`.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -AllowSensitivityLabelOnRecords
 Allows sensitivity label on records.
 

src/Commands/Admin/SetTenant.cs

@@ -531,6 +531,9 @@ public class SetTenant : PnPSharePointOnlineAdminCmdlet
         [Parameter(Mandatory = false)]
         public bool? DelayDenyAddAndCustomizePagesEnforcementOnClassicPublishingSites { private set; get; }
 
+        [Parameter(Mandatory = false)]
+        public string[] KnowledgeAgentSelectedSitesList { private set; get; }
+
         protected override void ExecuteCmdlet()
         {
             AdminContext.Load(Tenant);
@@ -1676,6 +1679,53 @@ protected override void ExecuteCmdlet()
                 Tenant.KnowledgeAgentEnabled = KnowledgeAgentEnabled.Value;
                 modified = true;
             }
+            if (KnowledgeAgentSelectedSitesList != null)
+            {
+                if (KnowledgeAgentSelectedSitesList.Length == 0)
+                {
+                    // Explicit empty array passed - clear configured Knowledge Agent sites
+                    Tenant.KnowledgeAgentSiteList = [];
+                    modified = true;
+                }
+                else
+                {
+                    // Build a GUID array by resolving each provided site URL to its SiteProperties and extracting the Id
+                    var siteIdList = new List<Guid>();
+                    var tenantForLookup = new Tenant(AdminContext);
+
+                    foreach (var siteUrl in KnowledgeAgentSelectedSitesList)
+                    {
+                        if (string.IsNullOrWhiteSpace(siteUrl))
+                        {
+                            continue;
+                        }
+
+                        try
+                        {
+                            // The GetSitePropertiesByUrl call requires the tenant admin context
+                            var siteProps = tenantForLookup.GetSitePropertiesByUrl(siteUrl, includeDetail: false);
+                            tenantForLookup.Context.Load(siteProps, sp => sp.SiteId);
+                            tenantForLookup.Context.ExecuteQueryRetry();
+                            if (siteProps != null && siteProps.SiteId != Guid.Empty)
+                            {
+                                siteIdList.Add(siteProps.SiteId);
+                            }
+                            else
+                            {
+                                LogWarning($"Unable to resolve site URL '{siteUrl}' to a site id. It will be skipped.");
+                            }
+                        }
+                        catch (Exception ex)
+                        {
+                            // Don't fail the whole cmdlet for one bad URL; log warning and continue
+                            LogWarning($"Error resolving site URL '{siteUrl}': {ex.Message}. It will be skipped.");
+                        }
+                    }
+
+                    Tenant.KnowledgeAgentSiteList = siteIdList.ToArray();
+                    modified = true;
+                }
+            }
             if (GuestSharingGroupAllowListInTenantByPrincipalIdentity != null)
             {
                 if (GuestSharingGroupAllowListInTenantByPrincipalIdentity.Length > 0)