如何利用Azure Pipeline与Microsoft Teams在Windows机器运行远程脚本

一、前置准备 #

• 目标Windows机器开启WinRM服务：以管理员权限打开PowerShell，执行Enable-PSRemoting -Force，自动配置远程连接所需的服务和基础防火墙规则
• 确认目标机器防火墙放行WinRM端口：默认HTTP用5985，HTTPS用5986；域环境可通过组策略配置，单机直接手动放行对应端口即可
• Azure Pipeline的运行账号（或代理服务账号）需拥有目标机器的本地管理员权限，至少要有执行目标脚本的权限
• 提前把要执行的脚本放到目标机器的固定路径（比如C:\Scripts\RemoteScript.ps1），也可以在Pipeline中通过文件复制任务先将脚本上传到目标机器

二、Azure Pipeline配置远程脚本执行 #

1. 用PowerShell任务直接远程调用 #

在Pipeline的YAML文件中添加以下任务，通过Invoke-Command实现远程执行：

- task: PowerShell@2
  displayName: '执行远程Windows脚本'
  inputs:
    targetType: 'inline'
    script: |
      # 从Pipeline保密变量中读取远程机器的账号密码
      $cred = New-Object System.Management.Automation.PSCredential ("$(RemoteMachineUser)", (ConvertTo-SecureString "$(RemoteMachinePwd)" -AsPlainText -Force))
      # 远程执行脚本或命令
      Invoke-Command -ComputerName $(RemoteMachineIP) -Credential $cred -ScriptBlock {
        # 示例：执行目标机器上的本地脚本
        & "C:\Scripts\RemoteScript.ps1"
        # 可添加额外操作，比如输出执行日志
        Write-Host "脚本执行完成，当前系统时间：$(Get-Date)"
      }

注意：RemoteMachineUser、RemoteMachinePwd、RemoteMachineIP要存在Azure Pipeline的变量组中，并设置为保密变量，避免明文泄露。

2. 用WinRM任务（更轻量化） #

Azure DevOps提供专门的WinRM任务，无需手动构建凭证，直接配置参数即可：

- task: WinRM@1
  displayName: '通过WinRM执行远程脚本'
  inputs:
    Protocol: 'Http' # 若用HTTPS加密连接选Https
    MachineName: '$(RemoteMachineIP)'
    Port: '5985' # HTTPS对应端口5986
    Username: '$(RemoteMachineUser)'
    Password: '$(RemoteMachinePwd)'
    RunCommand: 'PowerShell'
    Command: '& "C:\Scripts\RemoteScript.ps1"'

三、集成Microsoft Teams通知 #

1. 创建Teams传入Webhook #

在Teams目标频道的「连接器」中找到「传入Webhook」，按照提示创建新的Webhook，复制生成的URL后，存入Azure Pipeline的保密变量（比如命名为TeamsWebhookURL）。

2. 在Pipeline中添加通知任务 #

不管脚本执行成功或失败，都发送结果到Teams，添加以下任务：

- task: PowerShell@2
  displayName: '发送执行结果到Teams'
  inputs:
    targetType: 'inline'
    script: |
      $exitCode = $LASTEXITCODE
      # 构造通知内容
      if ($exitCode -eq 0) {
        $msg = "✅ 远程脚本执行成功`n目标机器：$(RemoteMachineIP)`n执行时间：$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
      } else {
        $msg = "❌ 远程脚本执行失败`n目标机器：$(RemoteMachineIP)`n错误代码：$exitCode`n执行时间：$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
      }
      # 发送到Teams
      $body = ConvertTo-Json @{ text = $msg }
      Invoke-RestMethod -Uri $(TeamsWebhookURL) -Method Post -Body $body -ContentType 'application/json'
  condition: always() # 无论前面任务成功失败，都执行此通知任务

四、关键注意事项 #

• 若Azure Pipeline代理机器不在目标机器的信任列表中，需在目标机器执行Set-Item WSMan:\localhost\Client\TrustedHosts -Value "$(AgentIP)" -Concatenate添加信任主机
• 若使用HTTPS的WinRM连接，需在目标机器配置有效的SSL证书，避免出现证书验证错误
• 所有敏感信息（账号、密码、Webhook URL）必须设置为Azure Pipeline的保密变量，不会在日志中明文显示
• 可在远程脚本中添加错误捕获逻辑，将详细错误信息传回Pipeline，再整合到Teams通知中

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