Microsoft Entra Connect 同步：目录扩展功能

可以使用目录扩展程序，通过从本地 Active Directory 提供的自有属性，扩展 Microsoft Entra ID 中的架构。 此功能允许使用继续在本地管理的属性来构建 LOB 应用。 可通过扩展使用这些属性。 可以使用 Microsoft Entra PowerShell 查看可用属性。 目前，没有Microsoft 365工作负荷会使用这些属性，但可以在Microsoft Entra ID中将此功能与动态组成员身份一起使用。

选择要与Microsoft Entra ID同步的属性

在自定义设置中配置想要使用 Microsoft Entra Connect 配置向导同步的扩展属性。

向导显示了与目录扩展一起使用的有效候选属性：

• “用户”和“组”对象类型
• 单值属性：String、Boolean、Integer、Binary
• 多值属性：String、Binary

使用目录扩展时的重要注意事项

• 在初始安装 Microsoft Entra Connect 期间从Active Directory架构读取属性列表。 如果使用更多自定义属性扩展Active Directory架构，则必须刷新架构才能看到这些新属性。

• 如果导出了包含用于同步目录扩展属性的自定义规则的配置，并且尝试将此规则导入到 Microsoft Entra Connect 的新安装或现有安装中，则会在导入期间创建该规则，但不会映射目录扩展属性。 需要重新选择目录扩展属性并将其与规则重新关联，或完全重新创建规则以解决此问题。

• 并非所有Microsoft Entra ID功能都支持多值扩展属性。 请查阅您计划使用这些属性的功能的文档，以确认它们是否受到支持。

• Microsoft Entra ID中的对象最多可以有 100 个目录扩展属性值。 对于多值属性，每个值都计入此 100 值限制。

• 字符串属性值的最大长度为 256 个字符。 如果属性值超过此限制，同步引擎会截断该值。

• 不支持同步构造的属性，例如 msDS-UserPasswordExpiryTimeComputed。 如果从旧版 Microsoft Entra Connect 升级，则安装向导中仍可能会显示这些属性，因此不应启用它们，因为其值不会同步到Microsoft Entra ID。 学习模式。

• 不支持同步非复制属性，例如 badPwdCount、Last-Logon 和 Last-Logoff，因为其值不会同步到Microsoft Entra ID。

• 不支持在 Microsoft Entra Connect 向导之外管理本地目录扩展。 手动编辑或克隆目录扩展的同步规则可能会导致同步问题。

• 不支持将属性值从 Microsoft Entra Connect 同步到 Microsoft Entra Connect 未创建的扩展属性。 这样做可能会产生性能问题和意外结果。

向导对 Microsoft Entra ID 进行的配置更改

在安装 Microsoft Entra Connect 期间，会注册一个应用程序，并在其中配置这些属性。 可以在 Microsoft Entra 管理中心中看到此应用程序，名称为 Tenant Schema Extension App。 请确保选择 “所有应用程序 ”以查看此应用。

查看Microsoft Entra ID中的扩展属性

扩展属性的格式是 extension_{ApplicationId}_<attributeName>，其中 ApplicationId 是 租户架构扩展应用的应用程序标识符。 本主题中所有其他方案都需要此值。

使用Microsoft Graph PowerShell SDK

1. 获取 租户架构扩展应用 应用程序：

Get-MgApplication -Filter "DisplayName eq 'Tenant Schema Extension App'"

2. 列出 租户架构扩展应用的所有扩展属性：

Get-MgDirectoryObjectAvailableExtensionProperty

3. 列出用户对象的所有扩展属性：

(Get-MgBetaUser -UserId "<Id or UserPrincipalName>").AdditionalProperties

使用 Microsoft Entra PowerShell

1. 获取 租户架构扩展应用 应用程序标识符：

Get-EntraApplication -SearchString "Tenant Schema Extension App"

2. 列出 租户架构扩展应用应用程序的所有扩展 属性：

Get-EntraExtensionProperty | Where-Object {$_.AppDisplayName -eq 'Tenant Schema Extension App'}

3. 列出用户对象的所有扩展属性：

Get-EntraUserExtension -UserId "<Id or UserPrincipalName>"

后续步骤

详细了解 Microsoft Entra Connect Sync 配置。

详细了解 将本地标识与 Microsoft Entra ID 集成。