Skip to content

Control 1.3: Restricted SharePoint Search and Restricted Content Discovery — PowerShell Setup

Automation scripts for managing Restricted SharePoint Search (RSS) and Restricted Content Discovery (RCD) at scale.

Prerequisites

  • SharePoint Online Management Shell (Microsoft.Online.SharePoint.PowerShell)
  • SharePoint Admin role
  • Microsoft 365 Copilot license active in the tenant so the SharePoint Advanced Management capabilities used by RCD are available
  • Approved sites list in CSV format (for RSS)
  • List of sites to exclude from Copilot discovery (for RCD)

Scripts

Script 1: Enable Restricted Content Discovery (RCD) on a Site (Current Path)

# Enable RCD on a site to exclude it from Copilot discovery and organization-wide search
# RCD is the current recommended control — new RSS enablement is blocked from July 31, 2026
# Requires: SharePoint Online Management Shell

Import-Module Microsoft.Online.SharePoint.PowerShell
Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"

# Enable RCD on a single site
$siteUrl = "https://<tenant>.sharepoint.com/sites/<sensitive-site>"
Set-SPOSite -Identity $siteUrl -RestrictContentOrgWideSearch $true
Write-Host "RCD enabled for: $siteUrl" -ForegroundColor Green

# Verify the setting
$site = Get-SPOSite -Identity $siteUrl
Write-Host "RestrictContentOrgWideSearch: $($site.RestrictContentOrgWideSearch)"

Script 1b: Check Existing Restricted SharePoint Search (RSS) Status (Legacy — Existing Configurations Only)

RSS is retiring

RSS new enablement is blocked from July 31, 2026. Script 1b is for organizations checking or managing an existing RSS configuration enabled before that date.

# Check and manage existing RSS status
# Requires: SharePoint Online Management Shell

Import-Module Microsoft.Online.SharePoint.PowerShell

Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"

# Check current RSS mode
$mode = Get-SPOTenantRestrictedSearchMode
Write-Host "Restricted SharePoint Search mode: $($mode.Mode)"

# To disable RSS (after confirming RCD covers required exclusions):
# Set-SPOTenantRestrictedSearchMode -Mode Disabled

Script 1c: Monitor RCD Status Across Tenant

# Generate a tenant-wide report of sites with Restricted Content Discovery enabled
# Requires: SharePoint Online Management Shell

Import-Module Microsoft.Online.SharePoint.PowerShell
Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"

# Start the report generation (asynchronous)
Start-SPORestrictedContentDiscoverabilityReport

# Check report status
Get-SPORestrictedContentDiscoverabilityReport

# Download report when complete (replace ReportGUID with the GUID from the status output)
# Get-SPORestrictedContentDiscoverabilityReport -Action Download -ReportId "<ReportGUID>"

Script 2: Bulk Add Sites to RSS Allowed List (Legacy — Existing Configurations Only)

RSS is retiring

Script 2 applies only to organizations managing an existing RSS configuration enabled before July 31, 2026.

# Add approved sites to the RSS allowed list from CSV
# CSV format: Url (one column with site URLs)
# Requires: SharePoint Online Management Shell

Import-Module Microsoft.Online.SharePoint.PowerShell
Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"

$approvedSites = Import-Csv "ApprovedSites.csv"
$results = @()

foreach ($site in $approvedSites) {
    try {
        Add-SPOTenantRestrictedSearchAllowedList -SitesList @($site.Url)
        $results += [PSCustomObject]@{
            Url    = $site.Url
            Status = "Added"
            Date   = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
        }
        Write-Host "Added: $($site.Url)" -ForegroundColor Green
    } catch {
        $results += [PSCustomObject]@{
            Url    = $site.Url
            Status = "Failed: $($_.Exception.Message)"
            Date   = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
        }
        Write-Host "Failed: $($site.Url) - $($_.Exception.Message)" -ForegroundColor Red
    }
}

$results | Export-Csv "RSSAllowedList_Changes_$(Get-Date -Format 'yyyyMMdd').csv" -NoTypeInformation
Write-Host "`nTotal: $($results.Count) | Added: $(($results | Where-Object Status -eq 'Added').Count)"

Script 3: Audit and Export Current RSS Allowed List (Legacy — Existing Configurations Only)

# Export the current RSS allowed sites list for audit and review
# Requires: SharePoint Online Management Shell

Import-Module Microsoft.Online.SharePoint.PowerShell
Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"

$allowedList = Get-SPOTenantRestrictedSearchAllowedList

$auditReport = @()
foreach ($siteUrl in $allowedList.SitesList) {
    $siteDetail = Get-SPOSite -Identity $siteUrl -Detailed -ErrorAction SilentlyContinue
    $auditReport += [PSCustomObject]@{
        Url               = $siteUrl
        Title             = $siteDetail.Title
        SharingCapability = $siteDetail.SharingCapability
        SensitivityLabel  = $siteDetail.SensitivityLabel
        Owner             = $siteDetail.Owner
        LastModified      = $siteDetail.LastContentModifiedDate
    }
}

$auditReport | Export-Csv "RSSAllowedList_Audit_$(Get-Date -Format 'yyyyMMdd').csv" -NoTypeInformation
Write-Host "Exported $($auditReport.Count) allowed sites to audit report."

Script 4: Remove Sites from RSS Allowed List (Legacy — Existing Configurations Only)

# Remove sites from the RSS allowed list (e.g., during quarterly review)
# Requires: SharePoint Online Management Shell

Import-Module Microsoft.Online.SharePoint.PowerShell
Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"

$sitesToRemove = Import-Csv "SitesToRemove.csv"

foreach ($site in $sitesToRemove) {
    try {
        Remove-SPOTenantRestrictedSearchAllowedList -SitesList @($site.Url)
        Write-Host "Removed: $($site.Url)" -ForegroundColor Yellow
    } catch {
        Write-Host "Failed to remove: $($site.Url) - $($_.Exception.Message)" -ForegroundColor Red
    }
}

Script 5: Enable Restricted Content Discovery (RCD) on Specific Sites

# Enable RCD on specific sites to exclude them from Copilot discovery
# RCD excludes sites from Copilot grounding while leaving direct user access unchanged
# Requires: SharePoint Online Management Shell

Import-Module Microsoft.Online.SharePoint.PowerShell
Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"

# Enable RCD on a single site
$siteUrl = "https://<tenant>.sharepoint.com/sites/<sensitive-site>"
Set-SPOSite -Identity $siteUrl -RestrictContentOrgWideSearch $true
Write-Host "RCD enabled for: $siteUrl" -ForegroundColor Green

# Verify the setting
$site = Get-SPOSite -Identity $siteUrl
Write-Host "RestrictContentOrgWideSearch: $($site.RestrictContentOrgWideSearch)"

Script 6: Bulk Enable RCD from CSV

# Bulk enable RCD on multiple sites from a CSV list
# CSV format: Url,Reason (two columns)
# Requires: SharePoint Online Management Shell

Import-Module Microsoft.Online.SharePoint.PowerShell
Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"

$sitesToRestrict = Import-Csv "RCDSites.csv"
$rcdLog = @()

foreach ($site in $sitesToRestrict) {
    try {
        Set-SPOSite -Identity $site.Url -RestrictContentOrgWideSearch $true
        $rcdLog += [PSCustomObject]@{
            Url     = $site.Url
            Reason  = $site.Reason
            Status  = "RCD Enabled"
            Date    = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
        }
        Write-Host "RCD enabled: $($site.Url)" -ForegroundColor Green
    } catch {
        $rcdLog += [PSCustomObject]@{
            Url     = $site.Url
            Reason  = $site.Reason
            Status  = "Failed: $($_.Exception.Message)"
            Date    = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
        }
        Write-Host "Failed: $($site.Url)" -ForegroundColor Red
    }
}

$rcdLog | Export-Csv "RCDConfiguration_$(Get-Date -Format 'yyyyMMdd').csv" -NoTypeInformation
Write-Host "RCD configured on $($rcdLog.Where({$_.Status -eq 'RCD Enabled'}).Count) sites."

Script 7: Audit RCD Configuration Across All Sites

# Audit which sites have RCD enabled for governance review
# Requires: SharePoint Online Management Shell

Import-Module Microsoft.Online.SharePoint.PowerShell
Connect-SPOService -Url "https://<tenant>-admin.sharepoint.com"

$allSites = Get-SPOSite -Limit All -IncludePersonalSite $false
$rcdEnabledSites = @()

foreach ($site in $allSites) {
    $detail = Get-SPOSite -Identity $site.Url -ErrorAction SilentlyContinue
    if ($detail.RestrictContentOrgWideSearch -eq $true) {
        $rcdEnabledSites += [PSCustomObject]@{
            Url   = $site.Url
            Title = $site.Title
            Owner = $detail.Owner
        }
    }
}

Write-Host "Sites with RCD enabled: $($rcdEnabledSites.Count)"
$rcdEnabledSites | Export-Csv "RCDAudit_$(Get-Date -Format 'yyyyMMdd').csv" -NoTypeInformation

Scheduled Tasks

Task Frequency Purpose
RCD Tenant Report Monthly Generate audit trail of RCD-excluded sites using Start-SPORestrictedContentDiscoverabilityReport
RCD Configuration Review Monthly Confirm RCD sites are still appropriate; remove RCD where remediation is complete
Governance Review Report Quarterly Support governance committee review of RCD governance log and any remaining RSS configuration
RSS Mode Verification (legacy) Weekly (if RSS is active) Confirm existing RSS remains in expected state; plan migration to RCD

Next Steps