跨林迁移通讯组脚本执行报错：无法找到企业组织容器

最近我在推进跨林迁移工作，写了个脚本用来协助迁移通讯组，单组测试的流程是这样的：

• 先从源域拉取通讯组的LegacyExchangeDN以及所有SMTP地址
• 给通过ADMT迁移到目标域的通讯组启用邮件功能，补上Exchange正常运行需要的属性
• 最后从源域移除这个组，尝试创建对应的邮件联系人，结果执行New-MailContact命令时直接报错：

Couldn't find the Enterprise Organization Container

折腾了一番，总结了几个常见的原因和对应的解决办法，分享给大家：

可能的原因及修复方案 #

1. 目标域的Exchange架构没准备到位 #

如果目标域是刚部署Exchange，或者跨林迁移前没完成完整的架构扩展和AD准备，就会出现找不到企业组织容器的问题。

• 解决办法：在目标域的Exchange服务器上重新运行安装程序，完成架构扩展和AD准备：

  Setup.exe /PrepareSchema /IAcceptExchangeServerLicenseTerms
  Setup.exe /PrepareAD /OrganizationName:"你的Exchange组织名称" /IAcceptExchangeServerLicenseTerms
  

  注意要使用拥有Enterprise Admin权限的账号来执行这些命令。

2. 执行命令的账号权限不够 #

New-MailContact需要足够的权限去访问AD里的企业组织容器，至少得有Exchange Recipient Administrator权限，权限不够的话就会触发这个错误。

• 解决办法：切换到拥有目标域Exchange Recipient Administrator（或者更高权限，比如Enterprise Admin）的账号下再执行命令，先测试下权限是否足够。

3. AD站点复制有延迟 #

如果刚做完ADMT迁移或者Exchange架构操作，AD站点之间可能还没同步完成，导致Exchange找不到对应的容器对象。

• 解决办法：等个10-15分钟让AD自动复制，或者手动触发全站点同步：

  Repadmin /syncall /AdeP
  

  同步完成后再尝试创建邮件联系人。

4. Exchange组织容器位置异常或缺失 #

AD的配置分区里，Exchange组织容器的默认路径是CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=你的目标域,DC=com，如果这个容器被误删或者位置不对，也会报错。

• 解决办法：用ADSI Edit查看配置分区里的Exchange组织容器是否存在：
  1. 打开ADSI Edit，连接到Configuration命名上下文
  2. 导航到CN=Services下，检查是否有CN=Microsoft Exchange容器
     如果不存在，重新执行AD准备操作（参考第一条）；如果存在，执行New-MailContact时可以显式指定组织参数：

  New-MailContact -Name "迁移的联系人名称" -ExternalEmailAddress "原组的外部邮箱地址" -OrganizationalUnit "OU=迁移联系人,DC=target,DC=com" -Organization "你的Exchange组织名称"
  

额外的脚本优化建议 #

可以在脚本里加上错误捕获和日志记录，方便后续排查问题，比如：

try {
    $contactParams = @{
        Name                  = $contactDisplayName
        ExternalEmailAddress  = $sourceGroupSMTP
        OrganizationalUnit    = "OU=CrossForestContacts,DC=targetdomain,DC=com"
        Organization          = "MyExchangeOrg"
    }
    New-MailContact @contactParams
    Write-Host "[$(Get-Date)] 邮件联系人 $contactDisplayName 创建成功" -ForegroundColor Green
} catch {
    $errorMsg = "[$(Get-Date)] 创建邮件联系人失败：$($_.Exception.Message)"
    Write-Host $errorMsg -ForegroundColor Red
    $errorMsg | Out-File "CrossForestMigrationErrors.log" -Append
}

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