如何通过Jenkins流水线自动化Windows 10上的Azure P2S VPN连接

首先咱们拆解下你遇到的两个核心问题：

为什么SendKeys脚本在Jenkins里返回False？ #

Jenkins默认以本地系统账户运行服务，这个账户没有交互式桌面环境——而你的脚本依赖$wshell.SendKeys()模拟GUI窗口操作（激活连接窗口、回车），在无桌面的服务账户下完全无法工作，所以直接返回False。

为什么rasdial报错623？ #

rasdial找不到电话簿条目，是因为你指定的pbk文件路径属于你手动登录的个人用户目录，但Jenkins用的系统账户（或其他非你手动登录的账户）根本访问不到这个独立路径下的文件，路径不匹配自然报错。

接下来给你几个可行的解决方案，按稳定性优先级排序：

方案1：改用rasdial命令（推荐，无GUI依赖更稳定） #

rasdial是Windows原生的命令行VPN管理工具，完全不需要GUI交互，非常适合Jenkins这类自动化环境。步骤如下：

1. 获取准确的pbk文件路径
   用你手动配置VPN的用户登录服务器，打开PowerShell执行以下命令，找到Azure-VPN对应的pbk文件完整路径：

Get-ChildItem -Path "$env:USERPROFILE\AppData\Roaming\Microsoft\Network\Connections\Cm" -Filter *.pbk -Recurse | Select-Object FullName

复制输出的路径（比如C:\Users\HienLe\AppData\Roaming\Microsoft\Network\Connections\Cm\12345678-ABCD-1234-EFGH-1234567890AB\12345678-ABCD-1234-EFGH-1234567890AB.pbk）。

2. 编写连接/断开脚本
   如果你的VPN是证书认证（P2S常用方式），直接指定pbk路径即可：

# 连接VPN
rasdial "Azure-VPN" /phonebook:"你的pbk完整路径"
# 断开VPN
rasdial "Azure-VPN" /disconnect

如果是用户名密码认证，需要补充凭据：

rasdial "Azure-VPN" "你的用户名" "你的密码" /phonebook:"你的pbk完整路径"

3. Jenkins流水线写法
   直接用PowerShell步骤执行，避免嵌套bat，逻辑更清晰：

stage('VPN操作') {
    steps {
        powershell '''
            # 定义VPN名称和pbk路径
            $vpnName = "Azure-VPN"
            $pbkPath = "C:\\Users\\HienLe\\AppData\\Roaming\\Microsoft\\Network\\Connections\\Cm\\12345678-ABCD-1234-EFGH-1234567890AB\\12345678-ABCD-1234-EFGH-1234567890AB.pbk"
            
            # 连接VPN
            rasdial $vpnName /phonebook:$pbkPath
            
            # 检查连接状态，确保成功后再传输文件
            $isConnected = rasdial | Where-Object { $_ -match $vpnName }
            if ($isConnected) {
                Write-Host "✅ VPN连接成功，开始传输文件..."
                # 替换成你的文件传输命令，比如Copy-Item、robocopy等
                Copy-Item -Path "C:\\Jenkins\\workspace\\你的项目\\待传文件.txt" -Destination "\\vpn-server\\共享目录\\"
                Write-Host "✅ 文件传输完成，断开VPN..."
                # 断开VPN
                rasdial $vpnName /disconnect
            } else {
                Write-Error "❌ VPN连接失败，终止流程"
                exit 1
            }
        '''
    }
}

方案2：调整Jenkins服务运行账户（适合必须用SendKeys的场景） #

如果你坚持要用原SendKeys脚本，需要让Jenkins服务使用你手动配置VPN的用户账户运行，同时开启桌面交互权限：

1. 打开Windows服务管理器（services.msc），找到Jenkins服务，右键点击「属性」。
2. 切换到「登录」标签页，选择「此账户」，输入你手动配置VPN的用户名和密码。
3. 勾选「允许服务与桌面交互」，点击确定后重启Jenkins服务。

不过这个方案有明显缺点：依赖GUI窗口焦点，容易因为延迟、窗口状态问题不稳定；且暴露了个人用户凭据，安全性略低，所以更推荐方案1。

额外注意事项 #

• 若为证书认证VPN，确保Jenkins运行账户能访问对应证书：证书需导入到该用户的「个人」证书存储，而非「本地计算机」存储。
• 测试时，先以Jenkins运行账户登录服务器，手动执行一遍rasdial命令，确认能正常连接/断开后再放到流水线中，避免踩坑。

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