PowerShell筛选SharePoint Online指定日期文件及排序问题求助

一、正确按创建日期筛选与排序列表项 #

1. 客户端筛选的正确写法 #

你之前的客户端筛选写法存在字段引用问题，正确引用Created字段并筛选文件的示例：

$targetDate = [DateTime]'02/16/2015'
# 筛选指定日期后创建的文件
$listItems = Get-PnPListItem -List $ListName -PageSize 500 | Where-Object {
    $_.FileSystemObjectType -eq [Microsoft.SharePoint.Client.FileSystemObjectType]::File -and
    $_.Created -gt $targetDate
}

# 按创建日期升序排序
$listItemsSorted = $listItems | Sort-Object Created

⚠️ 注意：这种方式是先拉取所有列表项到本地再筛选，仅适合小列表，大列表会触发性能问题或阈值错误，优先用服务器端筛选（CAML）。

2. 服务器端CAML筛选（推荐） #

服务器端筛选能大幅减少返回的数据量，避免客户端筛选的性能瓶颈，同时支持直接排序。

二、解决“列表视图阈值超出”错误 #

该错误核心原因是：即便设置分页，SharePoint仍需先计算符合条件的总条目数，若总数超过阈值（默认5000）就会触发错误。以下是针对性解决方法：

1. 为Created字段创建索引 #

SharePoint需要对筛选字段建立索引才能高效处理大列表查询：

• 进入目标SharePoint列表设置 → 索引列 → 创建新索引，选择Created字段完成配置。

2. 修正CAML查询格式 #

你的CAML存在标签闭合位置错误，正确的结构如下（同时匹配分页参数）：

$startDate = "2015-01-01T12:00:00Z"
$endDate = "2015-01-30T12:00:00Z"

$Query = @"
<View>
    <Query>
        <Where>
            <And>
                <Geq>
                    <FieldRef Name='Created' />
                    <Value Type='DateTime' IncludeTimeValue='TRUE'>$startDate</Value>
                </Geq>
                <Leq>
                    <FieldRef Name='Created' />
                    <Value Type='DateTime' IncludeTimeValue='TRUE'>$endDate</Value>
                </Leq>
            </And>
        </Where>
        <!-- 服务器端按创建日期排序 -->
        <OrderBy>
            <FieldRef Name='Created' Ascending='TRUE' />
        </OrderBy>
    </Query>
    <!-- RowLimit需与-PageSize参数值保持一致 -->
    <RowLimit Paged='TRUE'>500</RowLimit>
</View>
"@

# 执行查询
$listItems = Get-PnPListItem -List $ListName -PageSize 500 -Query $Query

关键要点：

• RowLimit和-PageSize值必须一致，确保分页逻辑协同工作；
• 添加IncludeTimeValue='TRUE'保证日期时间的精确匹配；
• 服务器端排序OrderBy比客户端排序效率更高。

3. 拆分日期范围分批处理 #

如果列表条目极大，即使添加索引，单批次日期范围仍可能触发阈值，可进一步缩小批次范围（比如按周/月拆分）：

# 示例：按周分批处理2015年1月的文件
$start = [DateTime]'2015-01-01'
for ($i=0; $i -lt 4; $i++) {
    $batchStart = $start.AddDays($i*7)
    $batchEnd = $batchStart.AddDays(7)
    # 转换为UTC格式的字符串
    $batchStartStr = $batchStart.ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
    $batchEndStr = $batchEnd.ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")

    $batchQuery = @"
<View>
    <Query>
        <Where>
            <And>
                <Geq>
                    <FieldRef Name='Created' />
                    <Value Type='DateTime' IncludeTimeValue='TRUE'>$batchStartStr</Value>
                </Geq>
                <Leq>
                    <FieldRef Name='Created' />
                    <Value Type='DateTime' IncludeTimeValue='TRUE'>$batchEndStr</Value>
                </Leq>
            </And>
        </Where>
    </Query>
    <RowLimit Paged='TRUE'>500</RowLimit>
</View>
"@

    Write-Host "处理日期范围: $batchStart 至 $batchEnd"
    $batchItems = Get-PnPListItem -List $ListName -PageSize 500 -Query $batchQuery
    # 在此添加文件复制逻辑
}

4. 直接操作文件的备选方案 #

如果仅需处理文件，可直接使用Get-PnPFile简化操作：

$targetDate = [DateTime]'2015-02-16'
$files = Get-PnPFile -List $ListName -PageSize 500 | Where-Object {
    $_.TimeCreated -gt $targetDate
}

内容的提问来源于stack exchange，提问作者YosiPel