通过


Microsoft Entra 域服务的自定义属性

出于各种原因,公司通常无法修改旧版应用的代码。 例如,应用程序可以使用自定义属性(比如自定义员工 ID),并依赖该属性执行 LDAP 操作。

Microsoft Entra ID支持使用 extensions 向资源添加自定义数据。 Microsoft Entra域服务可以从Microsoft Entra ID同步以下类型的扩展,因此还可以使用依赖于域服务的自定义属性的应用:

  • onPremisesExtensionAttributes 是一组 15 个属性,可以存储扩展的用户字符串属性。
  • 目录扩展 允许特定目录对象的架构扩展,如用户和组,用强类型属性通过在租户中注册到应用程序。

可以使用 Microsoft Entra Connect 为本地管理的用户配置这两种类型的扩展,也可以为仅限云的用户配置Microsoft Graph API。

注释

同步不支持以下类型的扩展:

  • Microsoft Entra ID中的自定义安全属性
  • Microsoft Graph架构扩展
  • Microsoft Graph开放扩展

要求

自定义属性支持的最低 SKU 是企业 SKU。 如果使用 Standard,则需要将托管域 升级到 Enterprise 或 Premium。 有关详细信息,请参阅 Microsoft Entra 域定价

自定义属性的工作原理

创建托管域后,单击“设置”下的“自定义属性”以启用属性同步。 单击“ 保存” 以确认更改。

如何启用自定义属性的屏幕截图。

启用预定义的属性同步

单击 OnPremisesExtensionAttributes 以同步 “extensionAttribute1-15” 属性,也称为 Exchange 自定义属性

同步Microsoft Entra目录扩展属性

这些是您在 Microsoft Entra 租户中定义的扩展用户属性或组属性。

选择 “+ 添加” 以选择要同步的自定义属性。 该列表显示租户中的可用扩展属性。 可以使用搜索栏筛选列表。

如何添加目录扩展属性的屏幕截图。

如果未看到要查找的目录扩展,请输入该扩展的关联应用程序 appId,然后单击“ 搜索 ”以仅加载该应用程序定义的扩展属性。 当多个应用程序在租户中定义多个扩展时,此搜索会有所帮助。

注释

如果要看到Microsoft Entra Connect 同步的目录扩展,请单击Enterprise App并查找 Tenant 架构扩展应用的应用程序 ID。 有关详细信息,请参阅 Microsoft Entra Connect Sync:目录扩展

单击 “选择”,然后单击 “保存” 以确认更改。

如何保存目录扩展属性的屏幕截图。

域服务会用载入的自定义属性值填充所有同步的用户和组。 自定义属性值逐渐填充Microsoft Entra ID中包含目录扩展的对象。 在回填同步过程中,Microsoft Entra ID中的增量更改将暂停,同步时间取决于租户的大小。

若要检查回填状态,请单击Domain Services Health并验证与Microsoft Entra ID的同步监视器在加入后的一小时内具有更新的时间戳。 更新后,回填即完成。

Active Directory Domain Services的保留属性

以下属性是为Windows Server中的Active Directory Domain Services保留的。 它们不能用于 Microsoft Entra 域服务。

名称 特征
AccountDisabled accountDisabled
AzureAdMailNickname msDS-AzureADMailNickname
AadObjectId msDS-aadObjectId
城市 l
通用名称 cn
公司 company
国家 co
部门 部门
DESCRIPTION 说明
DisplayName displayName
DistinguishedName distinguishedName
员工编号 员工编号
ExchangeExtensions extensionAttribute
ExchangeExtension1 extensionAttribute1
ExchangeExtension2 extensionAttribute2
ExchangeExtension3 extensionAttribute3
ExchangeExtension4 extensionAttribute4
ExchangeExtension5 extensionAttribute5
ExchangeExtension6 extensionAttribute6
ExchangeExtension7 extensionAttribute7
ExchangeExtension8 extensionAttribute8
ExchangeExtension9 extensionAttribute9
ExchangeExtension10 extensionAttribute10
ExchangeExtension11 extensionAttribute11
ExchangeExtension12 extensionAttribute12
ExchangeExtension13 extensionAttribute13
ExchangeExtension14 extensionAttribute14
ExchangeExtension15 extensionAttribute15
FacsimileTelephoneNumber facsimileTelephoneNumber
GenerationSeq msDS-generationSeq
GivenName givenName
群组类型 groupType
LinkSeq msDS-linkSeq
邮件 邮件
经理 管理员
成员 成员
MemberOf memberOf
手机 移动
ObjectClass 对象类
对象全球唯一标识符 objectGUID
Pager 寻呼机
实物交付办公室名称 物理递送办公室名称
邮政编码 邮政编码
PreferredLanguage 首选语言
代理地址 代理地址
PasswordLastSet pwdLastSet
Sam帐户名 sAMAccountName
安全描述符 nTSecurityDescriptor
SID历史 sIDHistory
国家 st
StreetAddress streetAddress
Surname sn
SupplementalCredentials supplementalCredentials
电话号码 电话号码
标题 title
UnicodePwd unicodePwd
用户帐户控制 userAccountControl
UserPrincipalName userPrincipalName
EscrowType msDS-escrowType
EscrowOperation msDS-escrowOperation
SourceAadObjectId msDS-aadObjectId
TargetAadObjectId msDS-targetAadObjectId
AadGraphLink msDS-aadGraphLink
AadGraphDQLink msDS-aadlink
EscrowCount msDS-escrowCount
FirstSteadyStateTime msDS-firstSteadyStateTime
LastSteadyStateTime msDS-lastSteadyStateTime
隔离开始时间 msDS-quarantineStartTime
QuarantineSyncWaitPeriod msDS-quarantineSyncWaitPeriod
SingleSyncRequests msDS-单次同步请求
字符串值 msDS-stringValues
同步请求状态 msDS-syncRequestStatus
SyncStatus msDS-syncStatus
WhenChanged whenChanged
已删除对象编号 msDS-deletedObjectNumber
CustomAttributeState msDS-customAttribute-state
自定义属性类型 msDS-customAttribute-type
LegacyAadObjectId msDS-AzureADObjectId
名称 姓名
Revision revision
AdminDisplayName adminDisplayName
AdminDescription adminDescription
LdapDisplayName lDAPDisplayName
AttributeId attributeId
属性语法 attributeSyntax
OmSyntax omSyntax
IsSingleValued isSingleValued
MayContain mayContain
SchemaUpdateNow schemaUpdateNow
IsDefunct isDefunct

后续步骤

若要在 Microsoft Entra ID 中为仅限云的用户配置 onPremisesExtensionAttributes 或目录扩展,请参阅 Microsoft Graph 中的 Custom 数据选项。

若要将 onPremisesExtensionAttributes 或目录扩展从本地同步到 Microsoft Entra ID,配置 Microsoft Entra Connect