已能用PowerShell下载PBIX，如何批量发布文件夹内Power BI文件至工作区？

下面提供两种可行的批量发布方案，重点说明你提到的Power BI REST API用法，同时补充更简洁的PowerShell模块方案。

前提条件 #

• 拥有Power BI Pro或Premium授权
• 已注册Azure AD服务主体（获取客户端ID、客户端密钥、租户ID），并为该主体分配目标工作区的「成员」或「管理员」权限

方案1：PowerShell调用Power BI REST API #

1. 获取访问令牌 #

通过服务主体认证获取API访问权限：

# 替换为你的认证信息
$tenantId = "你的租户ID"
$clientId = "Azure AD应用客户端ID"
$clientSecret = "Azure AD应用客户端密钥"

# 请求令牌
$tokenParams = @{
    Uri = "https://login.microsoftonline.com/$tenantId/oauth2/v2.0/token"
    Method = "POST"
    Body = @{
        grant_type = "client_credentials"
        scope = "https://analysis.windows.net/powerbi/api/.default"
        client_id = $clientId
        client_secret = $clientSecret
    }
}
$tokenResponse = Invoke-RestMethod @tokenParams
$accessToken = $tokenResponse.access_token

2. 查询目标工作区ID #

先定位要发布到的工作区ID：

$targetWorkspaceName = "你的目标工作区名称"
$workspaces = Invoke-RestMethod -Uri "https://api.powerbi.com/v1.0/myorg/groups" -Headers @{Authorization = "Bearer $accessToken"}
$targetWorkspaceId = ($workspaces.value | Where-Object Name -eq $targetWorkspaceName).id

3. 批量发布.pbix文件 #

遍历指定文件夹下的所有.pbix文件，逐个调用发布接口：

$pbixFolder = "C:\存放PBIX的文件夹路径"
$pbixFiles = Get-ChildItem -Path $pbixFolder -Filter *.pbix

foreach ($file in $pbixFiles) {
    $publishUri = "https://api.powerbi.com/v1.0/myorg/groups/$targetWorkspaceId/imports?datasetDisplayName=$($file.BaseName)&nameConflict=CreateOrOverwrite"
    $fileBytes = [System.IO.File]::ReadAllBytes($file.FullName)

    try {
        $result = Invoke-RestMethod -Uri $publishUri -Headers @{Authorization = "Bearer $accessToken"} -Method Post -Body $fileBytes -ContentType "application/octet-stream"
        Write-Host "✅ 发布成功：$($file.Name) | 导入ID：$($result.id)"
    }
    catch {
        Write-Host "❌ 发布失败：$($file.Name) | 错误：$($_.Exception.Message)"
    }
}

关键参数说明

• nameConflict：可选值包括CreateOrOverwrite（覆盖同名数据集）、Abort（存在则终止）、GenerateUniqueName（生成唯一名称）
• datasetDisplayName：设置数据集在工作区的显示名称，这里直接使用文件名（不含后缀）

方案2：使用Power BI管理模块（更简洁） #

如果安装了官方PowerShell模块，操作会更简化：

1. 安装模块：

Install-Module -Name MicrosoftPowerBIMgmt -Force

2. 认证并批量发布：

# 替换为你的认证信息和路径
$tenantId = "你的租户ID"
$clientId = "Azure AD应用客户端ID"
$clientSecret = "Azure AD应用客户端密钥"
$pbixFolder = "C:\存放PBIX的文件夹路径"
$targetWorkspaceName = "你的目标工作区名称"

# 服务主体认证
Connect-PowerBIServiceAccount -ServicePrincipal -ClientId $clientId -ClientSecret $clientSecret -Tenant $tenantId

# 批量发布
Get-ChildItem -Path $pbixFolder -Filter *.pbix | ForEach-Object {
    New-PowerBIReport -Path $_.FullName -WorkspaceName $targetWorkspaceName -ConflictAction CreateOrOverwrite
}

注意事项 #

• 文件大小不能超过Power BI限制：Pro版1GB，Premium版10GB
• 首次发布的数据集可能需要手动配置数据源凭据（比如数据库密码）才能正常刷新
• 确保服务主体拥有目标工作区的足够权限，否则会返回403错误

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