如何通过PowerShell更新已部署Power BI分页报表的数据源？

你可以通过Power BI REST API结合PowerShell来更新已部署分页报表的数据源，目前没有直接的PowerShell cmdlet支持该操作，但可以用Invoke-RestMethod调用API实现。以下是完整的实现步骤和示例脚本：

前提准备 #

1. 拥有目标Power BI工作区的Member或Admin权限
2. 准备好用于认证的服务主体（适合自动化场景）或用户凭据
3. 获取以下关键信息：租户ID、服务主体ID/密钥、工作区ID、分页报表ID

步骤1：获取访问令牌 #

以服务主体认证为例，获取Power BI API的访问令牌：

$tenantId = "你的租户ID"
$clientId = "你的服务主体ID"
$clientSecret = "你的服务主体密钥"

$tokenEndpoint = "https://login.microsoftonline.com/$tenantId/oauth2/token"
$resource = "https://analysis.windows.net/powerbi/api"

$authBody = @{
    grant_type    = "client_credentials"
    client_id     = $clientId
    client_secret = $clientSecret
    resource      = $resource
}

$authResponse = Invoke-RestMethod -Uri $tokenEndpoint -Method Post -Body $authBody
$accessToken = $authResponse.access_token

步骤2：获取报表的数据源ID #

调用API获取目标报表下的数据源列表，提取需要更新的数据源ID：

$workspaceId = "目标工作区ID"
$reportId = "已部署的分页报表ID"

$datasourcesUri = "https://api.powerbi.com/v1.0/myorg/groups/$workspaceId/reports/$reportId/datasources"
$datasources = Invoke-RestMethod -Uri $datasourcesUri -Headers @{Authorization = "Bearer $accessToken"} -Method Get

# 若报表有多个数据源，需根据name或type筛选，此处取第一个数据源示例
$targetDatasourceId = $datasources.value[0].id

步骤3：更新数据源连接 #

构造更新请求体，调用API修改数据源的连接字符串和凭据（以SQL Server数据源为例）：

# 构造更新请求内容，根据数据源类型调整参数
$updateBody = @{
    datasource = @{
        connectionString = "Data Source=NEW_SERVER_NAME;Initial Catalog=NEW_DB_NAME"
        credentialDetails = @{
            credentials = "{""credentialData"":[{""name"":""username"",""value"":""DB_USER""},{""name"":""password"",""value"":""DB_PWD""}]}"
            credentialType = "Sql" # 根据实际凭据类型选择：Basic/Windows/Sql等
            encryptedConnection = "Encrypted"
            privacyLevel = "Organizational"
        }
    }
} | ConvertTo-Json -Depth 10

$updateUri = "https://api.powerbi.com/v1.0/myorg/groups/$workspaceId/reports/$reportId/datasources/$targetDatasourceId"
Invoke-RestMethod -Uri $updateUri -Headers @{Authorization = "Bearer $accessToken"} -Method Patch -Body $updateBody -ContentType "application/json"

关键注意事项 #

• 数据源类型适配：不同数据源（如Oracle、Azure SQL、MySQL）的connectionString格式和credentialType需对应调整，可先通过步骤2的API返回值参考现有数据源结构
• 权限要求：服务主体必须被添加到目标工作区，且拥有报表编辑权限
• 凭据加密：生产环境中建议使用安全方式存储凭据（如Azure Key Vault），避免明文写入脚本
• 多数据源处理：若报表包含多个数据源，需遍历$datasources.value并根据name或type筛选目标数据源进行更新

内容的提问来源于stack exchange，提问作者Ahsan Ullah Khan