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

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

git clone https://github.com/ZEQP/ZEQP-PSDeploy.git
cd .\ZEQP-PSDeploy
.\Install.ps1
创建/关闭PSSession
#通过弹出框输入密码
$Credential = Get-Credential -UserName “Administrator” -Message “请输入部署服务器的用户名和密码”
#默认用HTTP-5985端口
$Session = New-PSSession -ComputerName 10.100.12.100 -Credential $Credential
#中间过程处理 TODO
#处理完成后关闭连接
Remove-PSSession -Session $Session
#直接创建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后端项目，实际支持任意言语项目，只用写特定语言的编译发布命令就行

Start-DeployIIS -SessionKaTeX parse error: Expected '}', got 'EOF' at end of input: …ck { 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编译，实际支持任意言语项目，只用写特定语言的编译发布命令就行

Start-DeployIIS -Session $Session -WebSiteName MyUIWebSite -WebSitePort 8081 -ScriptBlock {
yarn run build:test
} -OutputPath .\dist\ -RemotePath “D:\Publish”
自动编译然后发布为服务
Start-DeploySvc -SessionKaTeX parse error: Expected '}', got 'EOF' at end of input: …k { 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”
直接部署文件
#直接把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

$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 -SessionKaTeX parse error: Expected '}', got 'EOF' at end of input: …ck { 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

$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 -SessionKaTeX parse error: Expected '}', got 'EOF' at end of input: …k { 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

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

检查并准备本地 OutputPath。
执行 ScriptBlock 生成部署文件。
压缩 OutputPath 内容为 ZIP。
上传 ZIP 到远程服务器 RemotePath。
查找或创建指定 WebSiteName 的 IIS 站点。
停止网站、清理旧文件、解压新文件，并重新启动网站。
Start-DeploySvc
Start-DeploySvc 用于本地构建并自动部署到远程 Windows 服务，参数说明如下：

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

检查并准备本地 OutputPath。
执行 ScriptBlock 生成部署文件。
压缩 OutputPath 内容为 ZIP。
上传 ZIP 到远程服务器 RemotePath。
查找或创建指定 ServiceName 的 Windows 服务。
停止服务、清理旧文件、解压新文件，并重新启动服务。
Start-DeployFile
Start-DeployFile 用于将本地文件或目录直接发布到远程服务器，可选压缩上传并支持本地/远程前后置脚本，参数说明如下：

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

验证本地 -Path 是否存在。
执行可选本地前置脚本 -ScriptLocalStart。
如果启用 -Compress，则先将指定路径压缩为 ZIP。
在远程服务器上创建或校验 -RemotePath。
上传文件或 ZIP 到远程目录。
可选执行远程前置脚本 -ScriptRemoteStart。
如果启用了压缩，远程解压 ZIP 文件到目标目录。
可选执行远程后置脚本 -ScriptRemoteEnd。
可选执行本地后置脚本 -ScriptLocalEnd。
前置条件
连接到指定的服务器，是运用了PowerShell的运程管理功能

此功能是需要在对应服务器开启PowerShell运程管理功能
(Win服务里面有个WinRM的服务 显示名称：Windows Remote Management (WS-Management))

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

#先把网络设备为专用网络
Get-NetConnectionProfile
#修改单个网络为专用网络
Set-NetConnectionProfile -Name “{指定网络名称}” -NetworkCategory Private
#修改所有网络为专用网络

Get-NetConnectionProfile | Set-NetConnectionProfile -NetworkCategory Private

#在远程服务器运行此命令（用PowerShell以管理员方式运行）
Enable-PSRemoting
也可以用下面的参数，忽略网络环境检查，不管内外网环境
Enable-PSRemoting -SkipNetworkProfileCheck -Force
#信任指定host。*为所有 （本机和服务器都运行）
Set-Item WSMan:\localhost\Client\TrustedHosts -Value *

增加https监听(需要证书)(可选)

$MachineName = [System.Environment]::MachineName
KaTeX parse error: Undefined control sequence: \LocalMachine at position 32: …tem -Path Cert:\̲L̲o̲c̲a̲l̲M̲a̲c̲h̲i̲n̲e̲\My\ | Where-Ob…_.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 -Protoc