PowerShell脚本更新SharePoint Online列表项时部分字段值无法保存

我正在处理CSV文件以创建SharePoint Online列表项，并将元数据保存到其自定义内容类型的字段中。起初以为是列类型问题，但发现部分简单文本字段的值也无法保存。令人困惑的是，用相同方式设置字段值，部分字段成功保存，部分却不行——列表项并未保留传入的所有更新值。

代码示例 #

创建新项的代码：

$newFile = $targetfolderObj.Files.Add($FileCreationInfo)
$targetContext.Load($newFile)
$spContext.ExecuteQuery()

获取列表项并设置字段值：

$newFileListItem = $newFile.ListItemAllFields

$newFileListItem.Properties["ColumnNameA"] = $_.CustomValue1 # 成功保存
$newFileListItem.Properties["ColumnNameB"] = $_.CustomValue2 # 无法保存！！！
$newFileListItem.Properties["ColumnNameC"] = $_.CustomValue3 # 成功保存

更新执行代码：

$newFileListItem.Update()
$spContext.ExecuteQuery()

补充说明 #

打印$_.CustomValue1、$_.CustomValue2和$_.CustomValue3均显示为"Hello"，无特殊字符；即使将字段值硬编码为简单字符串，字段2仍无法更新，但字段1和3可以正常更新。问题并非顺序导致，始终出在相同列上，已验证列存在、使用内部字段名称、字符串长度在范围内，且这些列无其他验证规则。

排查步骤 #

• 检查字段在内容类型中的状态：进入列表设置→对应自定义内容类型，查看ColumnNameB是否被设置为隐藏，隐藏字段无法通过常规方式赋值更新。
• 改用直接字段赋值方式：放弃Properties集合，直接通过字段内部名赋值，示例：

  $newFileListItem["ColumnNameB"] = "Hello"
  

  部分特殊绑定字段无法通过Properties集合正确映射。
• 捕获ExecuteQuery的异常细节：添加错误捕获逻辑，获取SharePoint返回的具体错误信息，这是排查这类问题最有效的方式：

  try {
      $newFileListItem.Update()
      $spContext.ExecuteQuery()
  }
  catch {
      Write-Host "错误信息: $_"
      Write-Host "异常详情: $($_.Exception.Message)"
      Write-Host "堆栈跟踪: $($_.ScriptStackTrace)"
  }
  

• 验证字段权限：确认执行代码的账号拥有修改ColumnNameB字段的权限，部分字段可能被单独配置了权限限制。
• 确认字段类型：再次核实ColumnNameB是否为计算字段、查找字段或托管元数据字段，这类字段无法通过直接赋值更新，需要对应特殊处理方式。
• 先加载ListItemAllFields再赋值：在设置字段值前先加载列表项的完整字段信息，确保上下文同步最新字段状态：

  $newFileListItem = $newFile.ListItemAllFields
  $targetContext.Load($newFileListItem)
  $targetContext.ExecuteQuery()
  # 再执行赋值操作
  $newFileListItem.Properties["ColumnNameB"] = "Hello"
  $newFileListItem.Update()
  $targetContext.ExecuteQuery()
  

• 检查列表版本控制设置：如果列表启用了版本控制，确认是否因版本数量限制导致更新未生效，不过这种情况通常会伴随异常提示。

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