如何用Import-Csv与foreach批量部署SharePoint模板至多站点

第一步：准备CSV文件 #

先创建一个CSV文件（比如命名为TargetSites.csv），格式如下，每行填写要应用模板的目标站点URL：

SiteUrl
https://yourtenant.sharepoint.com/sites/CustomerSite01
https://yourtenant.sharepoint.com/sites/CustomerSite02
https://yourtenant.sharepoint.com/sites/CustomerSite03

第二步：完整PowerShell脚本 #

直接使用以下脚本，替换对应参数即可：

# 1. 连接到SharePoint Online管理中心
$tenantAdminUrl = "https://yourtenant-admin.sharepoint.com"
Connect-SPOService -Url $tenantAdminUrl

# 2. 替换为你的目标Site Design ID（可通过Get-SPOSiteDesign命令查询）
$siteDesignId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

# 3. 导入CSV文件并批量处理站点
$targetSites = Import-Csv -Path "C:\Your\File\Path\TargetSites.csv"

foreach ($site in $targetSites) {
    $siteUrl = $site.SiteUrl
    Write-Host "正在处理站点: $siteUrl" -ForegroundColor Cyan

    try {
        # 向目标站点应用Site Design
        Invoke-SPOSiteDesign -Identity $siteDesignId -WebUrl $siteUrl
        Write-Host "✅ 模板应用成功: $siteUrl" -ForegroundColor Green
    }
    catch {
        Write-Host "❌ 处理失败: $siteUrl - 错误信息: $_" -ForegroundColor Red
    }
}

# 断开SPO服务连接
Disconnect-SPOService

关键细节说明 #

• 获取Site Design ID：如果记不清ID，运行Get-SPOSiteDesign命令，会列出所有已创建的站点设计，找到对应"Customer Tracking"列表的条目ID即可。
• 权限要求：你需要拥有SharePoint Online全局管理员权限，或至少是目标站点的站点管理员权限。
• CSV路径：确保Import-Csv的路径是你实际存放CSV文件的路径，相对路径或绝对路径都支持。
• 错误处理：脚本内置try-catch逻辑，单个站点处理失败时会输出错误信息，不会中断整个批量任务。

新手必备提示 #

• 若未安装SPO PowerShell模块，先运行Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Force完成安装。
• 首次执行Connect-SPOService会弹出登录窗口，输入租户管理员账号密码即可完成认证。

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