如何编写高级PowerShell函数删除指定文件夹中超指定大小的文件

你提供的Sort-Size函数实际是用于等待特定条件达成的工具函数，和“删除指定文件夹内超过指定大小的文件”需求不匹配。以下是完全符合需求的高级PowerShell函数：

function Remove-LargeFile {
    <#
    .SYNOPSIS
        删除指定文件夹中大小超过设定KB值的文件
    .DESCRIPTION
        可指定目标文件夹、文件大小阈值（KB），支持递归查找子文件夹，提供删除前确认、详细日志输出等功能
    .PARAMETER Path
        目标文件夹路径，必须存在
    .PARAMETER SizeThresholdKB
        文件大小阈值，单位为KB，大于此值的文件会被标记删除
    .PARAMETER Recurse
        是否递归查找子文件夹中的文件，默认不启用
    .PARAMETER Confirm
        是否在删除前逐一确认，默认启用；添加 -Confirm:$false 可跳过确认
    .PARAMETER WhatIf
        仅模拟删除操作，不实际删除文件，用于验证目标文件列表
    .EXAMPLE
        PS C:\> Remove-LargeFile -Path "C:\Temp" -SizeThresholdKB 2048
        删除C:\Temp文件夹中大于2048KB（2MB）的文件，删除前逐一确认
    .EXAMPLE
        PS C:\> Remove-LargeFile -Path "C:\Logs" -SizeThresholdKB 10240 -Recurse -Confirm:$false
        递归删除C:\Logs及其子文件夹中大于10240KB（10MB）的文件，跳过确认步骤
    .EXAMPLE
        PS C:\> Remove-LargeFile -Path "C:\Downloads" -SizeThresholdKB 5120 -WhatIf
        模拟删除C:\Downloads中大于5120KB（5MB）的文件，仅输出待删除列表不实际操作
    #>
    [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'High')]
    param (
        [Parameter(Mandatory = $true, ValueFromPipeline = $true)]
        [ValidateScript({Test-Path $_ -PathType Container})]
        [string]$Path,

        [Parameter(Mandatory = $true)]
        [ValidateRange(1, [int]::MaxValue)]
        [int]$SizeThresholdKB,

        [Parameter()]
        [switch]$Recurse
    )

    begin {
        $sizeThresholdBytes = $SizeThresholdKB * 1KB
        Write-Verbose "已设置文件大小阈值：$SizeThresholdKB KB（$sizeThresholdBytes 字节）"
    }

    process {
        # 获取符合条件的文件
        $largeFiles = Get-ChildItem -Path $Path -File -Recurse:$Recurse | 
                      Where-Object {$_.Length -gt $sizeThresholdBytes}

        if (-not $largeFiles) {
            Write-Verbose "未找到大于$SizeThresholdKB KB的文件"
            return
        }

        Write-Verbose "共找到 $($largeFiles.Count) 个符合条件的文件"

        # 遍历删除文件
        foreach ($file in $largeFiles) {
            if ($PSCmdlet.ShouldProcess($file.FullName, "删除文件（大小：$([math]::Round($file.Length/1KB,2)) KB）")) {
                try {
                    Remove-Item -Path $file.FullName -Force -ErrorAction Stop
                    Write-Verbose "已成功删除文件：$($file.FullName)"
                }
                catch {
                    Write-Error "删除文件失败：$($file.FullName)，错误信息：$($_.Exception.Message)"
                }
            }
        }
    }

    end {
        Write-Verbose "删除操作执行完毕"
    }
}

函数特性说明 #

• 参数校验：确保目标文件夹存在、大小阈值为正整数，避免无效输入
• 支持管道输入：可直接从管道传入文件夹路径，例如 Get-ChildItem C:\Data -Directory | Remove-LargeFile -SizeThresholdKB 4096
• 安全特性：默认启用删除确认，支持-WhatIf模拟操作，防止误删
• 详细日志：通过-Verbose参数可查看操作细节，包括找到的文件数量、删除状态等
• 错误处理：捕获删除失败的异常并输出错误信息，避免单个文件失败中断整个流程

使用示例 #

1. 基础使用（删除指定文件夹中大于2MB的文件，需确认）：

Remove-LargeFile -Path "C:\Temp" -SizeThresholdKB 2048 -Verbose

2. 递归删除且跳过确认（删除Logs文件夹及其子文件夹中大于10MB的文件）：

Remove-LargeFile -Path "C:\Logs" -SizeThresholdKB 10240 -Recurse -Confirm:$false

3. 模拟删除（验证待删除文件列表）：

Remove-LargeFile -Path "C:\Downloads" -SizeThresholdKB 5120 -WhatIf -Verbose

内容的提问来源于stack exchange，提问作者Расим Гусаинов