PowerShell调用API获取企业数据仅返回250条记录问题咨询

调用PowerShell自定义函数拉取API的企业数据时，仅能获取250条记录，预期返回总记录数超过7000条。
涉及的函数实现代码：

function Get-Companies {
$GetCompanies = @{
    Method      = "GET"
    ContentType = "application/json"
    URI         = "https...api/cm/companies"
}
$companies = Invoke-RestMethod @GetCompanies;
return $companies;}

调用与结果验证代码：

$companies = Get-Companies
$companies.rows #仅返回250条记录，预期应为7000+条

• 几乎所有面向生产环境的REST API都默认配置了分页返回规则，单次请求仅会返回固定数量的第一页数据，250就是当前接口设置的单页返回上限，和PowerShell本身的能力无关。
• 现有代码只发起了一次API请求，没有携带分页控制参数，也没有实现循环拉取所有分页的逻辑，自然只能拿到第一页的250条数据。

• 先确认目标API的分页规则：这类分页接口通常会在响应头、响应体中返回总记录数、下一页标识、当前页码等信息，常见的分页控制参数为limit（单页返回条数）+offset（记录偏移量），或是page（页码）+pageSize（单页大小），部分接口会直接返回nextPageUrl字段直接给出下一页的请求地址。
• 实现循环翻页逻辑，拉取全量数据，参考实现如下（以limit+offset分页规则为例）：

function Get-Companies {
    $allRows = @()
    $baseUri = "https...api/cm/companies"
    $pageSize = 250 # 可尝试调大该值，部分接口支持单页最大1000条，能减少请求次数
    $offset = 0

    do {
        $requestSplat = @{
            Method      = "GET"
            ContentType = "application/json"
            Uri         = "$baseUri`?limit=$pageSize&offset=$offset" # 需根据接口实际要求调整参数名
        }
        $currentResponse = Invoke-RestMethod @requestSplat
        $allRows += $currentResponse.rows
        $offset += $pageSize
        # 终止条件：当前页返回记录数小于设定的单页大小，说明已拉取到最后一页
    } while ($currentResponse.rows.Count -eq $pageSize)

    return [PSCustomObject]@{
        rows = $allRows
        totalCount = $allRows.Count
    }
}

• 额外注意事项：
  • 如果接口响应中直接返回总记录数字段，可直接用总记录数作为循环终止判断依据，结果更准确。
  • 全量拉取数据量较大时，可在每次请求间隔增加短暂休眠，比如Start-Sleep -Milliseconds 200，避免触发接口的请求频率限制被拦截。
  • 若接口要求分页参数放在请求头中，对应调整请求参数的传递位置即可，核心翻页逻辑不变。

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