PowerShell操作Word自定义文档属性时GetType()返回空指针异常求助

为什么$customProperties.GetType()会抛出空引用异常？ #

$doc.CustomDocumentProperties返回的是Word COM自动化对象，而非标准.NET对象。PowerShell对COM对象的包装机制特殊：

• 虽然Write-Host能输出System.__ComObject，但这只是PowerShell对COM对象的包装标识，并非实际的.NET Type实例。
• 直接调用GetType()时，PowerShell无法从该COM对象解析出对应的.NET Type信息，因此抛出空引用异常。
• 若要查看该对象的可用成员，应使用Get-Member -InputObject $customProperties，它能正确解析COM对象暴露的方法和属性。

为什么无法按MSDN文档直接访问自定义属性？ #

Word的COM对象模型中，CustomDocumentProperties是**DocumentProperties集合对象**，而非直接可索引的属性字典：

• MSDN的示例多基于VBA或.NET互操作的原生调用，PowerShell对COM对象的成员绑定存在局限性——部分需要特定参数（如带可选参数、或非默认调用方式）的方法（如Add）无法直接通过.语法调用。
• Scripting Guy提到的反射调用方式，是通过Type.InvokeMember绕开PowerShell的COM成员解析限制，直接调用COM对象的底层方法，确保参数传递和调用逻辑符合COM接口要求。

正确操作自定义文档属性的示例代码 #

$file = "c:\Temp\Test.docx"

$word = New-Object -ComObject Word.Application
$word.Visible = $false
$doc = $word.Documents.Open($file)

$customProps = $doc.CustomDocumentProperties
$targetPropName = "MyCustomProperty"

# 检查目标属性是否已存在
$propExists = $false
foreach ($prop in $customProps) {
    if ($prop.Name -eq $targetPropName) {
        $propExists = $true
        break
    }
}

# 不存在则添加自定义属性
if (-not $propExists) {
    # 通过反射调用Add方法，参数依次为：属性名、是否链接到内容、属性类型、属性值
    # 4对应msoPropertyTypeString，其他类型可参考Word枚举：msoPropertyTypeBoolean(1)、msoPropertyTypeNumber(2)等
    $propsType = [Type]::GetTypeFromProgID("Word.DocumentProperties")
    $propsType.InvokeMember(
        "Add",
        [System.Reflection.BindingFlags]::InvokeMethod,
        $null,
        $customProps,
        @($targetPropName, $false, 4, "MyCustomValue")
    )
}

$doc.Save()
$doc.Close()
$word.Quit()

# 清理COM对象，避免Word进程残留
[System.Runtime.Interopservices.Marshal]::ReleaseComObject($customProps) | Out-Null
[System.Runtime.Interopservices.Marshal]::ReleaseComObject($doc) | Out-Null
[System.Runtime.Interopservices.Marshal]::ReleaseComObject($word) | Out-Null
[System.GC]::Collect()
[System.GC]::WaitForPendingFinalizers()

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