远程部署工具ZEQP-PSDeploy

Giant1502026-07-05 21:50

PowerShell Deploy

开原地址：https://github.com/ZEQP/ZEQP-PSDeploy

本地项目直接部署远程服务器，支持IIS站点、Windows服务、文件发布

安装

把此代码下载或通过git clone到本地

然后在目录下面以管理员方式运行Install.ps1

powershell 复制代码 
git clone https://github.com/ZEQP/ZEQP-PSDeploy.git
cd .\ZEQP-PSDeploy
.\Install.ps1

创建/关闭PSSession

powershell 复制代码 
#通过弹出框输入密码
$Credential = Get-Credential -UserName "Administrator" -Message "请输入部署服务器的用户名和密码"
#默认用HTTP-5985端口
$Session = New-PSSession -ComputerName 10.100.12.100 -Credential $Credential
#中间过程处理 TODO
#处理完成后关闭连接
Remove-PSSession -Session $Session
powershell 复制代码 
#直接创建PSSession
$Password = ConvertTo-SecureString "{PassWord}" -AsPlainText -Force
$Credential = New-Object System.Management.Automation.PSCredential("Administrator", $Password)
##默认用HTTPS-5986端口
$SessionOption = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck
$Session = New-PSSession -ComputerName 10.100.12.100 -Port 5986 -Credential $Credential -UseSSL -SessionOption $SessionOption
#中间过程处理 TODO
#处理完成后关闭连接
Remove-PSSession -Session $Session

自动编译然后发布到指定服务器IIS站点

示例为dotnet后端项目，实际支持任意言语项目，只用写特定语言的编译发布命令就行

powershell 复制代码 
Start-DeployIIS -Session $Session -WebSiteName MyAPPWebSite -WebSitePort 8080 -ScriptBlock {
    param($o) dotnet publish -o $o -c "Debug" -f net8.0 --no-self-contained -v m --nologo /p:EnvironmentName=Test
} -OutputPath .\bin\publish\ -RemotePath "D:\Publish\"

前端项目

示例为nodejs的项目用yarn编译，实际支持任意言语项目，只用写特定语言的编译发布命令就行

powershell 复制代码 
Start-DeployIIS -Session $Session -WebSiteName MyUIWebSite -WebSitePort 8081 -ScriptBlock { 
    yarn run build:test 
} -OutputPath .\dist\ -RemotePath "D:\Publish\"

自动编译然后发布为服务

powershell 复制代码 
Start-DeploySvc -Session $Session -ServiceName MyAPPService -BinaryName "MyAPPService.exe --environment Test" -ScriptBlock { 
    param($o) dotnet publish -o $o -c "Debug" -f net8.0 --no-self-contained -v m --nologo -p:EnvironmentName=Test
} -OutputPath .\bin\publish\ -RemotePath "D:\Publish\"

直接部署文件

powershell 复制代码 
#直接把DeployFile目录复制到服务器Publish目录下面,实际路径为D:\Publish\DeployFile
Start-DeployFile -Session $Session -Path D:\DeployFile\ -RemotePath "D:\Publish" -Compress

#直接把DeployFile目录下所有文件复制到服务器D:\Publish\DeployFile目录下面
Start-DeployFile -Session $Session -Path D:\DeployFile\* -RemotePath "D:\Publish\DeployFile" -Compress

示例

直接部署IIS站点

在目录下创建PowerShell脚本文件Deploy.ps1

powershell 复制代码 
$Credential = Get-Credential -UserName "Administrator" -Message "请输入部署服务器的用户名和密码"
$SessionOption = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck
$Session = New-PSSession -ComputerName 10.100.12.100 -Port 5986 -Credential $Credential -UseSSL -SessionOption $SessionOption
Start-DeployIIS -Session $Session -WebSiteName MyAPPWebSite -WebSitePort 8050 -ScriptBlock {
    param($o) dotnet publish -o $o -c "Release" -f net8.0 --no-self-contained --no-restore -v m --nologo /p:EnvironmentName=Production
} -OutputPath .\bin\publish\ -RemotePath "D:\Publish\"
Remove-PSSession -Session $Session

直接部署Windows服务

在目录下创建PowerShell脚本文件Deploy.ps1

powershell 复制代码 
$Credential = Get-Credential -UserName "Administrator" -Message "请输入部署服务器的用户名和密码"
$SessionOption = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck
$Session = New-PSSession -ComputerName 10.100.12.100 -Port 5986 -Credential $Credential -UseSSL -SessionOption $SessionOption
Start-DeploySvc -Session $Session -ServiceName MyAPPService -BinaryName "MyAPPService.exe --environment Production" -ScriptBlock { 
    param($o) dotnet publish -o $o -c "Release" -f net8.0 --no-self-contained --no-restore -v m --nologo -p:EnvironmentName=Production
} -OutputPath .\bin\publish\ -RemotePath "D:\Publish\"
Remove-PSSession -Session $Session

批量部署多个服务

在目录下创建PowerShell脚本文件Deploy.ps1

powershell 复制代码 
$Credential = Get-Credential -UserName "Administrator" -Message "请输入部署服务器的用户名和密码"
$SessionOption = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck
$Session = New-PSSession -ComputerName 10.100.12.100 -Port 5986 -Credential $Credential -UseSSL -SessionOption $SessionOption

#进入MyAPPWebSite目录下编译
Set-Location -Path $MyAPPWebSitePath
Start-DeployIIS -Session $Session -WebSiteName MyAPPWebSite -WebSitePort 8050 -ScriptBlock {
    param($o) dotnet publish -o $o -c "Release" -f net8.0 --no-self-contained --no-restore -v m --nologo /p:EnvironmentName=Production
} -OutputPath .\bin\publish\ -RemotePath "D:\Publish\"

#进入MyAPPService目录下编译
Set-Location -Path $MyAPPServicePath
Start-DeploySvc -Session $Session -ServiceName MyAPPService -BinaryName "MyAPPService.exe --environment Production" -ScriptBlock { 
    param($o) dotnet publish -o $o -c "Release" -f net8.0 --no-self-contained --no-restore -v m --nologo -p:EnvironmentName=Production
} -OutputPath .\bin\publish\ -RemotePath "D:\Publish\"

Remove-PSSession -Session $Session

方法描述

Start-DeployIIS

Start-DeployIIS 用于本地构建并自动部署到远程 IIS 网站，参数说明如下：

  • -Session <PSSession>：远程 PowerShell 会话对象，必须已打开并连接到目标服务器。脚本会在该会话中创建、停止、启动 IIS 站点并上传 ZIP 文件。
  • -ScriptBlock <ScriptBlock>：本地构建脚本块，用于生成部署产物。ScriptBlock 内通常使用 param($o) 接收输出目录，并将构建结果写入 -OutputPath 指定的目录。
  • -OutputPath <string>：本地输出目录。脚本会检查路径是否存在，不存在则创建，存在则清空目录后执行构建，并将输出文件压缩为 ZIP 包。
  • -WebSiteName <string>：目标 IIS 网站名称。脚本会尝试查找该站点，若不存在则新建；部署时会将内容解压到远程目录中的同名子目录。
  • -WebSitePort <string>：目标 IIS 网站端口，用于创建新站点时绑定端口。若站点已存在，则不会修改现有绑定。
  • -RemotePath <string>：目标服务器的远程发布目录，默认值为 D:\Publish\。ZIP 文件会上传到此目录，然后在目标服务器上解压到 RemotePath\WebSiteName。

脚本执行流程：

  1. 检查并准备本地 OutputPath。
  2. 执行 ScriptBlock 生成部署文件。
  3. 压缩 OutputPath 内容为 ZIP。
  4. 上传 ZIP 到远程服务器 RemotePath。
  5. 查找或创建指定 WebSiteName 的 IIS 站点。
  6. 停止网站、清理旧文件、解压新文件，并重新启动网站。

Start-DeploySvc

Start-DeploySvc 用于本地构建并自动部署到远程 Windows 服务，参数说明如下：

  • -Session <PSSession>：远程 PowerShell 会话对象，必须已打开并连接到目标服务器。脚本会在该会话中创建、停止、启动服务并上传 ZIP 文件。
  • -ScriptBlock <ScriptBlock>：本地构建脚本块，用于生成部署产物。ScriptBlock 内通常使用 param($o) 接收输出目录，并将构建结果写入 -OutputPath 指定的目录。
  • -OutputPath <string>：本地输出目录。脚本会检查路径是否存在，不存在则创建，存在则清空目录后执行构建，并将输出文件压缩为 ZIP 包。
  • -ServiceName <string>：目标 Windows 服务名称。脚本会尝试查找该服务，若不存在则新建；部署时会将内容解压到远程目录中的同名子目录。
  • -BinaryName <string>：服务可执行文件名称及启动参数，例如 "Giant.DI.exe --environment Test"。该值用于创建服务时的 ImagePath。
  • -RemotePath <string>：目标服务器的远程发布目录，默认值为 D:\Publish\。ZIP 文件会上传到此目录，然后在目标服务器上解压到 RemotePath\ServiceName。

脚本执行流程：

  1. 检查并准备本地 OutputPath。
  2. 执行 ScriptBlock 生成部署文件。
  3. 压缩 OutputPath 内容为 ZIP。
  4. 上传 ZIP 到远程服务器 RemotePath。
  5. 查找或创建指定 ServiceName 的 Windows 服务。
  6. 停止服务、清理旧文件、解压新文件，并重新启动服务。

Start-DeployFile

Start-DeployFile 用于将本地文件或目录直接发布到远程服务器，可选压缩上传并支持本地/远程前后置脚本，参数说明如下：

  • -Session <PSSession>：远程 PowerShell 会话对象，必须已打开并连接到目标服务器。该参数用于远程文件复制和执行远程脚本。
  • -Path <string>：本地文件或目录路径。可以是目录、文件或通配符路径（例如 D:\DeployFile\*）。脚本会在本地验证该路径是否存在。
  • -RemotePath <string>：目标服务器上的发布目录。上传时会将文件复制到该目录；如果目录不存在，脚本会自动创建。
  • -Compress <switch>：是否先将本地文件/目录压缩为 ZIP 后再上传。启用后，会上传压缩包并在远程服务器上解压。
  • -ScriptLocalStart <ScriptBlock>：本地前置脚本块，会在文件上传前执行，通常用于准备或清理 -Path 指定目录。
  • -ScriptLocalEnd <ScriptBlock>：本地后置脚本块，会在文件上传和远程脚本执行后执行，通常用于本地清理或记录日志。
  • -ScriptRemoteStart <ScriptBlock>：远程前置脚本块，会在文件上传到远程目录后执行，适用于远程初始化或预处理。
  • -ScriptRemoteEnd <ScriptBlock>：远程后置脚本块，会在文件上传完成并解压后执行，适用于启动服务、修改权限或后续处理。

脚本执行流程：

  1. 验证本地 -Path 是否存在。
  2. 执行可选本地前置脚本 -ScriptLocalStart。
  3. 如果启用 -Compress，则先将指定路径压缩为 ZIP。
  4. 在远程服务器上创建或校验 -RemotePath。
  5. 上传文件或 ZIP 到远程目录。
  6. 可选执行远程前置脚本 -ScriptRemoteStart。
  7. 如果启用了压缩，远程解压 ZIP 文件到目标目录。
  8. 可选执行远程后置脚本 -ScriptRemoteEnd。
  9. 可选执行本地后置脚本 -ScriptLocalEnd。

前置条件

连接到指定的服务器，是运用了PowerShell的运程管理功能

此功能是需要在对应服务器开启PowerShell运程管理功能

(Win服务里面有个WinRM的服务 显示名称：Windows Remote Management (WS-Management))

服务器打开防火墙入站规则"WinRM远程管理",HTTP端口为5985,HTTPS端口为5986

powershell 复制代码 
#先把网络设备为专用网络
Get-NetConnectionProfile
#修改单个网络为专用网络
Set-NetConnectionProfile -Name "{指定网络名称}" -NetworkCategory Private
#修改所有网络为专用网络
# Get-NetConnectionProfile | Set-NetConnectionProfile -NetworkCategory Private

#在远程服务器运行此命令（用PowerShell以管理员方式运行）
Enable-PSRemoting
#信任指定host。*为所有  （本机和服务器都运行）
Set-Item WSMan:\localhost\Client\TrustedHosts -Value *

# 增加https监听(需要证书)(可选)
$MachineName = [System.Environment]::MachineName
$Cer = Get-ChildItem -Path Cert:\LocalMachine\My\ | Where-Object {$_.Subject -like "CN=$MachineName*"}
$Thumbprint = $Cer[0].Thumbprint
New-Item WSMan:\localhost\Listener\ -Transport HTTPS -Address * -CertificateThumbPrint $Thumbprint
#打开WinRM HTTPS的5986端口
New-NetFirewallRule -Name "WinRM HTTPS 5986" -DisplayName "WinRM HTTPS 5986" -Action Allow -Protocol TCP -LocalPort 5986 -Direction Inbound

参考文档

介绍如何对 PowerShell 中的远程操作进行故障排除

热门推荐
01GitHub 镜像站点022026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf03AI科技热点日报 | 2026年07月01日04【AI】2026 年具身智能模型和世界模型总结052026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？062026 年 AI 大模型 & AI 编程工具实战全总结072026年6月AI大模型全景报告：GPT-5.6、Claude Opus 4.8、Gemini 3.5，中美AI三足鼎立谁主沉浮？08Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费09Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析102026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？