O365 SharePoint多选项复选框字段CSOM赋值问题求助

首先，问题的核心是你直接传入数组或字符串的方式不符合SharePoint对多选字段的要求。SharePoint的多选项字段（Multi-Choice）需要使用Microsoft.SharePoint.Client.FieldMultiChoiceValue类型来赋值，而不是简单的数组或字符串——这就是为什么你看到的是{option1, option2, option3}格式的文本，而非选中的复选框。

解决步骤 #

1. 理解多选字段的正确赋值逻辑 #

SharePoint的多选字段内部存储的是FieldMultiChoiceValue对象，它专门用于承载多个选项值，只有将这个对象绑定到列表项字段，系统才会识别为多选选项，而非普通文本。

2. 修改你的PowerShell代码 #

下面是针对你的代码调整后的版本，假设你的多选字段内部名称为My_MultiChoice_Field（请替换为你实际的字段内部名称）：

Add-Type -Path 'C:\ServOps\com\SharepointRuntimes\Microsoft.SharePoint.Client.dll'
Add-Type -Path 'C:\ServOps\com\SharepointRuntimes\Microsoft.SharePoint.Client.Runtime.dll'
$url = "https://my.foo.sharepoint"

Function Write-ListItems([Microsoft.SharePoint.Client.ClientContext]$Context, [String]$ListTitle) {
    $Context.ExecuteQuery()
    # 获取目标列表
    $List = $Context.Web.Lists.GetByTitle($ListTitle)
    $Context.Load($List)
    $Context.ExecuteQuery()

    # 创建新列表项
    $ListItemCreationInformation = New-Object Microsoft.SharePoint.Client.ListItemCreationInformation
    $NewListItem = $List.AddItem($ListItemCreationInformation)
    
    # 赋值普通字段
    $NewListItem["Title"] = $TASK
    $NewListItem["Approximate_x0020_delivery_x0020"] = $AVERAGE_DELIVERY_TIME_SLA

    # 处理多选字段（关键修正部分）
    # 假设你的多选选项数组是 $MultiOptions = @("Option1", "Option2", "Option3")
    $multiChoiceValue = New-Object Microsoft.SharePoint.Client.FieldMultiChoiceValue
    foreach ($option in $MultiOptions) {
        $multiChoiceValue.Add($option)
    }
    # 替换为你实际的多选字段内部名称
    $NewListItem["My_MultiChoice_Field"] = $multiChoiceValue

    $NewListItem.Update()
    $Context.ExecuteQuery()
}

$context = Get-SPOContext -Url $Url -UserName $UserName -Password $Password
Write-ListItems -Context $context -ListTitle "My Sharepoint"
$context.Dispose()

3. 关键注意事项 #

• 字段内部名称：一定要使用多选字段的内部名称（而非显示名称），可以通过SharePoint列表设置的“字段管理”查看，或者用PowerShell查询字段的InternalName属性。
• 选项完全匹配：添加到FieldMultiChoiceValue中的选项必须和列表中定义的多选选项完全一致（包括大小写、空格），否则SharePoint无法识别并选中对应复选框。
• 禁止直接传数组：直接给字段赋值数组会被SharePoint自动转换为{...}格式的字符串，这是文本的默认显示逻辑，而非多选字段的正确值存储方式。

验证方法 #

赋值完成后，你可以通过以下代码验证结果：

$item = $List.GetItemById($NewListItem.Id)
$Context.Load($item)
$Context.ExecuteQuery()
$multiFieldValue = $item["My_MultiChoice_Field"]
Write-Host "选中的选项:" $multiFieldValue

此时返回的应该是FieldMultiChoiceValue对象，包含你添加的选项，而非字符串格式的内容。

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