Microsoft Entra Connect 同步:了解宣告式佈建運算式

Microsoft Entra 連線 Sync 是以宣告式布建為基礎,首先在 Forefront Identity Manager 2010 中引進。 它可讓您實作完整的身分識別整合商業規則,而不需要撰寫編譯的程序代碼。

宣告式布建的基本部分是屬性流程中使用的表達式語言。 使用的語言是 Microsoft® Visual Basic® for Applications (VBA) 的子集。 此語言用於 Microsoft Office,且具有 VBScript 體驗的使用者也會辨識該語言。 宣告式布建表示式語言只會使用函式,而不是結構化語言。 沒有方法或語句。 函式會改為巢狀表示程式流程。

如需詳細資訊,請參閱 歡迎使用 Office 2013 的 Visual Basic for Applications 語言參考。

屬性是強型別。 函式只接受正確類型的屬性。 它也區分大小寫。 函式名稱和屬性名稱都必須有適當的大小寫,否則會擲回錯誤。

語言定義和識別碼

  • 函式的名稱後面接著括號中的自變數:FunctionName(argument 1,argument N)。
  • 屬性是由方括弧識別:[attributeName]
  • 參數是由百分比符號識別: %ParameterName%
  • 字串常數會以引號括住:例如,「Contoso」 (注意:必須使用直引號 “”,而不是智慧引號 “”)
  • 數值會以無引號表示,且預期為十進位。 十六進位值前面加上 &H。 例如,98052 和 HFF
  • 布爾值會以常數表示:True、False。
  • 內建常數和常值只會以其名稱表示:NULL、CRLF、IgnoreThisFlow

函式

宣告式布建會使用許多函式來啟用轉換屬性值的可能性。 這些函式可以巢狀化,因此一個函式的結果會傳入另一個函式。

Function1(Function2(Function3()))

您可以在函式參考中找到函式的完整清單。

參數

參數是由 連線 或系統管理員使用PowerShell所定義。 參數通常包含不同於系統與系統的值,例如使用者所在的網域名稱。 這些參數可用於屬性流程。

Active Directory 連線 or 為輸入同步處理規則提供了下列參數:

參數名稱 註解
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

系統會提供下列參數,用來取得目前執行中 連線 or 的標識碼:
Connector.ID

以下是使用使用者所在網域 netbios 名稱填入 Metaverse 屬性網域的範例:
domain<- %Domain.Netbios%

操作員

您可以使用下列運算子:

  • 比較:<、<=、<>、=、>>=
  • 數學:+、-、*、-
  • 字串: & (串連)
  • 邏輯: && (和), ||(或)
  • 評估順序:()

運算子會由左至右評估,且具有相同的評估優先順序。 也就是說,在 - (減法) 之前不會評估 * (乘數)。 2*(5+3) 與 2*5+3 不同。 括弧 () 用於在左至右評估順序不適用時變更評估順序。

多重值屬性

函式可以在單一值和多重值屬性上運作。 針對多重值屬性,函式會針對每個值運作,並將相同的函式套用至每個值。

例如:
Trim([proxyAddresses]) 執行 proxyAddress 屬性中每個值的 Trim。
Word([proxyAddresses],1,"@") & "@contoso.com" 針對以 @-sign 的每個值,將網域取代為 @contoso.com。
IIF(InStr([proxyAddresses],"SIP:")=1,NULL,[proxyAddresses]) 尋找 SIP 位址,並將它從值中移除。

下一步

  • 深入了解瞭解宣告式佈建中的組態模型。
  • 請參閱瞭解預設組態中的宣告式布建如何現用。
  • 請參閱如何對預設組態進行變更,瞭解如何使用宣告式布建進行實際變更。

概觀主題

參考主題