refactor: 入口改名(Backup/Restore -> Backup-Data/Restore-Data)+ 只留一轮的垫片
git mv 保留历史。旧名字留薄垫片:入口脚本是**外部接口**(README 二十多处引用、使用者的肌肉记忆、注册脚本里的路径),内部实现改名断了会当场报错,外部接口改名断了是静默没用 —— 后者对备份工具尤其不能接受(ADR-0012)。 垫片踩到四个坑,全部由门禁报出(E2E 与 Pester 集成用例本来就是通过子进程调这两个入口的,于是它们原封不动成了垫片的验收):① `& script.ps1` 里子脚本的 exit 不会把退出码传到父脚本的 $LASTEXITCODE —— 会把失败变成成功,而计划任务靠退出码判断成败;② 调用方传 -Verbose 时垫片里的 Import-Module 会多打一行加载信息,顶掉测试的输出断言;③ 不重定向时子进程的输出到不了调用方(父进程的 stdout 常常是管道,而 .NET 起的进程默认只继承控制台)—— 改成显式重定向 + 异步读转发(同步先读 stdout 再读 stderr 会在管道写满时死锁);④ **`[CmdletBinding()]` 会把 -Verbose 当通用参数绑走,它不会落进 $Rest,于是没被转发给子进程** —— 而测试正是靠 -Verbose 拿那条 VERBOSE 级日志的。现在显式把 -Verbose / -Debug 加进转发参数。 参数引号化用模块自己的 ConvertTo-BakNRetNativeArgumentString(5.1 上 ProcessStartInfo.ArgumentList 不存在)。tools\Register-BackupTask.ps1 已同步改指 Backup-Data.ps1(4 处)。 门禁新增一条机械检查:**源码里不得出现"左边空的赋值"** —— 它是"用双引号拼代码导致 $变量 被插值成空"那个坑的指纹(合法语法、Parse 层抓不到、只有跑到才炸,同一块代码里出现过五次)。垫片全部用单引号 here-string 生成,零插值。 验收:test.ps1 9/9 全绿(5.1 与 7);真实清单只读冒烟 4/4。
This commit is contained in:
1 parent
5df40d3341
commit
4e3c0461c0
6 files changed
+1824
-1678
No files matched your search
@@ -3,7 +3,7 @@
|
||||
注册 / 移除 BakNRet 的每日备份计划任务。
|
||||
|
||||
.DESCRIPTION
|
||||
任务直接调用 Backup.ps1。脚本自身会写日志并按失败数返回退出码,
|
||||
任务直接调用 Backup-Data.ps1。脚本自身会写日志并按失败数返回退出码,
|
||||
因此「上次运行结果」在任务计划程序里是可读的,不需要额外包装。
|
||||
|
||||
注册计划任务需要管理员权限(本脚本不自己提权,请从管理员终端运行)。
|
||||
@@ -27,7 +27,7 @@ param(
|
||||
[ValidatePattern('^\d{1,2}:\d{2}$')]
|
||||
[string]$At = '21:30',
|
||||
|
||||
# 额外传给 Backup.ps1 的参数,例如 @('-Snapshot')
|
||||
# 额外传给 Backup-Data.ps1 的参数,例如 @('-Snapshot')
|
||||
[string[]]$BackupArgument = @(),
|
||||
|
||||
[ValidateSet('S4U', 'Interactive')]
|
||||
@@ -43,10 +43,10 @@ param(
|
||||
$ErrorActionPreference = 'Stop'
|
||||
|
||||
$projectRoot = Split-Path -Parent $PSScriptRoot
|
||||
$backupScript = Join-Path $projectRoot 'Backup.ps1'
|
||||
$backupScript = Join-Path $projectRoot 'Backup-Data.ps1'
|
||||
|
||||
if (-not (Test-Path -LiteralPath $backupScript)) {
|
||||
Write-Error "找不到 Backup.ps1:$backupScript"
|
||||
Write-Error "找不到 Backup-Data.ps1:$backupScript"
|
||||
exit 1
|
||||
}
|
||||
|
||||
|
||||
Reference in new issue
Block a user