PowerShell用-ArgumentList给Register-ScheduledJob传多参数仅识别首个报错

核心报错原因 #

你当前的传参写法不符合-ArgumentList的参数规则，和脚本块内的param定义无关：
-ArgumentList是数组类型参数，PowerShell解析时会要求所有传入该参数的值用逗号分隔形成数组结构。而你现在用空格分隔多个变量的写法，会让解析器把$Destination、$FilePW、$email的值当成Register-ScheduledJob命令自身的独立位置参数，根本没归属到-ArgumentList下，因此才会抛出“找不到能接受C:\Users\user\Documents的位置参数”的错误。

分步修正操作 #

• 第一步：修正-ArgumentList的传参格式
  把原来的空格分隔写法，改成逗号分隔的数组形式：

  # 错误写法（当前会触发报错的代码）
  Register-ScheduledJob -Name "Backup" -Trigger $jobTrigger -ScheduledJobOption $joboption -ScriptBlock @jobs -ArgumentList $Target $Destination $FilePW $email
  
  # 修正后的正确写法
  Register-ScheduledJob -Name "Backup" -Trigger $jobTrigger -ScheduledJobOption $joboption -ScriptBlock @jobs -ArgumentList $Target, $Destination, $FilePW, $email
  

  注意：数组元素之间的分隔符是英文逗号，不要用空格、分号或者其他符号。

• 第二步：调整脚本块内的param定义，适配计划作业的非交互运行场景
  你当前的param块把Read-Host交互输入作为参数默认值，在计划作业后台自动运行时没有交互终端支持输入，就算参数传对，只要遇到缺失值的场景就会卡死报错。需要把交互输入逻辑从param默认值中移出去，仅在手动运行脚本时触发：

  # 修正后的脚本块参数定义
  $jobs = {
      param(
          # 明确标注参数位置，和ArgumentList传入的数组顺序一一对应
          [Parameter(Position=0)]
          [string]$Target,
          [Parameter(Position=1)]
          [string]$Destination,
          [Parameter(Position=2)]
          [string]$FilePW = "",
          [Parameter(Position=3)]
          [string]$email = ""
      )
  
      # 交互输入逻辑移出param默认值，仅在手动运行、参数为空时触发
      if (-not $Target) { $Target = Read-Host "Enter the source" }
      if (-not $Destination) { $Destination = Read-Host "Enter the dist" }
      if (-not $FilePW) { $FilePW = Read-Host "enter ps (optional)" }
      if (-not $email) { $email = Read-Host "Enter your email if you want the reports (Optional)" }
  
      # 后续备份逻辑...
  }
  

• 第三步：验证作业参数配置
  注册作业完成后，可执行以下命令检查脚本块绑定的参数是否正确，不用等作业触发再排查：

  (Get-ScheduledJob -Name Backup).ScriptBlock
  

  确认输出的param参数顺序和-ArgumentList传入的数组顺序完全匹配即可。

容易混淆的知识点提醒 #

PowerShell里不同场景的多参数传值分隔符不通用：

• 使用调用运算符&直接执行脚本块、脚本文件时，多参数用空格分隔
• 使用命令的数组类型参数（比如-ArgumentList、-Argument）传值时，多元素必须用英文逗号分隔形成数组结构

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