如何测试调用带-File参数Get-ChildItem的PowerShell函数？

错误原因 #

出现ParameterBindingException: 找不到与参数名称“File”匹配的参数的核心原因是：

• 你使用的PowerShell版本低于3.0，而Get-ChildItem的-File参数是PowerShell 3.0才引入的特性，低版本环境不支持该参数。
• 测试未MockGet-Content命令，原函数执行时会尝试读取实际文件，可能引发额外错误。
• 测试的参数验证逻辑不完整，未覆盖原函数调用Get-ChildItem时的-Recurse和-File参数。

修复步骤与代码 #

1. 兼容低版本PowerShell的函数修改 #

将原函数中的-File参数替换为兼容写法（通过Where-Object过滤文件），确保在PowerShell 2.0及以上版本都能运行：

BeforeAll {
    function Get-HtmlFileDetail {
        param (
            [string[]]$Path = 'E:\Domains',
            [string[]]$Include = 'Alive*.html'
        )
        return Get-ChildItem -Path $Path -Include $Include -Recurse | 
               # 替换-File参数，兼容低版本PowerShell
               Where-Object { !$_.PSIsContainer } |
               ForEach-Object {
            [PSCustomObject]@{
                Drive    = Split-Path -Path $PSItem.FullName -Qualifier
                Parent   = Split-Path (Split-Path $PSItem.FullName -Parent) -Leaf
                FileName = Split-Path -Path $PSItem.FullName -Leaf
                BodyText = (Get-Content -Path $PSItem.FullName -Raw | Select-String -Pattern '(?<=<body>).*?(?=</body>)').Matches.Value
            }
        }
    }
}

2. 完善Pester测试逻辑 #

添加Get-Content的Mock，避免读取实际文件；同时补充完整的参数验证逻辑：

Describe 'FileSytem' {
    Context 'Get-HtmlFileDetail' {
        Context 'when path and include are NOT specified' {
            BeforeAll {
                # Mock Get-ChildItem，返回模拟的文件对象
                Mock -CommandName Get-ChildItem -MockWith {
                    [PSCustomObject]@{
                        FullName = 'E:\Domains\Test\Alive_test.html'
                        PSIsContainer = $false
                    }
                }
                # Mock Get-Content，返回模拟的HTML内容
                Mock -CommandName Get-Content -MockWith { '<html><body>Test Body Content</body></html>' }
            }
            It 'should use default parameters' {
                Get-HtmlFileDetail | Should -Invoke -CommandName Get-ChildItem -Times 1 -ParameterFilter {
                    $Path -eq 'E:\Domains' -and 
                    $Include -eq 'Alive*.html' -and 
                    $Recurse -eq $true
                }
                # 验证Get-Content也被正确调用
                Should -Invoke -CommandName Get-Content -Times 1 -ParameterFilter {
                    $Path -eq 'E:\Domains\Test\Alive_test.html' -and $Raw -eq $true
                }
            }
        }
    }
}

补充说明 #

如果你的环境已经是PowerShell 3.0及以上版本，可以保留原函数的-File参数，只需在测试的ParameterFilter中添加$File -eq $true即可：

It 'should use default parameters' {
    Get-HtmlFileDetail | Should -Invoke -CommandName Get-ChildItem -Times 1 -ParameterFilter {
        $Path -eq 'E:\Domains' -and 
        $Include -eq 'Alive*.html' -and 
        $Recurse -eq $true -and
        $File -eq $true
    }
}

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