PowerShell脚本优化咨询：Teams文件上传脚本改进建议

开发者阿泽

2026-7-31

PowerShell SharePoint 文件上传脚本优化方案与改进建议

核心优化方向

1. 消除代码冗余，复用核心逻辑

原脚本if/else块内的上传流程高度重复，仅差异在于是否需要创建年度文件夹。通过抽离公共逻辑，避免重复代码，大幅提升维护性。

2. 简化文件夹操作逻辑

使用PnP PowerShell的Ensure-PnPFolder命令，可直接确保目标文件夹存在（不存在则自动创建），无需先判断再执行创建操作，大幅简化代码流程。

3. 强化错误处理与日志输出

区分不同场景的错误（连接失败、源文件不存在、文件夹操作失败、文件上传失败），输出更清晰的错误提示
连接失败后直接终止脚本，避免后续无效操作
使用PowerShell标准的Write-Error替代简单echo，符合错误输出规范

4. 提升代码可读性

语义化变量命名，如$currentYear、$lastMonthFolderName替代模糊的$year、$d
使用字符串插值（$"..."）替代字符串拼接，更简洁直观
添加关键步骤注释，明确代码意图

5. 增加前置校验

提前检查源文件是否存在，拦截无效操作
验证PnP连接状态，确保后续操作能正常执行

优化后的完整脚本

# 配置变量
$SiteURL = "https://company.sharepoint.com/sites/Team"
$SourceFilePath = "C:\Documents\report.csv"
$rootDestinationPath = "/sites/Team/Shared Documents/General/Documents" # 服务器相对URL

# 1. 前置校验：检查源文件是否存在
if (-not (Test-Path -Path $SourceFilePath -PathType Leaf)) {
    Write-Error "错误：源文件不存在 - $SourceFilePath"
    exit 1
}

# 2. 连接到SharePoint Online
try {
    Connect-PnPOnline -Url $SiteURL -ClientId "47bf0ca0-1d8a-xxxx-xxx-xxxx" -Tenant 'tenant.onmicrosoft.com' -Thumbprint <Thumbprint> -ErrorAction Stop
    Write-Host "已成功连接到SharePoint站点：$SiteURL" -ForegroundColor Green
}
catch {
    Write-Error "连接SharePoint失败：$($_.Exception.Message)"
    exit 1
}

# 3. 计算目标文件夹路径（年度/上月）
$currentYear = Get-Date -Format yyyy
$lastMonthFolderName = (Get-Date).AddMonths(-1).ToString("yyyy-M")
$yearFolderPath = "$rootDestinationPath/$currentYear"
$targetFolderPath = "$yearFolderPath/$lastMonthFolderName"

# 4. 确保年度文件夹和上月文件夹存在（不存在则自动创建）
try {
    # 确保年度文件夹存在
    $yearFolder = Ensure-PnPFolder -Url $yearFolderPath -ErrorAction Stop
    Write-Host "年度文件夹已就绪：$yearFolderPath" -ForegroundColor Cyan

    # 确保上月文件夹存在
    $targetFolder = Ensure-PnPFolder -Url $targetFolderPath -ErrorAction Stop
    Write-Host "目标文件夹已就绪：$targetFolderPath" -ForegroundColor Cyan
}
catch {
    Write-Error "创建/获取文件夹失败：$($_.Exception.Message)"
    Disconnect-PnPOnline -ErrorAction SilentlyContinue
    exit 1
}

# 5. 上传文件到目标文件夹
try {
    Add-PnPFile -Path $SourceFilePath -Folder $targetFolderPath -ErrorAction Stop
    Write-Host "文件上传成功：$SourceFilePath -> $targetFolderPath" -ForegroundColor Green
}
catch {
    Write-Error "文件上传失败：$($_.Exception.Message)"
}

# 6. 断开SharePoint连接
Disconnect-PnPOnline -ErrorAction SilentlyContinue
Write-Host "已断开SharePoint连接" -ForegroundColor Cyan

额外改进建议

添加日志文件：使用Start-Transcript和Stop-Transcript将操作日志输出到指定文件，方便后续排查问题

参数化脚本：将站点URL、源文件路径等配置项改为脚本参数，提升复用性，示例：

param(
    [Parameter(Mandatory=$true)]
    [string]$SiteURL,
    [Parameter(Mandatory=$true)]
    [string]$SourceFilePath,
    [string]$RootDestinationPath = "/sites/Team/Shared Documents/General/Documents"
)

权限校验：连接后检查当前账号是否拥有目标文件夹的读写权限，提前避免权限不足的错误
幂等性保障：检查目标文件夹中是否已存在同名文件，可选择覆盖、跳过或重命名，避免重复上传导致的数据冲突

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