PowerShell计划任务返回代码2147942401 脚本未执行故障排查

返回码2147942401对应Windows系统错误码1，含义为「函数不正确」，在PowerShell计划任务场景下，绝大多数情况是PowerShell进程启动阶段就失败，根本未进入脚本执行逻辑，按以下顺序排查：

1 先修复任务创建脚本的明显错误 #

你贴的创建脚本本身存在3个致命问题，是故障的首要诱因：

• 最后一行Register-ScheduledTask -TaskName $Tas变量名截断，你定义的任务名变量是$TaskName，此处写为$Tas会导致注册任务名异常，和你在任务历史里看到的任务名\CleanUp与预期的Audit Large Lists不匹配的现象完全吻合。先手动删除现有异常的CleanUp任务，再重新创建。
• 脚本中定义了$username、$password变量，但创建任务时完全未传入，任务实际运行身份和你预期的Crescent\SP13_FarmAdmin可能不一致。
• 任务动作的PowerShell启动参数配置错误，直接传入ps1路径会触发执行策略拦截、路径解析失败等问题，正确的动作配置代码如下：

# 修正后的任务动作配置
$Action = New-ScheduledTaskAction -Execute "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe" `
-Argument "-NoProfile -NonInteractive -ExecutionPolicy Bypass -File `"E:\Scripts\Cleanup.ps1`""

参数说明：

• 写全PowerShell可执行文件的绝对路径，规避系统PATH配置异常导致的找不到程序问题
• -NoProfile：不加载用户PowerShell配置文件，避免配置文件中的自定义逻辑阻断启动
• -NonInteractive：非交互模式运行，不会弹出任何提示窗口卡住任务进程
• -ExecutionPolicy Bypass：临时绕过PowerShell执行策略限制，无需修改全局执行策略配置
• -File：明确指定后续参数为待执行脚本路径，路径用双引号包裹，兼容含空格的路径场景
• 注册任务时正确传入运行身份，不要硬编码明文密码，示例注册代码：

$cred = Get-Credential -UserName "Crescent\SP13_FarmAdmin" -Message "输入运行账号密码"
Register-ScheduledTask -TaskName $TaskName -Action $Action -Trigger $Trigger -User $cred.UserName -Password $cred.GetNetworkCredential().Password -RunLevel Highest

-RunLevel Highest参数对应你勾选的「使用最高权限运行」配置，不需要手动在界面勾选。

2 任务基础配置校验 #

• 任务常规选项卡必须勾选不管用户是否登录都要运行，不要选择「只在用户登录时运行」，后者在账号无交互式登录会话时完全无法启动进程。
• 确认运行账号Crescent\SP13_FarmAdmin属于本地Administrators组，否则最高权限运行的提权操作会失败。
• 不要勾选「仅在用户登录到下列计算机时运行」等限制条件。

3 权限校验 #

• 确认运行账号对E:\Scripts目录及Cleanup.ps1文件有读取&执行、写入权限。
• 逐一确认脚本中涉及的所有操作对象：SharePoint站点、文件读写路径、注册表项、系统组件等，运行账号都有对应操作权限，权限不足会导致脚本静默退出。

4 执行链路验证 #

• 先手动用运行账号测试脚本：按住Shift右键点击PowerShell图标，选择「以其他用户身份运行」，输入Crescent\SP13_FarmAdmin的账号密码，在弹出的窗口中直接执行E:\Scripts\Cleanup.ps1，确认手动执行无报错、逻辑符合预期后再配置计划任务。
• 给脚本加启动日志，不要仅靠任务返回码判断执行状态，在Cleanup.ps1最开头添加日志逻辑：

# 脚本启动日志
"$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') 脚本启动，当前运行账号：$env:USERNAME" | Out-File E:\Scripts\task_run.log -Append
# --- 原有脚本逻辑放在此处 ---
# 脚本结束日志
"$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss') 脚本执行完成，退出码：$LASTEXITCODE" | Out-File E:\Scripts\task_run.log -Append

下次任务触发后先检查日志文件：

• 如果日志文件未生成，说明PowerShell进程根本没启动到脚本执行阶段，回到前两步检查启动参数、任务配置、权限问题
• 如果日志只有启动记录没有结束记录，说明脚本执行中途报错退出，根据脚本逻辑逐段调试即可
• 打开任务计划程序的「任务历史」选项卡，查看事件ID为129（进程创建失败）、201（动作启动）、202（动作完成）的详细事件描述，里面会记录进程启动失败的具体原因，比通用返回码定位精准得多。

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