命令行与文本处理 / 系统课时

使用 ForEach-Object 转换

使用 ForEach-Object 转换

ForEach-Object 用来逐个处理管道中的对象。学完本课,你将能使用 $_ 读取当前对象,生成新的对象或计算字段,并分清“转换数据”和“产生副作用”两类用法。

学习目标

  • 使用 ForEach-Object 对每个管道对象执行脚本块
  • 理解 $_、$PSItem 与外部变量的作用
  • 在转换、计算和副作用之间做出合适选择

基本工作方式

ForEach-Object 接收上游对象,并为每个对象执行一次 -Process 脚本块。脚本块最后写入成功输出流的内容,会继续进入下游管道;没有输出的语句只完成内部操作。

当前对象可通过 $_ 访问,$PSItem 是它的完整别名。二者含义相同,常用写法是 $_.PropertyName。% 虽然是命令别名,但教学脚本和生产脚本更适合写完整名称,以便阅读和搜索。

转换对象并计算字段

下面把订单金额转换为带序号、税额和含税总额的新对象。$sequence++ 修改了脚本块外部变量,属于副作用;创建 [pscustomobject] 则是管道转换的主要结果。

powershell
$orders = @(
    [pscustomobject]@{ OrderNo = 'A1001'; Amount = 120 }
    [pscustomobject]@{ OrderNo = 'A1002'; Amount = 75 }
    [pscustomobject]@{ OrderNo = 'A1003'; Amount = 200 }
)

$sequence = 0

$result = $orders | ForEach-Object {
    $sequence++
    $tax = [math]::Round($_.Amount * 0.06, 2)

    [pscustomobject]@{
        Sequence = $sequence
        OrderNo  = $_.OrderNo
        Amount   = $_.Amount
        Tax      = $tax
        Total    = [math]::Round($_.Amount + $tax, 2)
    }
}

$result | ForEach-Object {
    '{0}|{1}|{2:F2}|{3:F2}|{4:F2}' -f $_.Sequence, $_.OrderNo, $_.Amount, $_.Tax, $_.Total
}

预期输出

text
1|A1001|120.00|7.20|127.20
2|A1002|75.00|4.50|79.50
3|A1003|200.00|12.00|212.00

实际输出中的小数点符号可能受系统区域设置影响。示例通过格式字符串固定两位小数,但部分区域可能显示逗号作为小数分隔符。

自动变量与脚本块阶段

最常用形式只有一个脚本块,它等价于 -Process。需要初始化资源或最后汇总时,可以显式使用 -Begin、-Process 和 -End:Begin 执行一次,Process 对每个输入执行一次,End 在输入结束后执行一次。

$_ 只在处理当前管道对象的上下文中有意义。若在脚本块外读取它,通常得不到期望值。外部变量可以在脚本块内读取和修改,但并行处理或远程执行时需要重新考虑变量作用域与线程安全。

转换与副作用的边界

生成新对象、修改字段或格式化值属于转换,适合继续传给 Where-Object、Sort-Object 或导出命令。写日志、更新文件、调用外部接口和修改计数器属于副作用,应保证失败可发现、重复执行可接受。

不要在同一个复杂脚本块中同时完成大量转换和外部写入。更稳妥的做法是先构造结果对象并验证,再单独执行保存或调用操作,这样更容易重试和测试。

常见错误

把 ForEach-Object 与语言关键字 foreach 混为一谈是最常见的问题。前者按管道逐个处理,适合流式组合;后者遍历已存在的集合,语法更直接,通常也更容易调试。

另一个错误是在脚本块中使用 return 期待终止整个脚本。这里的 return 只结束当前脚本块调用;若要过滤对象,应明确使用 Where-Object,若要终止脚本,应根据场景使用 throw、break 或外层控制逻辑。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 ForEach-Object 转换

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通