Powershell中声明EmailMessage的ExtendedPropertyDefinition抛出歧义重载异常

场景背景 #

EWS云环境中特定邮箱的ExtendedProperties存在数量限制，打算修改代码只复用一个ExtendedProperty，每次发送邮件时给它设置不同的属性值，方便后续查找并处理对应邮件对象。

遇到的问题 #

按照官方文档配置代码时，声明ExtendedPropertyDefinition时抛出异常：“找到多个匹配的重载，参数数量为3”。

异常相关代码 #

# 邮件对象$email已完成声明
.
.
.
# 属性声明与赋值

# 用固定GUID确保复用同一个扩展属性，先转换为Guid类型
$GUIDproperty = "00000000-0000-0000-0000-000000000000"
$propertyGUID = [Guid]$GUIDproperty
# 每次生成唯一值赋值给这个扩展属性
$propertyValue = [guid]::NewGuid().ToString()
$propertyName = "Id"
# 此行抛出重载匹配异常
$ExtendedProperty = [Microsoft.Exchange.WebServices.Data.ExtendedPropertyDefinition]::new($propertyGUID, $propertyName, $propertyType)
# 实际未执行到此处，仅展示完整逻辑
$email.SetExtendedProperty($ExtendedProperty, $propertyValue)

问题原因&解决办法 #

原因

ExtendedPropertyDefinition存在两个3参数构造函数：一个接收Guid、string、MapiPropertyType；另一个接收DefaultExtendedPropertySet枚举、string、MapiPropertyType。PowerShell无法自动区分要调用的重载——枚举值可隐式转换为整数，Guid类型在PowerShell中的识别逻辑易与枚举混淆，最终导致重载匹配冲突。

解决办法

方法1：强制指定参数类型

明确告知PowerShell第一个参数为Guid类型，消除重载歧义，同时确保$propertyType为MapiPropertyType枚举的有效值：

# 根据propertyValue的类型定义属性类型，此处为字符串类型
$propertyType = [Microsoft.Exchange.WebServices.Data.MapiPropertyType]::String
# 强制转换第一个参数为Guid，避免重载匹配错误
$ExtendedProperty = [Microsoft.Exchange.WebServices.Data.ExtendedPropertyDefinition]::new([Guid]$propertyGUID, $propertyName, $propertyType)

方法2：使用命名参数

通过指定参数名明确匹配目标构造函数：

$propertyType = [Microsoft.Exchange.WebServices.Data.MapiPropertyType]::String
$ExtendedProperty = [Microsoft.Exchange.WebServices.Data.ExtendedPropertyDefinition]::new(
    -PropertySetId $propertyGUID,
    -Name $propertyName,
    -MapiType $propertyType
)

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