使用.Replace()后PowerShell数组对象转字符串，无法与另一数组比较

问题背景 #

使用Exchange Online和Graph维护公司通讯组时，处理外部用户遇到匹配失效问题：外部用户的UserPrincipalName包含#EXT#@company.com后缀，通过Replace处理后得到的字符串数组，无法与通讯组成员的PrimarySmtpAddress数组匹配。虽无报错，但比较时找不到共同项——尽管数组类型均为System.Array，内部元素类型都是System.String，但实际是因为处理后丢失了原始对象关联，且直接字符串对比存在隐性匹配问题。需求是保留原始对象数组的前提下完成同步。

核心问题 #

1. 原代码直接将用户对象转为字符串数组，丢失了原始PSObject的所有属性，后续无法基于对象执行移除操作
2. 外部用户的UserPrincipalName处理后得到的字符串，与通讯组成员的PrimarySmtpAddress本质是同一邮箱，但直接数组对比可能因隐性差异（如大小写、不可见字符）失效
3. 强行转字符串违背了保留原始对象的需求

解决方案：保留原始对象+统一标准化属性 #

通过给原始对象添加统一的标准化邮箱属性，基于该属性完成匹配，同时保留所有原始对象属性，方便后续执行Exchange操作。

步骤1：获取并标准化外部用户列表（保留原始对象） #

# 从Graph获取的所有活跃用户中过滤外部用户，添加标准化邮箱属性
$ExternalUsers = $allActiveUsers | Where-Object {
    # 过滤掉内部域名邮箱的用户
    $_.Mail -notmatch '.*company\.onmicrosoft\.com$|.*@company\.com$'
    # 过滤掉移除#EXT#后缀后仍属于内部域名的用户
    $normalizedUpn = $_.UserPrincipalName.Replace('#EXT#@company.com', '')
    $normalizedUpn -notmatch '.*company\.onmicrosoft\.com$|.*@company\.com$'
} | Select-Object *, @{
    Name = 'NormalizedEmail'
    Expression = { 
        # 标准化邮箱：移除#EXT#后缀并转小写，避免大小写匹配问题
        $_.UserPrincipalName.Replace('#EXT#@company.com', '').ToLower()
    }
}

步骤2：获取并标准化通讯组成员（保留原始对象） #

# 获取通讯组成员，添加与外部用户一致的标准化邮箱属性
$GrpExternalUsersMembers = Get-DistributionGroupMember -Identity "GrpExternalUsers" | Select-Object *, @{
    Name = 'NormalizedEmail'
    Expression = { 
        # 通讯组成员的PrimarySmtpAddress直接转小写，与外部用户的标准化邮箱对齐
        $_.PrimarySmtpAddress.ToLower()
    }
}

步骤3：基于标准化属性对比并执行移除操作 #

# 提取新用户列表的标准化邮箱集合
$newNormalizedEmails = $ExternalUsers.NormalizedEmail

# 找出通讯组中不在新用户列表的成员（保留原始对象）
$usersToRemove = $GrpExternalUsersMembers | Where-Object {
    $newNormalizedEmails -notcontains $_.NormalizedEmail
}

if ($usersToRemove) {
    Write-Output "Removing $($usersToRemove.Count) users from distribution group 'GrpExternalUsers'"
    foreach ($user in $usersToRemove) {
        Write-Output "Removing user: $($user.PrimarySmtpAddress)"
        # 直接使用原始对象的Identity执行移除操作，无需重新查询
        Remove-DistributionGroupMember -Identity "GrpExternalUsers" -Member $user.Identity -Confirm:$false
    }
}

关键优势 #

• 全程保留原始PSObject，无需额外查询用户ID或身份信息
• 统一的标准化属性避免了字符串对比的隐性问题（如大小写）
• 逻辑清晰，后续维护时可直接基于对象属性扩展功能

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