如何让PowerShell管道中的对象属性支持自动补全？

问题核心 #

自定义的Find-MyFile脚本输出System.IO.FileInfo对象，但后续管道中使用Select-Object时，无法通过TAB键补全该对象的属性（比如输入lastw按TAB无法补全为LastWriteTime）。

原因 #

PowerShell的属性TAB补全依赖于提前识别命令/脚本的输出对象类型。默认情况下，自定义脚本没有明确声明输出类型，PowerShell无法预加载对应对象的属性信息，因此无法触发补全。

解决方法（无需格式化XML） #

格式化XML文件（.ps1xml）仅用于定制对象的显示格式，和属性补全无关，不需要创建。只需给脚本添加输出类型声明即可：

• 如果是函数形式的脚本，在函数定义前添加[OutputType([System.IO.FileInfo])]声明，让PowerShell提前识别输出类型：

  [OutputType([System.IO.FileInfo])]
  function Find-MyFile {
      param(
          [string]$SearchPath
      )
      # 示例逻辑：返回指定路径下的文件
      Get-ChildItem -Path $SearchPath -File
  }
  

• 如果是独立的.ps1脚本文件，建议将逻辑封装为函数并添加上述声明；也可以在脚本开头直接添加输出类型声明，但封装为函数的识别效果更稳定。

• 确保使用PowerShell 5.1及以上版本（包括PowerShell Core 7+），这类版本完全支持通过OutputType触发属性补全。

内容的提问来源于stack exchange，提问作者lit