Microsoft Entra Connect 同步：了解声明性预配表达式

  • 项目

Microsoft Entra Connect 同步基于 Forefront Identity Manager 2010 中最先引入的声明式预配。 使用该功能可以实现完整的标识集成业务逻辑，而无需编写已编译的代码。

声明性设置的一个重要组成部分是属性流中使用的表达式语言。 所用的语言是 Microsoft® Visual Basic® for Applications (VBA) 的子集。 Microsoft Office 中使用了这种语言，具有 VBScript 经验的用户都认识该语言。 声明性预配表达式语言只使用函数，不属于结构化语言。 它不提供任何方法或语句。 函数嵌套在表达式程序流中。

有关详细信息，请参阅 Welcome to the Visual Basic for Applications language reference for Office 2013（欢迎使用适用于 Office 2013 的 Visual Basic 应用程序语言参考）。

属性属于强类型。 函数只接受正确类型的属性。 它还区分大小写。 函数名称和属性名称都必须具有正确的大小写，否则会引发错误。

语言定义和标识符

  • 函数名称后跟加括号的参数：FunctionName(argument 1, argument N)。
  • 属性采用方括号标识，如 [attributeName]。
  • 参数通过百分比符号标识：%ParameterName%
  • 字符串常量放在引号中：例如 "Contoso"（注意：必须使用直引号 ""，而不能使用弯引号“”）
  • 数字值表示不带引号，并且应为十进制。 十六进制值带有前缀 &H。 例如，98052, &HFF
  • 表示布尔值的常量： True、 False。
  • 内置常量和文本仅使用其名称表示：NULL、CRLF、IgnoreThisFlow

函数

声明性预配使用许多函数来实现转换属性值的可能性。 这些函数可以嵌套，因此，一个函数的结果将传递到另一个函数。

Function1(Function2(Function3()))

有关函数的完整列表，请参阅函数参考。

参数

通过连接器或由管理员使用 PowerShell 定义参数。 参数通常包含因系统不同而各异的值，例如用户所在域的名称。 这些参数可在属性流中使用。

Active Directory 连接器为入站同步规则提供以下参数：

参数名称 评论
Domain.Netbios 当前正在导入的域的 Netbios 格式，例如 FABRIKAMSALES
Domain.FQDN 当前正在导入的域的 FQDN 格式，例如 sales.fabrikam.com
Domain.LDAP 当前正在导入的域的 LDAP 格式，例如 DC=sales,DC=fabrikam,DC=com
Forest.Netbios 当前正在导入的林名称的 Netbios 格式，例如 FABRIKAMCORP
Forest.FQDN 当前正在导入的林名称的 FQDN 格式，例如 fabrikam.com
Forest.LDAP 当前正在导入的林名称的 LDAP 格式，例如 DC=fabrikam,DC=com

系统提供以下参数用于获取当前正在运行的连接器的标识符：
Connector.ID

以下示例使用用户所在域的 netbios 名称填充 Metaverse 属性域：
domain<- %Domain.Netbios%

运算符

可以使用以下运算符：

  • 比较：<、<=、<>、=、>、>=
  • 数学：+、-、*、-
  • 字符串：&（连接）
  • 逻辑：&&（和）、||（或）
  • 计算顺序：( )

运算符从左到右进行求值，并具有相同的求值优先级。 也就是说，*（乘号）不会在 -（减号）之前求值。 2*(5+3) 与 2*5+3 不同。 如果从左到右的求值顺序不适当，可以使用括号 () 来更改求值顺序。

多值属性

可对单值和多值属性运行函数。 对于多值属性，函数将针对每个值运行，向每个值应用相同的函数。

例如：
Trim([proxyAddresses]) 对 proxyAddress 属性中的每个值执行 Trim。
Word([proxyAddresses],1,"@") & "@contoso.com" 对于包含 @ 符号的每个值，将域替换为 @contoso.com。
IIF(InStr([proxyAddresses],"SIP:")=1,NULL,[proxyAddresses]) 查找 SIP 地址并从值中删除该地址。

后续步骤

概述主题

参考主题