如何正确重命名Power BI本地数据网关及切换集群主网关？

现状说明 #

• 网关集群可通过Power Platform管理中心重命名，但网关实例本身无法直接重命名；在新电脑上安装网关并“接管”另一网关也不会更改其名称。
• PowerShell的DataGateway模块未提供修改网关集群成员属性的命令（无Set-DataGatewayClusterMember）。

切换网关集群主网关的问题 #

网上现有信息大多不准确，实际测试得出以下结论：

• 在新电脑上安装网关并“接管”旧网关，仍会保留旧网关的名称
• 卸载承载主网关的电脑上的网关程序，主网关会显示为“Offline”状态
• 卸载主网关后尝试在管理中心移除该实例，会触发报错：Please remove all other member gateways before removing the primary instance of this gateway cluster.
• 卸载并禁用主网关后尝试移除，仍会出现上述相同报错
• PowerShell的Set-DataGatewayCluster命令无-PrimaryInstance或-PrimaryMember参数，无法直接指定集群主网关

已尝试的思路及结果 #

曾尝试通过移除所有集群成员后重建的方式解决，但实际测试发现：

• 创建未加入集群的新网关（自动生成新集群）并添加数据源后，卸载该网关并通过Power Platform管理中心移除主成员，集群会立即被销毁，重新安装网关无法连接到原集群
• 结论：移除主网关会直接销毁集群及所有关联数据源，此方案不可行

可选替代方案 #

方案一：完全重建（适合小型环境） #

• 记录所有数据源的完整配置信息
• 移除集群内所有网关成员
• 安装带有目标名称的新网关
• 重新配置所有数据源

方案二：平滑迁移（减少停机时间） #

• 创建带有目标名称的新网关及对应集群
• 将旧集群的所有数据源配置复制到新集群（注意：PowerShell的Set-DataGatewayClusterDatasource命令无法设置登录凭据，该部分需手动配置）
• 检查Power BI中所有数据集的设置，将使用旧网关的数据源切换至新网关

结论 #

目前微软官方并未提供直接重命名Power BI本地数据网关实例的方法，也无法直接切换集群主网关。唯一可行的方式是通过上述替代方案重建或迁移网关集群，代价是需要重新配置部分或全部数据源连接。

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