使用PowerShell为微软文件添加属性/值失败求助

你的代码里用Add-Member只是给PowerShell会话中的FileInfo对象添加了内存中的临时属性，并没有修改文件本身的系统元数据或Office文档内置属性，所以在文件详情面板里看不到新增的属性。要实现需求，需要针对不同类型的文件采用对应的修改方式：

一、针对Office文档（Word/Excel/PowerPoint等MS原生文件） #

这类文件有专属的内置自定义属性体系，可通过Open XML SDK（无需安装Office）或Office COM组件两种方式修改：

方案1：使用Open XML SDK（推荐无Office环境） #

先安装依赖包（需管理员权限），再执行修改逻辑：

# 安装Open XML SDK到当前用户环境
Install-Package DocumentFormat.OpenXml -Scope CurrentUser

$directory = "C:\Your\Directory\Path"
$newTags = @{
    "Tag1" = "Value1"
}

function Add-CustomPropertiesToOfficeFiles {
    param(
        [Parameter(Mandatory=$true)]
        [string]$path,
        [Parameter(Mandatory=$true)]
        [hashtable]$tags
    )
    # 筛选支持的Office文件格式
    $officeExtensions = @(".docx", ".xlsx", ".pptx", ".docm", ".xlsm", ".pptm")
    $files = Get-ChildItem -Path $path -Recurse -File | Where-Object { $officeExtensions -contains $_.Extension }

    foreach ($file in $files) {
        try {
            $package = [DocumentFormat.OpenXml.Packaging.Package]::Open($file.FullName, [System.IO.FileMode]::Open, [System.IO.FileAccess]::ReadWrite)
            $props = [DocumentFormat.OpenXml.Packaging.CustomFilePropertiesPart]::GetCustomFilePropertiesPart($package)

            # 若文件无自定义属性区域，自动创建
            if (-not $props) {
                $props = $package.CreateCustomFilePropertiesPart()
                $props.Properties = New-Object DocumentFormat.OpenXml.CustomProperties.Properties
            }

            foreach ($tag in $tags.GetEnumerator()) {
                # 检查属性是否已存在，存在则更新，不存在则新增
                $existingProp = $props.Properties.ChildElements | Where-Object { $_.Name -eq $tag.Key }
                if ($existingProp) {
                    $existingProp.VTLPWSTR.Text = $tag.Value
                } else {
                    $newProp = New-Object DocumentFormat.OpenXml.CustomProperties.CustomDocumentProperty
                    $newProp.Name = $tag.Key
                    $newProp.VTLPWSTR = New-Object DocumentFormat.OpenXml.CustomProperties.VTLPWSTR
                    $newProp.VTLPWSTR.Text = $tag.Value
                    $props.Properties.AppendChild($newProp)
                }
            }

            $props.Properties.Save()
            $package.Close()
            Write-Host "成功更新文件属性：$($file.Name)"
        } catch {
            Write-Warning "更新文件失败 $($file.Name)：$_"
        }
    }
}

Add-CustomPropertiesToOfficeFiles -path $directory -tags $newTags

方案2：使用Office COM组件（需已安装Office） #

通过Office程序的COM接口直接修改文档属性：

$directory = "C:\Your\Directory\Path"
$newTags = @{
    "Tag1" = "Value1"
}

function Add-CustomPropertiesViaCOM {
    param(
        [Parameter(Mandatory=$true)]
        [string]$path,
        [Parameter(Mandatory=$true)]
        [hashtable]$tags
    )
    # 映射文件格式到对应的Office程序
    $officeApps = @{
        ".docx" = "Word.Application"
        ".xlsx" = "Excel.Application"
        ".pptx" = "PowerPoint.Application"
    }

    $files = Get-ChildItem -Path $path -Recurse -File | Where-Object { $officeApps.ContainsKey($_.Extension) }

    foreach ($file in $files) {
        try {
            $app = New-Object -ComObject $officeApps[$file.Extension]
            $app.Visible = $false
            $doc = $app.Documents.Open($file.FullName)

            foreach ($tag in $tags.GetEnumerator()) {
                # 添加或更新自定义属性
                $doc.CustomDocumentProperties.Add($tag.Key, $false, [Microsoft.Office.Core.MsoDocProperties]::msoPropertyTypeString, $tag.Value)
            }

            $doc.Save()
            $doc.Close()
            $app.Quit()
            # 清理COM对象，避免残留Office进程
            [System.Runtime.Interopservices.Marshal]::ReleaseComObject($doc) | Out-Null
            [System.Runtime.Interopservices.Marshal]::ReleaseComObject($app) | Out-Null
            Write-Host "成功更新文件属性：$($file.Name)"
        } catch {
            Write-Warning "更新文件失败 $($file.Name)：$_"
            # 确保Office进程退出
            if ($app) { $app.Quit() }
        }
    }
}

Add-CustomPropertiesViaCOM -path $directory -tags $newTags

二、针对普通文件的Windows自定义属性 #

如果是给非Office文件添加资源管理器可见的属性，可通过Shell.Application对象修改系统内置可编辑属性（如关键词、备注等）：

$directory = "C:\Your\Directory\Path"
$newTags = @{
    "Tag1" = "Value1"
}

function Add-WindowsCustomProperties {
    param(
        [Parameter(Mandatory=$true)]
        [string]$path,
        [Parameter(Mandatory=$true)]
        [hashtable]$tags
    )
    $shell = New-Object -ComObject Shell.Application
    $files = Get-ChildItem -Path $path -Recurse -File

    foreach ($file in $files) {
        try {
            $folder = $shell.Namespace($file.DirectoryName)
            $fileItem = $folder.ParseName($file.Name)

            foreach ($tag in $tags.GetEnumerator()) {
                # 14对应资源管理器中的"关键词"属性，可替换为其他内置属性ID
                $folder.SetDetailsOf($fileItem, 14, $tag.Value)
            }
            Write-Host "成功更新文件属性：$($file.Name)"
        } catch {
            Write-Warning "更新文件失败 $($file.Name)：$_"
        }
    }
    # 清理COM对象
    [System.Runtime.Interopservices.Marshal]::ReleaseComObject($shell) | Out-Null
}

Add-WindowsCustomProperties -path $directory -tags $newTags

• Open XML SDK无需依赖Office，适合服务器等无Office环境；COM方式需安装对应版本的Office，且必须清理COM对象避免残留进程。
• 普通文件的自定义属性受Windows系统限制，若需添加完全自定义名称的属性，需先在注册表中注册属性项，操作相对复杂，上述示例优先使用系统内置可编辑属性。

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