PowerShell-Docs项目中Invoke-WebRequest的PassThru参数问题解析

在Windows PowerShell 5.1版本中，Invoke-WebRequest和Invoke-RestMethod两个核心命令曾存在一个值得注意的参数行为问题。这个问题最初在PowerShell 7.0至7.2版本的文档中得到了修正说明，但Windows PowerShell 5.1版本的文档却遗漏了这一重要说明。

PassThru参数在这两个命令中设计用于控制是否返回完整的HTTP响应对象。当用户不指定此参数时，Invoke-WebRequest默认会返回完整的响应对象，而Invoke-RestMethod则会对响应内容进行解析转换。然而，在Windows PowerShell 5.1及早期7.x版本中，PassThru参数的实际行为与文档描述存在差异。

具体来说，当用户显式设置PassThru参数为$false时，命令仍会返回完整的响应对象，这与参数设计的预期行为不符。这个问题在后续版本中得到了修复，文档也相应更新，但Windows PowerShell 5.1版本的Invoke-WebRequest文档却未能同步这一变更。

对于仍在使用Windows PowerShell 5.1的用户来说，了解这一行为差异非常重要。在实际使用中，无论是否设置PassThru参数，Invoke-WebRequest都会返回完整的响应对象。这意味着开发者不能依赖PassThru参数来控制返回类型，而需要在代码中自行处理响应对象。

这个问题虽然不会导致功能失效，但可能影响代码的可读性和维护性。建议开发者在使用时注意这一行为特性，或者考虑升级到更高版本的PowerShell以获得更一致的行为。