如何使用PowerShell将.PublishSettings文件转换为.pubxml及.pubxml.user文件

核心思路 #

.PublishSettings是XML格式文件，包含Azure Web应用的发布凭据、端点等关键信息。我们可以直接解析该XML，提取所需字段后，生成符合Visual Studio规范的.pubxml（项目级发布配置，不含敏感信息）和.pubxml.user（存储敏感密码）文件。

步骤与代码示例 #

1. 解析.PublishSettings文件 #

先读取并解析下载的配置文件，筛选出Web Deploy类型的发布配置：

# 替换为你的PublishSettings文件路径
$publishSettingsPath = "C:\downloads\MySite.publishsettings"
$xml = [xml](Get-Content $publishSettingsPath)

# 提取Web Deploy类型的发布配置
$targetProfile = $xml.publishData.publishProfile | Where-Object { $_.publishMethod -eq "MSDeploy" }
$siteName = $targetProfile.msdeploySite
$publishUrl = $targetProfile.publishUrl
$userName = $targetProfile.userName
$userPWD = $targetProfile.userPWD
$destinationUrl = $targetProfile.destinationAppUrl

2. 生成.pubxml文件 #

.pubxml是项目共享的发布配置，模板如下：

# 替换为网站项目的PublishProfiles目录路径
$pubxmlOutputPath = "C:\projects\MySite\Properties\PublishProfiles\Azure.pubxml"

# 构建pubxml内容
$pubxmlContent = @"
<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <WebPublishMethod>MSDeploy</WebPublishMethod>
    <LastUsedBuildConfiguration>Release</LastUsedBuildConfiguration>
    <LastUsedPlatform>Any CPU</LastUsedPlatform>
    <SiteUrlToLaunchAfterPublish>$destinationUrl</SiteUrlToLaunchAfterPublish>
    <LaunchSiteAfterPublish>True</LaunchSiteAfterPublish>
    <ExcludeApp_Data>False</ExcludeApp_Data>
    <MSDeployServiceURL>$publishUrl</MSDeployServiceURL>
    <DeployIisAppPath>$siteName</DeployIisAppPath>
    <RemoteSitePhysicalPath />
    <SkipExtraFilesOnServer>False</SkipExtraFilesOnServer>
    <MSDeployPublishMethod>WMSVC</MSDeployPublishMethod>
    <EnableMSDeployBackup>True</EnableMSDeployBackup>
    <UserName>$userName</UserName>
    <_SavePWD>False</_SavePWD>
    <PublishDatabaseSettings>
      <Objects xmlns="" />
    </PublishDatabaseSettings>
  </PropertyGroup>
</Project>
"@

# 写入文件
$pubxmlContent | Out-File $pubxmlOutputPath -Encoding utf8

3. 生成.pubxml.user文件 #

该文件用于存储敏感的发布密码，模板如下：

$pubxmlUserOutputPath = "$pubxmlOutputPath.user"

# 构建pubxml.user内容
$pubxmlUserContent = @"
<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <Password>$userPWD</Password>
  </PropertyGroup>
</Project>
"@

# 写入文件
$pubxmlUserContent | Out-File $pubxmlUserOutputPath -Encoding utf8

4. 批量处理脚本 #

如果要批量处理多个网站，可通过循环遍历文件实现：

# 替换为你的PublishSettings存放目录和网站项目根目录
$publishSettingsDir = "C:\all-publish-settings"
$webProjectsRoot = "C:\web-projects"

Get-ChildItem $publishSettingsDir -Filter "*.publishsettings" | ForEach-Object {
    $siteName = $_.BaseName
    $xml = [xml](Get-Content $_.FullName)
    $targetProfile = $xml.publishData.publishProfile | Where-Object { $_.publishMethod -eq "MSDeploy" }

    # 确保目标PublishProfiles目录存在
    $pubxmlDir = Join-Path $webProjectsRoot $siteName "Properties\PublishProfiles"
    if (-not (Test-Path $pubxmlDir)) {
        New-Item $pubxmlDir -ItemType Directory | Out-Null
    }

    # 生成pubxml
    $pubxmlPath = Join-Path $pubxmlDir "$siteName.pubxml"
    # 此处插入前面的pubxml内容生成代码

    # 生成pubxml.user
    $pubxmlUserPath = "$pubxmlPath.user"
    # 此处插入前面的pubxml.user内容生成代码
}

注意事项 #

• 确保PowerShell拥有读写网站项目目录的权限
• .PublishSettings可能包含多个发布配置节点，务必筛选publishMethod为MSDeploy的节点（这是Visual Studio发布Azure Web应用的标准方式）
• 如果项目有特殊发布需求（如数据库同步、自定义参数），需自行调整.pubxml模板内容

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