如何通过PnP PowerShell或脚本更新SharePoint Online列表图标与颜色？

1. 区分经典/现代列表场景 #

• 经典列表：_ListIcon属性仅对经典模式列表生效，但常因缓存导致图标不刷新
• 现代列表：该属性不被支持，需使用Modern列表专属的配置方式

2. 经典列表的修复步骤 #

如果你的列表是经典模式，执行以下操作：

• 强制刷新浏览器（Ctrl+F5）清除本地缓存
• 若仍不生效，运行命令重置列表元数据缓存：

  $list = Get-PnPList -Identity "你的列表名称"
  $list.Update()
  Invoke-PnPQuery
  

• 检查列表默认视图的URL配置，视图缓存可能导致图标显示滞后

3. 现代列表的正确设置方法 #

现代列表需通过IconUrl参数配置图标：

• 使用PnP PowerShell设置内置图标：

  Set-PnPList -Identity "你的列表名称" -IconUrl "/_layouts/15/images/calendar.png"
  

  若使用自定义图标，需传入站点资产库中图标文件的绝对路径
• 验证设置结果：

  Get-PnPList -Identity "你的列表名称" | Select-Object IconUrl
  

4. 额外排查点 #

• 确认当前用户拥有列表的编辑权限，权限不足会导致设置未实际生效
• 检查站点是否启用CDN，CDN缓存可能延迟图标更新
• 若使用自定义图标，确保图标文件已上传且路径无拼写错误

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