Azure发布管道无法安装MicrosoftPowerBIMgmt包问题求助

问题根源 #

MicrosoftPowerBIMgmt系列模块已被微软停止维护并从PowerShell Gallery下架，因此无论是Azure发布管道还是本地环境，都无法搜索、安装该模块，同时PowerShell Gallery的对应模块页面会显示不可用错误。

替代解决方案 #

1. 优先使用Power BI REST API + Azure AD认证 #

若需在管道中操作Power BI资源，官方推荐直接调用Power BI REST API，并通过Azure AD服务主体完成认证：

• 注册Azure AD服务主体，为其分配所需的Power BI API权限（如Workspace.ReadWrite.All、Dataset.ReadWrite.All等）
• 在Azure管道中通过PowerShell任务调用API，示例代码：

# 获取Azure AD访问令牌
$tenantId = "你的租户ID"
$clientId = "服务主体客户端ID"
$clientSecret = "服务主体密钥"
$resource = "https://analysis.windows.net/powerbi/api"

$tokenUri = "https://login.microsoftonline.com/$tenantId/oauth2/token"
$body = @{
    grant_type    = "client_credentials"
    client_id     = $clientId
    client_secret = $clientSecret
    resource      = $resource
}
$tokenResponse = Invoke-RestMethod -Uri $tokenUri -Method Post -Body $body

# 示例：调用API获取工作区列表
$apiUri = "https://api.powerbi.com/v1.0/myorg/groups"
$headers = @{
    "Authorization" = "Bearer $($tokenResponse.access_token)"
}
$workspaces = Invoke-RestMethod -Uri $apiUri -Headers $headers -Method Get

2. 针对Power BI嵌入式场景：使用Az.PowerBIEmbedded模块 #

如果你的需求是管理Power BI嵌入式容量，可使用Azure Az模块中的Az.PowerBIEmbedded：

# 安装模块
Install-Module -Name Az.PowerBIEmbedded -Force -AllowClobber

# 服务主体登录Azure（管道中可通过变量存储凭据）
$psCredential = New-Object System.Management.Automation.PSCredential($clientId, (ConvertTo-SecureString $clientSecret -AsPlainText -Force))
Connect-AzAccount -ServicePrincipal -Tenant $tenantId -Credential $psCredential

# 示例：获取嵌入式容量列表
Get-AzPowerBIEmbeddedCapacity

3. 临时方案：使用离线归档模块（不推荐） #

若必须依赖旧版MicrosoftPowerBIMgmt模块，可从微软官方归档渠道下载对应版本的离线模块包，然后在Azure管道中手动导入：

• 下载旧版模块压缩包
• 通过管道的CopyFiles或PublishBuildArtifacts任务将包复制到代理机器
• 导入模块：

Import-Module -Path "模块文件路径/MicrosoftPowerBIMgmt.Profile" -Force

注意：该模块已停止维护，存在安全漏洞风险，不建议长期使用。

基础验证步骤 #

• 在Azure管道中执行以下命令，确认PowerShell Gallery已注册：

Get-PSRepository

• 若PSGallery未注册，执行命令完成注册：

Register-PSRepository -Name PSGallery -SourceLocation https://www.powershellgallery.com/api/v2/ -InstallationPolicy Trusted

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