通过

使用云同步的表达式生成器

表达式生成器是 Azure 中位于云同步下的一个新函数。它有助于生成复杂的表达式。 在将这些表达式应用到云同步环境之前，可以使用它测试这些表达式。

使用表达式生成器

若要访问表达式生成器，请执行以下操作：

  1. 以至少混合标识管理员身份登录到 Microsoft Entra 管理中心。

  2. 浏览到 Entra ID>Entra Connect>云同步。

    显示 Microsoft Entra Connect 云同步主页的屏幕截图。

  1. 在 配置下，选择您的配置选项。

  2. 在“管理属性”下，选择“单击以编辑映射”。

  3. 在 编辑属性映射 窗格中，选择 添加属性映射。

  4. 在 映射类型下，选择 表达式。

  5. 选择“试用表达式生成器”。

    显示使用表达式生成器的屏幕截图。

生成表达式

在本部分中，你将使用下拉列表从支持的函数中进行选择。 然后，根据所选函数填写更多框。 选择 应用表达式后，语法将显示在 表达式输入 框中。

例如，通过从下拉列表中选择 替换，将提供更多框。 函数的语法显示在浅蓝色框中。 显示的框对应于所选函数的语法。 Replace 的工作方式取决于提供的参数。

在此示例中，当提供 oldValue 和 replacementValue 时，源代码中所有出现的 oldValue 都将替换为 replacementValue。

有关详细信息，请参阅 替换。

首先需要选择替换函数的源属性。 在此示例中已选择 mail 特性。

接下来，找到 oldValue 对应的框并输入“@fabrikam.com”。 最后，在 replacementValue 对应的框中，填写值“@contoso.com”。

表达式基本上表示，将具有 @fabrikam.com 值的用户对象的邮件属性替换为 @contoso.com 值。 选择 添加表达式时，可以在 表达式输入 框中看到语法。

注意

请务必根据选择“Replace”时出现的语法，将值放入与 oldValue 和 replacementValue 对应的框中。

有关支持的表达式的详细信息，请参阅在 Microsoft Entra ID 中编写特性映射的表达式。

有关表达式生成器输入框的信息

根据所选函数，表达式生成器提供的框接受多个值。 例如，JOIN 函数接受字符串或与给定属性关联的值。 例如，可以使用 [givenName] 属性值中包含的值，并将其与 @contoso.com 字符串值联接以创建电子邮件地址。

显示输入框值的屏幕截图。

有关可接受的值以及如何编写表达式的详细信息，请参阅 在 Microsoft Entra ID中编写属性映射的表达式。

测试表达式

在本部分中，可以测试表达式。 从下拉列表中选择“mail”特性。 填写 @fabrikam.com 作为值，然后选择“测试表达式”。

@contoso.com的值出现在 视图输出表达式框 中。

该屏幕截图显示如何测试表达式。

部署表达式

对表达式感到满意后，请选择 应用表达式。

该屏幕截图显示如何添加表达式。

此操作将表达式添加到代理配置。

显示代理配置的 屏幕截图。

在表达式上设置 NULL 值

若要将特性的值设置为 NULL，请使用具有 ""值的表达式。 此表达式将 NULL 值流向目标属性。

显示 NULL 值的屏幕截图。

后续步骤