PowerShell中Copy-Item访问拒绝错误的自定义友好提示方法

直接修改脚本，通过捕获特定异常、提取错误路径，再用PowerShell内置的错误输出方法实现红色背景的自定义提示，两种可靠的实现方式供你选择：

方式一：通过错误对象属性提取路径（更稳定） #

$sourceFolder = "C:\Users\username\Documents"
$backupFolder = "C:\temp\Backup\profilefolders\username\Documents"

try {
    # 加-ErrorAction Stop将非终止错误转为终止错误，让try/catch可以捕获
    Copy-Item -Path $sourceFolder -Destination $backupFolder -Recurse -Force -ErrorAction Stop
}
catch [System.UnauthorizedAccessException] {
    # 从错误对象中直接获取被拒绝访问的路径
    $deniedPath = $_.TargetObject
    # 用内置方法输出带红色背景的自定义提示
    $host.UI.WriteErrorLine("Error: access to $deniedPath denied and not backed up.")
}
catch {
    # 处理其他类型的意外错误
    $host.UI.WriteErrorLine("Unexpected error: $_")
}

方式二：通过正则匹配错误消息提取路径 #

如果极端情况下TargetObject属性无法正常获取路径，可以用正则从错误文本里提取：

$sourceFolder = "C:\Users\username\Documents"
$backupFolder = "C:\temp\Backup\profilefolders\username\Documents"

try {
    Copy-Item -Path $sourceFolder -Destination $backupFolder -Recurse -Force -ErrorAction Stop
}
catch [System.UnauthorizedAccessException] {
    # 用正则匹配提取被拒绝的路径
    if ($_.Exception.Message -match 'Access to the path ''(.*)'' is denied') {
        $deniedPath = $matches[1]
        $host.UI.WriteErrorLine("Error: access to $deniedPath denied and not backed up.")
    } else {
        # 匹配失败时输出原始错误信息
        $host.UI.WriteErrorLine("Access denied error: $_")
    }
}
catch {
    $host.UI.WriteErrorLine("Unexpected error: $_")
}

关键说明 #

• -ErrorAction Stop：默认Copy-Item的访问拒绝是非终止错误，脚本会继续执行但弹出默认红色错误；添加该参数后会将错误转为终止错误，进入catch块处理。
• $host.UI.WriteErrorLine()：PowerShell内置方法，自动使用系统默认的错误样式（红色背景、黑色文字）输出内容，正好符合你的需求。
• 专门捕获System.UnauthorizedAccessException：只处理访问拒绝类错误，其他错误交给通用catch块，避免误判。

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