如何通过PowerShell发布关联工作区现有数据集的PowerBI无数据集报表？

当发布不含内置数据集的.pbix文件时，New-PowerBIReport cmdlet无法自动关联工作区内的现有数据集，导致PowerBIModelNotFoundException错误。此时需要通过Power BI REST API的导入接口，显式指定要绑定的现有数据集ID，实现无交互发布。

步骤1：保持服务主体认证逻辑 #

原有认证代码可继续使用，确保服务主体拥有目标工作区的成员权限及现有数据集的访问权限：

Import-Module MicrosoftPowerBIMgmt

$clientId = "****"
$clientSecret = "****"
$tenantId = "****"

$secpasswd = ConvertTo-SecureString $clientSecret -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential($clientId, $secpasswd)

Connect-PowerBIServiceAccount -ServicePrincipal -Credential $credential -TenantId $tenantId
$workspaceName = "Development"
$workspace = Get-PowerBIWorkspace -Name $workspaceName
$filePath = "C:\\Tasks\\BI\\ReportOnly.pbix"

步骤2：获取目标数据集ID #

通过数据集名称定位工作区内的现有数据集，获取其ID：

$targetDatasetName = "你的数据集名称" # 替换为实际数据集名称
$targetDataset = Get-PowerBIDataset -Workspace $workspace | Where-Object { $_.Name -eq $targetDatasetName }
if (-not $targetDataset) {
    throw "未找到目标数据集：$targetDatasetName"
}
$datasetId = $targetDataset.Id

步骤3：调用REST API上传并关联报表 #

使用Invoke-PowerBIRestMethod调用导入接口，指定datasetId参数绑定现有数据集，同时设置冲突处理策略：

# 读取.pbix文件为字节流
$fileBytes = [System.IO.File]::ReadAllBytes($filePath)
$fileStream = [System.IO.MemoryStream]::new($fileBytes)

# 构建API请求参数
$importParams = @{
    groupId         = $workspace.Id
    datasetId       = $datasetId
    nameConflict    = "CreateOrOverwrite" # 可选：CreateOrOverwrite/Ignore/Overwrite
    displayName     = "报表显示名称" # 替换为报表的显示名称
}

# 构造请求URI
$requestUri = "https://api.powerbi.com/v1.0/myorg/groups/$($importParams.groupId)/imports?datasetId=$($importParams.datasetId)&nameConflict=$($importParams.nameConflict)&displayName=$($importParams.displayName)"

# 发送POST请求上传文件
$response = Invoke-PowerBIRestMethod -Method Post -Uri $requestUri -Body $fileStream -ContentType "application/octet-stream"

# 输出响应结果
Write-Host "报表发布响应：$response"

关键说明 #

• 确保服务主体拥有工作区成员权限和数据集的读取/构建权限，否则会出现权限错误。
• nameConflict参数可根据需求选择：CreateOrOverwrite（存在则覆盖，不存在则创建）、Ignore（存在则跳过）、Overwrite（强制覆盖已存在的报表）。
• 如果需要批量发布，可循环处理多个报表文件，重复步骤2-3即可。

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