如何使用Set-PnPListItem清空SharePoint Online中的分类字段值？

云上老周

2026-5-7

解决用Set-PnPListItem清空SharePoint分类字段的问题

我之前也踩过这个坑！SharePoint的托管元数据字段属于复杂类型，直接传$null、""或者-1这类简单空值给Set-PnPListItem的话，API会判定参数无效，就会抛出你看到的“Value cannot be null”错误。下面给你两种靠谱的解决方案：

方法一：用专门的清空字段Cmdlet（最简洁）

PnP PowerShell提供了Clear-PnPListItemField，就是专门用来处理字段清空的，比Set-PnPListItem更直接：

# 替换成你的列表名称、项ID和分类字段的内部名称
Clear-PnPListItemField -List "产品列表" -Identity 123 -Field "ProductCategory"

方法二：用TaxonomyFieldValue对象配合Set-PnPListItem

如果需要和其他字段的更新操作一起执行，可以创建一个空的TaxonomyFieldValue对象传递给哈希表，这样就能正确清空分类值：

# 1. 获取目标分类字段的TaxonomyField对象
$taxField = Get-PnPField -List "产品列表" -Identity "ProductCategory" -AsTaxonomyField

# 2. 创建空的TaxonomyFieldValue实例，关键是设置WssId为-1
$emptyTaxValue = New-Object Microsoft.SharePoint.Client.Taxonomy.TaxonomyFieldValue
$emptyTaxValue.Label = ""
$emptyTaxValue.TermGuid = ""
$emptyTaxValue.WssId = -1

# 3. 执行更新操作，把空对象传入对应字段
Set-PnPListItem -List "产品列表" -Identity 123 -Values @{
    "ProductCategory" = $emptyTaxValue
    # 这里可以加其他需要更新的字段
    "Description" = "更新后的描述"
}