PowerShell Octopus Deploy脚本传future数组参数加日期报类型转换错误

报错根因 #

你将$future参数定义为[array]类型后，哪怕仅传入单个日期字符串，PowerShell都会自动把这个值包装成单元素对象数组。当你把整个System.Object[]类型的$future直接传给Get-Date的日期输入参数时，无法完成要求的System.DateTime类型转换，因此触发了参数绑定报错。
注释掉日期加1天的逻辑后脚本可以正常运行，是因为字符串插值操作会自动把数组转为空格分隔的文本字符串，不会触发严格的类型转换校验，也就不会暴露类型定义错配的问题。

具体修复操作 #

• 修正参数类型定义，匹配当前单日期输入的使用场景。把param块中原有[array] $future的定义，修改为[string] $future，从根源上避免单值被自动包装为数组的问题。
• 如果需要保留“支持传入多日期批量部署”的扩展能力，可以保留数组类型定义，但在所有需要使用日期值的位置，显式取出对应元素再做处理，替换原有问题代码：
  原有报错逻辑：

  if ($future -ne $null) {
      write-host "This deployment will take place on $future"
      $expirefuturedate = (get-date $future).Adddays(1).ToString("yyyy-MM-dd")
      $deploymentBody = @{
          ReleaseId     = $release.Id
          EnvironmentId = $environment.Id
          TenantId      = $tenant.Id
          QueueTime     = "${future}T23:00:00"
          QueueTimeExpiry = "${expirefuturedate}T05:00:00"
      } | ConvertTo-Json
  }
  

  修正后逻辑：

  if ($future -ne $null) {
      # 显式取出数组中的目标日期，避免把整个数组传给日期处理方法
      $targetFutureDate = $future[0]
      write-host "This deployment will take place on $targetFutureDate"
      $expirefuturedate = (Get-Date $targetFutureDate).AddDays(1).ToString("yyyy-MM-dd")
      $deploymentBody = @{
          ReleaseId     = $release.Id
          EnvironmentId = $environment.Id
          TenantId      = $tenant.Id
          QueueTime     = "$($targetFutureDate)T23:00:00"
          QueueTimeExpiry = "$($expirefuturedate)T05:00:00"
      } | ConvertTo-Json
  }
  

• 可选健壮性优化。在脚本开头增加参数格式校验，避免传入非法日期导致后续Octopus API调用异常：

  if ($future -and -not [DateTime]::TryParse($future, [ref]$null)) {
      throw "future参数格式无效，请传入符合YYYY-MM-DD格式的合法日期值"
  }
  

效果验证 #

修正后重新执行带future参数的脚本命令，即可正常计算出部署过期时间，不会再触发类型转换报错：

.\Deploycustom_parm.ps1 -releaseversion 8.1.2103.193 -future 2021-03-11

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