PowerShell作业状态修改：多作业脚本特定错误时设为Failure

嘿，针对你开发多作业PowerShell脚本时遇到的这两个状态控制需求，我来给你详细拆解实现方法：

首先得明确：PowerShell原生作业对象的JobStateInfo.State属性是只读的，没办法直接修改它的系统内置状态（比如Running、Completed、Failed这些）。不过我们可以通过两种方式来实现状态的“变更”：

1. 触发系统内置状态变更 #

通过PowerShell的作业控制cmdlet，间接让作业进入对应状态：

• 要让作业进入Stopped状态：直接执行 Stop-Job -Job $targetJob，这个命令会终止运行中的作业，并自动更新它的状态为Stopped。
• 要让作业进入Failed状态：在作业的脚本块中抛出异常（后面第二部分会详细讲），作业执行终止后状态会自动变为Failed。

2. 添加自定义状态属性 #

如果需要自定义系统之外的状态（比如“Processing”“Waiting”这类），可以给作业对象添加一个自定义的可写属性：

# 启动一个测试作业
$myJob = Start-Job -ScriptBlock { Start-Sleep 120 }

# 添加自定义状态属性
$myJob | Add-Member -MemberType NoteProperty -Name CustomJobStatus -Value "Initializing"

# 后续随时更新这个状态
$myJob.CustomJobStatus = "Processing Data"

# 查看自定义状态
$myJob.CustomJobStatus

这里分两种场景，你可以根据需求选择：

1. 让作业的系统状态变为Failed #

如果希望作业的原生状态显示为Failed，只需要在捕获到特定错误时抛出异常即可。作业执行时遇到未捕获的异常，就会自动标记为Failed状态：

$errorJob = Start-Job -ScriptBlock {
    $targetFile = "C:\NonExistent\TestFile.txt"
    try {
        # 用ErrorAction Stop把非终止错误转为终止错误
        Get-Content $targetFile -ErrorAction Stop
    } catch [System.Management.Automation.ItemNotFoundException] {
        # 捕获到文件不存在的特定错误，抛出异常
        throw "致命错误：目标文件不存在，作业终止"
    }
}

# 等待作业完成
Wait-Job $errorJob

# 查看作业状态
$errorJob.JobStateInfo.State  # 输出：Failed

2. 返回自定义的“Failure”状态标记 #

如果需要更灵活的状态标识（比如返回包含状态和错误信息的对象），可以在作业脚本块中直接返回自定义的结果对象：

$customStatusJob = Start-Job -ScriptBlock {
    $targetFile = "C:\NonExistent\TestFile.txt"
    try {
        $content = Get-Content $targetFile -ErrorAction Stop
        # 执行成功时返回Success状态
        return @{
            Status = "Success"
            Result = $content
        }
    } catch [System.Management.Automation.ItemNotFoundException] {
        # 特定错误时返回Failure状态和错误详情
        return @{
            Status = "Failure"
            ErrorMessage = $_.Exception.Message
        }
    }
}

# 获取作业的输出结果
$jobResult = Receive-Job $customStatusJob

# 查看自定义状态
$jobResult.Status  # 输出：Failure
# 查看错误信息
$jobResult.ErrorMessage

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