Add -KnowledgeAgentSelectedSitesList parameter to Set-PnPTenant cmdlet

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)