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 位址,並將它從值中移除。
下一步
概觀主題
參考主題
意見反映
https://aka.ms/ContentUserFeedback。
即將推出:我們會在 2024 年淘汰 GitHub 問題,並以全新的意見反應系統取代並作為內容意見反應的渠道。 如需更多資訊,請參閱:提交及檢視以下的意見反映: