PowerShell Try-Catch块中变量值未更新问题求助

你遇到的核心问题是变量作用域隔离导致$currentFile没有正确更新到脚本级，另外还要注意PowerShell异常捕获的细节。

原因拆解 #

1. 局部变量覆盖脚本级变量：
   你在脚本开头定义的$currentFile是脚本级变量，但在upload-files函数的foreach-object里直接写$currentFile = ...时，PowerShell会默认创建一个函数内的局部变量，而非修改你原本的脚本级变量。哪怕你尝试设置作用域，若写法有误（比如没加$script:前缀）也不会生效。
2. 管道的作用域特性：
   Foreach-Object在管道中执行，它的上下文本身是子作用域，哪怕在函数内，直接赋值也不会自动渗透到外层脚本作用域。

具体修复方案 #

方案1：明确引用脚本级变量修改

直接在函数内的赋值语句前加上$script:前缀，强制修改脚本级的$currentFile：

# Variables
$hasError = 0
$currentFile = "test"

# Functions
function upload-files {
    param(
        $WinScpSession,
        $LocalDirectory,
        $FileType,
        $RemoteDirectory
    )
    
    Get-ChildItem $LocalDirectory -Filter $FileType |
        ForEach-Object {
            Write-Output "Sending $_..."
            # 明确修改脚本级变量
            $script:currentFile = Join-Path $LocalDirectory $_
            Upload-File -WinScpSession $WinScpSession -LocalDirectory $script:currentFile -RemoteDirectory $RemoteDirectory -ErrorAction Stop
        }
}

try
{
    upload-files -WinScpSession $Session -LocalDirectory [PathToLocalDirectory] -FileType [FileType] -RemoteDirectory [PathToRemoteDirectoy]
}    
catch
{
    Write-Host "Error: $($_.Exception.Message)"
    Write-Output $currentFile
    $errorMoveLocation = Copy-Item -Path $currentFile -Destination "$currentFile.err" -PassThru
    Write-Host "Error File has been saved as $errorMoveLocation"
    $hasError = 1
}

这里用Join-Path替代字符串拼接，避免路径分隔符的问题，同时给Upload-File加上-ErrorAction Stop，确保非终止错误能触发catch块。

方案2：在循环内处理异常（更推荐）

把try/catch放到foreach-object的循环体里，不需要依赖全局变量，直接在出错时处理当前文件，逻辑更清晰：

# Variables
$hasError = 0

# Functions
function upload-files {
    param(
        $WinScpSession,
        $LocalDirectory,
        $FileType,
        $RemoteDirectory
    )
    
    Get-ChildItem $LocalDirectory -Filter $FileType |
        ForEach-Object {
            $currentFile = Join-Path $LocalDirectory $_
            Write-Output "Sending $_..."
            try {
                Upload-File -WinScpSession $WinScpSession -LocalDirectory $currentFile -RemoteDirectory $RemoteDirectory -ErrorAction Stop
            }
            catch {
                Write-Host "Error sending $_: $($_.Exception.Message)"
                $errorMoveLocation = Copy-Item -Path $currentFile -Destination "$currentFile.err" -PassThru
                Write-Host "Error File has been saved as $errorMoveLocation"
                $script:hasError = 1
                # 若想遇到错误就终止执行，添加下面一行
                # throw $_
            }
        }
}

upload-files -WinScpSession $Session -LocalDirectory [PathToLocalDirectory] -FileType [FileType] -RemoteDirectory [PathToRemoteDirectoy]

这种方式每个文件的上传和错误处理独立，可读性和可维护性更好，还避免了全局变量的副作用。

补充注意事项

• 不要用$error作为自定义变量名：$error是PowerShell的自动变量，用来存储最近的错误信息，自定义变量会覆盖它，容易引发问题，建议改成$hasError这类名字。

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