Windows 命令详解（五）：批处理与 PowerShell 常用写法速查表

前四篇讲的是单条命令。这一篇讲怎么把它们组织起来干活：批处理（.bat）的变量、条件、循环、参数与返回码，以及 PowerShell 里那批日常要用的 cmdlet、管道、比较运算符和执行策略。

两边的定位区别一句话说清：批处理够轻——双击就能跑，不需要任何策略设置，适合「固定几步的自动化」；PowerShell 强在对象与管道，处理「筛选、汇总、格式化输出」这类活儿比批处理省力得多。语法与行为照旧取自微软官方文档（Windows Commands 参考 + PowerShell 官方文档），出处列在文末。

一、批处理的骨架

setlocal 有一个很实用的开关：setlocal enabledelayedexpansion 打开延迟展开。批处理在解析一整行（或一整个 for/if 块）时就把 %变量% 替换成了当时的值，所以块里现改现用的变量拿不到新值；开了延迟展开后可以用 !变量! 取运行时的当前值。写循环里累加、拼接字符串这类逻辑时几乎必然会用到它。

if 的几种形式

if errorlevel 的「大于等于」语义是最容易踩的坑：if errorlevel 1 在退出码是 2、3 时同样成立。要精确判等就用 %errorlevel% 配合比较符，例如 if %errorlevel% equ 2 ...。另外 if defined <变量> 成立时，环境里会多出 %errorlevel%、%cmdcmdline%、%cmdextversion% 这几个变量——这是官方 Remarks 里写明的。

判断外部工具的退出码还要知道各自的约定。比如第一篇里讲过 robocopy 返回 0~7 都算正常、只有 ≥ 8 才是失败，所以在批处理里写 if errorlevel 8 才是「真出错」；而 findstr 找不到匹配时返回 1，用 if errorlevel 1 判断就会把「没找到」和「出错」混在一起。

for 的四种扩展形式

命令扩展开启时（默认开启），for 还有这几种形态：

for /f 的「集合」有三种写法，对应三种数据来源：文件（in (file.txt)）、字面字符串（in ("字符串")）、命令输出（in ('命令')）。用 usebackq 之后引号规则会反转：反引号里的当命令、单引号里的当字面字符串、双引号里的当含空格的文件名。

for /f 的解析关键字（官方表）：

默认情况下 for /f 只取每行第一个以空格分隔的字段，跳过空行。所以处理 CSV 这类数据时 delims=, 和 tokens= 是最常写的两个。

参数与文件的修饰符

批处理参数（%1、%2……）和 for 的循环变量都能加 %~ 修饰符，官方 call 与 for 页面都给了一整表：

写脚本时最常用的一个组合是 %~dp0：%~d0 是脚本所在盘符、%~p0 是脚本所在路径，合起来就是「脚本自己所在的目录」——用它拼路径，脚本被移动到哪儿都能找到自己的配套文件。注意 %~ 修饰符不能和 %* 一起用。

二、PowerShell 常用 cmdlet

两个使用上的要点：

Test-Connection 是新版 PowerShell 里替代老 ping/Test-NetConnection 的那一条，-TcpPort 正是第三篇里「telnet 手工测端口」的替代方案，不用装 telnet 客户端也能验端口是否开放。-Quiet 只回 True/False，写脚本判断时最省事。

Remove-Item、Stop-Process、Set-Service 这些会改东西的 cmdlet 都支持 -WhatIf 和 -Confirm，-WhatIf 只打印「将会做什么」而不动手，是批量清理前最便宜的保险。

三、管道与比较运算符

管道把上一条命令的输出直接交给下一条处理（官方 about_Pipelines 的写法是 Command-1 | Command-2 | Command-3），最典型的一行是 Get-Process notepad | Stop-Process——查出记事本进程直接结束掉，中间不需要复制粘贴 PID。

比较运算符（官方 about_Comparison_Operators 收录）在 PowerShell 里是字母形式，不是 > <：

为什么 PowerShell 要另起一套：在它里面 > 是重定向输出到文件，如果 > 同时还是「大于」，Get-Process > out.txt 这种写法就会变得没法解释。所以比较一律用字母形式。

一行上下文的例子：

# 找出最近一天修改过、体积超过 1MB 的日志文件，按大小倒序取前 10 个
Get-ChildItem D:\logs -Filter *.log -Recurse |
    Where-Object { $_.LastWriteTime -gt (Get-Date).AddDays(-1) -and $_.Length -gt 1MB } |
    Sort-Object Length -Descending |
    Select-Object -First 10 FullName,Length,LastWriteTime

四、执行策略（脚本跑不起来多半是它）

PowerShell 默认不允许随便运行脚本文件，这就是「明明双击能跑但脚本报错不让运行」的原因。官方文档给出的取值：

作用域（-Scope）与优先级，官方给的是从高到低：

MachinePolicy 与 UserPolicy 是由组策略下发的，手动去设这两个作用域会被拒绝——这也是为什么有时候「改了策略还是被拦」：组策略的优先级比你手动设的高。

日常最省事的做法是只给当前用户放宽：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，不要去动 LocalMachine。跑一个下载来的脚本被拦时，先确认来源可靠，再用 Unblock-File 解除「来自互联网」的标记，比直接把策略改成 Unrestricted 安全得多。

五、两个能直接改的模板

把前四篇的命令组织成脚本，大致就是这个样子。

批处理版：把某目录整体备份到另一块盘，失败时返回非零并留下日志。

@echo off
chcp 65001 >nul
setlocal enabledelayedexpansion
rem 用法：backup.bat "源目录" "目标目录"
if "%~1"=="" goto usage
if "%~2"=="" goto usage

set "SRC=%~1"
set "DST=%~2"
rem 日志名里的日期按本机区域设置截取 %DATE%；%DATE% 格式不同的系统上如果名字不对，改成固定文件名即可
set "LOG=%~dp0backup-%DATE:~0,4%%DATE:~5,2%%DATE:~8,2%.log"

echo [%DATE% %TIME%] 开始备份 %SRC% -> %DST%
robocopy "%SRC%" "%DST%" /E /R:2 /W:5 /NP /LOG:"%LOG%"

rem robocopy 的 0~7 都算正常，只有 >=8 才是失败
if errorlevel 8 (
    echo [%DATE% %TIME%] 备份失败，详见 %LOG%
    exit /b 8
)
echo [%DATE% %TIME%] 备份完成，日志：%LOG%
exit /b 0

:usage
echo 用法：%~nx0 "源目录" "目标目录"
exit /b 2

几个细节：%~dp0 让日志文件默认落在脚本所在目录；if errorlevel 8 用的是「大于等于」语义，正好匹配第一篇里讲过的 robocopy 返回码口径；不同的退出码（0 成功 / 8 备份失败 / 2 参数错）让上层调度程序能区分失败原因。

PowerShell 版：做同一件事，外加「跑之前先看有没有空间」。

# 用法：.\backup.ps1 -Source D:\data -Destination E:\bak
[CmdletBinding()]
param(
    [Parameter(Mandatory)][string]$Source,
    [Parameter(Mandatory)][string]$Destination
)

$ErrorActionPreference = 'Stop'
$log = Join-Path $PSScriptRoot ('backup-' + (Get-Date -Format 'yyyyMMdd-HHmmss') + '.log')

if (-not (Test-Path -LiteralPath $Source))                      { Write-Error "源目录不存在：$Source";               exit 2 }
if (-not (Test-Path -LiteralPath $Destination))                 { Write-Error "目标目录不存在：$Destination";         exit 2 }

$need = (Get-ChildItem -LiteralPath $Source -Recurse -File | Measure-Object -Property Length -Sum).Sum
$free = (Get-PSDrive -Name ([System.IO.Path]::GetPathRoot($Destination).TrimEnd(':\'))).Free
if ($free -lt $need) { Write-Error ('空间不足：需要 ' + [math]::Round($need/1MB) + ' MB，可用 ' + [math]::Round($free/1MB) + ' MB'); exit 3 }

"$(Get-Date -Format 'HH:mm:ss') 开始备份 $Source -> $Destination" | Tee-Object -FilePath $log
robocopy $Source $Destination /E /R:2 /W:5 /NP /LOG+:$log
if ($LASTEXITCODE -ge 8) { Write-Error "备份失败，返回码 $LASTEXITCODE，详见 $log"; exit 8 }

"$(Get-Date -Format 'HH:mm:ss') 备份完成" | Tee-Object -FilePath $log
exit 0

PowerShell 里判断外部程序的退出码要用 $LASTEXITCODE（它只反映最近一次外部可执行文件的退出码），而不是 $?——$? 反映的是「上一条 PowerShell 语句是否成功」，两者不是一回事。

跑之前记得看一眼执行策略：Get-ExecutionPolicy。策略是 Restricted 时按上一节的办法给当前用户放宽；脚本是从别处下载来的，先 Unblock-File 再跑。

六、这个系列的其它几篇

• Windows 命令详解（一）：文件与目录操作常用命令速查表
• Windows 命令详解（二）：系统信息、进程与服务管理命令速查表
• Windows 命令详解（三）：网络诊断与配置命令速查表
• Windows 命令详解（四）：磁盘与系统维护命令速查表

七、出处

批处理部分：微软官方 Windows Commands 参考（https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/）下的 if、for、call、goto、shift、choice、timeout、setlocal、endlocal、rem、echo、set、verify、exit、pause、start、doskey、findstr、find、forfiles、robocopy。

几条重点页面：

• if（含 errorlevel 的「大于等于」语义）：https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/if
• for（含 /d、/r、/l、/f 与解析关键字表、变量修饰符表）：https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/for
• call（含参数修饰符表）：https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/call
• choice：https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/choice

PowerShell 部分：微软官方 PowerShell 文档（https://learn.microsoft.com/en-us/powershell/module/），版本口径为 PowerShell 7.5：

• about_Execution_Policies（执行策略取值与作用域优先级）：https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies
• about_Pipelines：https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_pipelines
• about_Comparison_Operators（比较运算符表）：https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_comparison_operators
• Test-Connection（含 -TcpPort、-Traceroute）：https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.management/test-connection

文中的 cmdlet 语法与参数名逐条核对自对应的官方 cmdlet 页面：Get-Command、Get-Help、Get-ChildItem、Set-Location、Get-Content、Set-Content、Copy-Item、Remove-Item、Select-String、Where-Object、ForEach-Object、Select-Object、Sort-Object、Measure-Object、Get-Member、Get-Process、Stop-Process、Get-Service、Start-Service、Set-Service、Get-WinEvent、Invoke-WebRequest、Set-ExecutionPolicy。