Microsoft Entra ID 中群組的動態成員資格規則
在 Microsoft Entra ID (Microsoft Entra 的一部分) 中，您可建立以屬性為基礎的規則，以啟用群組的動態成員資格。 動態群組成員資格會使用根據成員屬性的成員資格規則，自動新增和移除群組成員。 本文將詳細說明用以建立適用於使用者或裝置之動態成員資格規則的屬性和語法。 您可以為安全性群組或 Microsoft 365 群組的動態成員資格設定規則。
當使用者或裝置的屬性變更時，系統會評估目錄中的所有動態群組規則，以查看變更是否會觸發任何的群組新增或移除。 如果使用者或裝置滿足群組中的規則，則會將它們新增為該群組的成員。 如果不再滿足規則，則會將使用者移除。 您無法手動新增或移除動態群組的成員。
- 您可以為裝置或使用者建立動態群組，但無法建立同時包含使用者和裝置的規則。
- 您無法根據裝置擁有者的使用者屬性來建立裝置群組。 裝置成員資格規則只能參考裝置屬性。
注意
如欲使用此功能，則屬於一個或多個動態群組成員的每個不重複使用者，都需要 Microsoft Entra ID P1 授權或 Intune 教育版。 您不需要為了讓使用者成為動態群組的成員，而指派授權給使用者，但在 Microsoft Entra 組織中，授權數至少必須足以涵蓋所有這類使用者。 例如，如果組織中的所有動態群組總計有 1,000 個唯一使用者，則至少需要 1,000 個 Microsoft Entra ID P1 授權，才符合授權需求。 屬於動態裝置群組的裝置不需要任何授權。
Azure 入口網站中的規則建立器
Microsoft Entra ID 提供規則建立器，可讓您更快速建立和更新重要的規則。 規則建立器支援建構最多五個運算式。 規則建立器可讓您更輕鬆以幾個簡單的運算式來建立規則，但不可能重現每一個規則。 如果規則建立器不支援您想建立的規則，您可以使用文字方塊。
以下是一些需要使用文字輸入區域的進階規則或語法範例：
- 具有五個以上運算式的規則
- 直屬員工規則
- 具有 -contains 或 -notContains 運算子的規則
- 設定運算子優先順序
- 具有複雜運算式的規則，例如
(user.proxyAddresses -any (_ -startsWith "contoso"))
注意
規則建立器可能無法顯示文字方塊中建構的某些規則。 當規則建立器無法顯示規則時，您可能會看到訊息。 規則建立器完全不會變更動態群組規則支援的語法、驗證或處理。
如需其他逐步指示，請參閱建立或更新動態群組。
單一運算式的規則語法
單一運算式是最簡單的成員資格規則形式，只包含上述三個部分。 具有單一運算式的規則看起來類似此範例：Property Operator Value，其中屬性的語法是 object.property 的名稱。
以下範例說明正確建構的成員資格規則 (具有單一運算式)：
user.department -eq "Sales"
單一運算式的括號是選擇性的。 成員資格規則的本文總長度不得超過 3072 個字元。
建構成員資格規則的本文
自動填入使用者或裝置群組的成員資格規則是可導致 true 或 false 結果的二進位運算式。 簡單規則的三個部分如下：
- 屬性
- 運算子
- 值
運算式內的部分順序很重要，可避免發生語法錯誤。
支援的屬性
有三種類型的屬性可用來建構成員資格規則。
- 布林值
- DateTime
- String
- 字串集合
以下是您可用來建立單一運算式的使用者屬性。
布林型別的屬性
| 屬性 | 允許的值 | 使用方式 |
|---|---|---|
| accountEnabled | true false | user.accountEnabled -eq true |
| dirSyncEnabled | true false | user.dirSyncEnabled -eq true |
日期時間類型的屬性
| 屬性 | 允許的值 | 使用方式 |
|---|---|---|
| employeeHireDate (預覽) | 任何 DateTimeOffset 值或關鍵字 system.now | user.employeeHireDate -eq "value" |
字串類型的屬性
| 屬性 | 允許的值 | 使用方式 |
|---|---|---|
| 市/鎮 | 任何字串值或 null | user.city -eq "value" |
| 國家/地區 | 任何字串值或 null | user.country -eq "value" |
| companyName | 任何字串值或 null | user.companyName -eq "value" |
| 部門 | 任何字串值或 null | user.department -eq "value" |
| displayName | 任何字串值 | user.displayName -eq "value" |
| employeeId | 任何字串值 | user.employeeId -eq "value" user.employeeId -ne null |
| facsimileTelephoneNumber | 任何字串值或 null | user.facsimileTelephoneNumber -eq "value" |
| givenName | 任何字串值或 null | user.givenName -eq "value" |
| jobTitle | 任何字串值或 null | user.jobTitle -eq "value" |
| 任何字串值或 null (使用者的 SMTP 位址) | user.mail -eq "value" | |
| mailNickName | 任何字串值 (使用者的郵件別名) | user.mailNickName -eq "value" |
| memberOf | 任何字串值 (有效的群組物件識別碼) | user.memberof -any (group.objectId -in ['value']) |
| 行動 | 任何字串值或 null | user.mobile -eq "value" |
| objectId | 使用者物件的 GUID | user.objectId -eq "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" |
| onPremisesDistinguishedName | 任何字串值或 null | user.onPremisesDistinguishedName -eq "value" |
| onPremisesSecurityIdentifier | 已從內部部署環境同步至雲端之使用者的內部部署安全性識別碼 (SID)。 | user.onPremisesSecurityIdentifier -eq "S-1-1-11-1111111111-1111111111-1111111111-1111111" |
| passwordPolicies | 無 DisableStrongPassword DisablePasswordExpiration DisablePasswordExpiration, DisableStrongPassword |
user.passwordPolicies -eq "DisableStrongPassword" |
| physicalDeliveryOfficeName | 任何字串值或 null | user.physicalDeliveryOfficeName -eq "value" |
| 郵遞區號 | 任何字串值或 null | user.postalCode -eq "value" |
| preferredLanguage | ISO 639-1 code | user.preferredLanguage -eq "en-US" |
| sipProxyAddress | 任何字串值或 null | user.sipProxyAddress -eq "value" |
| state | 任何字串值或 null | user.state -eq "value" |
| streetAddress | 任何字串值或 null | user.streetAddress -eq "value" |
| surname | 任何字串值或 null | user.surname -eq "value" |
| telephoneNumber | 任何字串值或 null | user.telephoneNumber -eq "value" |
| usageLocation | 兩個字母的國家或區域代碼 | user.usageLocation -eq "US" |
| userPrincipalName | 任何字串值 | user.userPrincipalName -eq "alias@domain" |
| userType | member guest null | user.userType -eq "Member" |
字串集合類型的屬性
| 屬性 | 允許的值 | 範例 |
|---|---|---|
| otherMails | 任何字串值 | user.otherMails -startsWith "alias@domain" |
| proxyAddresses | SMTP: alias@domain smtp: alias@domain | user.proxyAddresses -startsWith "SMTP: alias@domain" |
如需裝置規則所使用的屬性，請參閱裝置的規則。
支援的運算式運算子
下表列出單一運算式支援的所有運算子及其語法。 不管有沒有連字號 (-) 前置詞，均可使用運算子。 Contains 運算子會執行部分字串的比對，但不會比對集合中的項目。
| 運算子 | 語法 |
|---|---|
| 不等於 | -ne |
| Equals | -eq |
| Not Starts With | -notStartsWith |
| 開頭為 | -startsWith |
| Not Contains | -notContains |
| 包含 | -contains |
| Not Match | -notMatch |
| 比對 | -match |
| In | -in |
| 不在 | -notIn |
使用 -in 和 -notIn 運算子
如果您想要針對多個值比較使用者屬性的值，您可使用 -in 或 -notIn 運算子。 使用方括號 "[" 和 "]" 作為值清單的開頭和結尾。
在以下範例中，如果 user.department 的值等於清單中的任何一個值，此運算式會評估為 True：
user.department -in ["50001","50002","50003","50005","50006","50007","50008","50016","50020","50024","50038","50039","51100"]
使用 -le 和 -ge 運算子
在動態群組規則中使用 employeeHireDate 屬性時，您可以使用小於 (-le) 或大於 (-ge) 運算子。
範例：
user.employeehiredate -ge system.now -plus p1d
user.employeehiredate -le 2020-06-10T18:13:20Z
使用 -match 運算子
-match 運算子可用來比對任何規則運算式。 範例：
user.displayName -match "^Da.*"
Da、Dav、David 會評估為 true，aDa 則會評估為 false。
user.displayName -match ".*vid"
David 會評估為 true，Da 則會評估為 false。
支援值
運算式中使用的值可以包含數種類型，包括：
- 字串
- 布林值 – true、false
- 數字
- 陣列 – 數字陣列、字串陣列
指定運算式中的值時，務必使用正確的語法，以避免發生錯誤。 一些語法秘訣如下：
- 除非值為字串，否則雙引號是選擇性的。
- 字串和 regex 運算都不區分大小寫。
- 當字串值包含雙引號時，兩個引號都應使用 ` 字元逸出，例如 user.department -eq `"Sales`" 是 "Sales" 為值時的正確語法。 單引號每次都要使用兩個單引號，而非單引號，才可逸出。
- 您也可以使用 null 值來執行 Null 檢查，例如
user.department -eq null。
使用 Null 值
若要在規則中指定 null 值，您可以使用 null 值。
- 在比較運算式中的 null 值時，請使用 -eq 或 -ne。
- 只有在想要將 null 一字解釋為常值字串值時，才在它的前後使用引號。
- -not 運算子不能用來作為 null 的比較運算子。 如果使用它，則不論您使用 null 還是 $null 都會收到錯誤。
參考 null 值的正確方法如下：
user.mail –ne null
具有多個運算式的規則
群組成員資格規則可以包含多個以 -and、 -or 和 -not 邏輯運算子連接的運算式。 邏輯運算子也可以合併使用。
以下範例是正確建構的成員資格規則 (具有多個運算式)：
(user.department -eq "Sales") -or (user.department -eq "Marketing")
(user.department -eq "Sales") -and -not (user.jobTitle -startsWith "SDE")
運算子優先順序
所有運算子都會列在下面 (由高至低排定優先順序)。 同一行上運算子的優先順序相等：
-eq -ne -startsWith -notStartsWith -contains -notContains -match –notMatch -in -notIn
-not
-and
-or
-any -all
以下範例說明運算子優先順序，其中有兩個運算式會針對使用者而評估：
user.department –eq "Marketing" –and user.country –eq "US"
只有在優先順序不符合您的需求時，才需要括號。 例如，如果您想要先評估部門，以下顯示如何使用括號來決定順序：
user.country –eq "US" –and (user.department –eq "Marketing" –or user.department –eq "Sales")
具有複雜運算式的規則
成員資格規則可由複雜的運算式所組成，其中的屬性、運算子和值是在更複雜的表單上取得。 當下列任一項成立時，即可視為複雜運算式：
- 屬性由值集合所組成；具體來說，就是多重值的屬性
- 運算式會使用 -any 和 -all 運算子
- 運算式的值本身可以是一或多個運算式
多重值屬性
多重值屬性是相同類型之物件的集合。 它們可以用來建立使用 -any 和 -all 邏輯運算子的成員資格規則。
| 屬性 | 值 | 使用方式 |
|---|---|---|
| assignedPlans | 集合中的每個物件都會公開下列字串屬性：capabilityStatus、service、servicePlanId | user.assignedPlans -any (assignedPlan.servicePlanId -eq "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e" -and assignedPlan.capabilityStatus -eq "Enabled") |
| proxyAddresses | SMTP: alias@domain smtp: alias@domain | (user.proxyAddresses -any (_ -startsWith "contoso")) |
使用 -any 和 -all 運算子
您可以使用 -any 和 -all 運算子，分別將條件套用至集合中的一個或所有項目。
- -any (集合中至少有一個項目符合條件時滿足)
- -all (集合中的所有項目符合條件時滿足)
範例 1
assignedPlans 是多重值屬性，可列出所有指派給使用者的服務方案。 下列運算式會選取擁有 Exchange Online (方案 2) 服務方案 (作為 GUID 值) 的使用者 (該方案也處於 [已啟用] 狀態)：
user.assignedPlans -any (assignedPlan.servicePlanId -eq "efb87545-963c-4e0d-99df-69c6916d9eb0" -and assignedPlan.capabilityStatus -eq "Enabled")
這類規則可用於將所有已啟用 Microsoft 365 或其他 Microsoft Online Service 功能的使用者分組。 您可以接著將一組原則套用到群組。
範例 2
下列運算式會選取有任何服務方案與 Intune 服務 (透過服務名稱 "SCO" 來識別) 相關聯的所有使用者：
user.assignedPlans -any (assignedPlan.service -eq "SCO" -and assignedPlan.capabilityStatus -eq "Enabled")
範例 3
下列運算式會選取未指派服務方案的所有使用者：
user.assignedPlans -all (assignedPlan.servicePlanId -eq null)
請使用底線 (_) 語法
底線 (_) 語法會比對其中一個多重值字串集合屬性中的特定值，將使用者或裝置新增至動態群組。 會搭配 -any 或 -all 運算子使用。
以下範例在規則中使用底線 (_)，依據 user.proxyAddress (與 user.otherMails 效果相同) 新增成員。 此規則會將 Proxy 位址中以「contoso」開頭的任何使用者新增至群組。
(user.proxyAddresses -any (_ -startsWith "contoso"))
其他屬性和通用規則
建立「直屬員工」規則
您可以建立一個群組，其中包含某位經理的所有直屬員工。 當經理的直屬員工在未來變更時，系統便會自動調整群組的成員資格。
使用下列語法來建構直屬員工規則：
Direct Reports for "{objectID_of_manager}"
以下是有效規則的範例，其中「aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb」是經理的 objectID：
Direct Reports for "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
下列秘訣可協助您正確使用此規則。
- [經理識別碼]是經理的物件識別碼。 在經理的設定檔可找到它。
- 若要讓規則起作用，請確定已對組織中的使用者正確設定 [經理] 屬性。 您可以在使用者的 [設定檔] 中檢查目前值。
- 此規則僅支援經理的直屬員工。 換句話說，您建立的群組無法「同時」包含經理的直屬員工及其員工。
- 此規則無法與任何其他成員資格規則結合。
建立「所有使用者」規則
您可以使用成員資格規則，建立一個包含組織內所有使用者的群組。 未來在組織中新增或移除使用者時，將會自動調整群組的成員資格。
「所有使用者」規則是在單一運算式中使用 -ne 運算子和 Null 值來建構。 此規則會將 B2B 來賓使用者及成員使用者新增到群組。
user.objectId -ne null
如果想要讓群組排除來賓使用者，而只包含組織的成員，您可以使用下列語法：
(user.objectId -ne null) -and (user.userType -eq "Member")
建立「所有裝置」規則
您可以使用成員資格規則，建立一個包含組織內所有裝置的群組。 未來在組織中新增或移除裝置時，將會自動調整群組的成員資格。
「所有裝置」規則是在單一運算式中使用 -ne 運算子和 Null 值來建構：
device.objectId -ne null
擴充屬性和自訂擴充屬性
動態成員資格規則中，以字串屬性形式支援擴充屬性和自訂擴充屬性。 擴充功能屬性可從內部部署 Windows Server Active Directory 同步，或使用 Microsoft Graph 更新並採用 "ExtensionAttributeX" 格式 (其中 X 等於 1-15)。 動態成員資格規則不支援多重值延伸模組屬性。 以下是使用擴充屬性 (attribute) 作為屬性 (property) 的規則範例：
(user.extensionAttribute15 -eq "Marketing")
自訂擴充功能屬性可從內部部署 Windows Server Active Directory、連線的 SaaS 應用程式同步，或使用 Microsoft Graph 建立，格式為 user.extension_[GUID]_[Attribute]，其中：
- 對於在 Microsoft Entra ID 中建立屬性的應用程式而言，[GUID] 是其在 Microsoft Entra ID 中簡單版的唯一識別碼。 只包含 0-9 和 A-Z 字元
- [Attribute] 是屬性建立時的名稱
以下是使用自訂擴充屬性的規則範例：
user.extension_c272a57b722d4eb29bfe327874ae79cb_OfficeNumber -eq "123"
自訂延伸模組屬性也稱為目錄或 Microsoft Entra 延伸模組屬性。
使用 [Graph 總管] 查詢使用者的屬性並搜尋屬性名稱，即可在目錄中找到自訂屬性名稱。 此外，您現在可以在動態使用者群組規則建立器中選取 [取得自訂擴充屬性] 連結，輸入唯一的應用程式識別碼，然後接收在建立動態成員資格規則時所要使用的自訂擴充屬性完整清單。 您也可以重新整理這份清單，來針對該應用程式取得任何新的自訂擴充屬性。 延伸模組屬性與自訂延伸模組屬性，必須來自您租用戶的應用程式。
如需詳細資訊，請參閱 Microsoft Entra Connect 同步：目錄延伸模組一文中的在動態群組中使用屬性。
裝置的規則
您也可以建立規則以在群組中選取成員資格的裝置物件。 您不能同時讓使用者和裝置成為群組成員。
注意
organizationalUnit 屬性不會再列出且不應使用。 此字串由 Intune 在特定情況下所設定，但 Microsoft Entra ID 無法辨識，因此沒有任何裝置會新增至以這個屬性為基礎的群組。
注意
systemlabels 是無法使用 Intune 設定的唯讀屬性。
針對 Windows 10，deviceOSVersion 屬性的正確格式如下：(device.deviceOSVersion -startsWith "10.0.1")。 您可以使用 Get-MsolDevice PowerShell Cmdlet 驗證格式：
Get-MgDevice -Search "displayName:YourMachineNameHere" -ConsistencyLevel eventual | Select-Object -ExpandProperty 'OperatingSystemVersion'
可以使用下列裝置屬性。
| 裝置屬性 | 值 | 範例 |
|---|---|---|
| accountEnabled | true false | device.accountEnabled -eq true |
| deviceCategory | 有效的裝置類別名稱 | device.deviceCategory -eq "BYOD" |
| deviceId | 有效的 Microsoft Entra 裝置識別碼 | device.deviceId -eq "d4fe7726-5966-431c-b3b8-cddc8fdb717d" |
| deviceManagementAppId | 在 Microsoft Entra ID 中建立有效的 MDM 應用程式 | 受管理 Microsoft Intune 的 device.deviceManagementAppId -eq "0000000a-0000-0000-c000-000000000000"，或是 System Center Configuration Manager 共同管理裝置的 "54b943f8-d761-4f8d-951e-9cea1846db5a" |
| deviceManufacturer | 任何字串值 | device.deviceManufacturer -eq "Samsung" |
| deviceModel | 任何字串值 | device.deviceModel -eq "iPad Air" |
| displayName | 任何字串值 | device.displayName -eq "Rob iPhone" |
| deviceOSType | 任何字串值 | (device.deviceOSType -eq "iPad") -or (device.deviceOSType -eq "iPhone") device.deviceOSType -startsWith "AndroidEnterprise" device.deviceOSType -eq "AndroidForWork" device.deviceOSType -eq "Windows" |
| deviceOSVersion | 任何字串值 | device.deviceOSVersion -eq "9.1" device.deviceOSVersion -startsWith "10.0.1" |
| deviceOwnership | 個人、公司、未知 | device.deviceOwnership -eq "Company" |
| devicePhysicalIds | Autopilot 使用的任何字串值，例如所有 Autopilot 裝置、OrderID 或 PurchaseOrderID | device.devicePhysicalIDs -any _ -startsWith "[ZTDId]" (device.devicePhysicalIds -any _ -eq "[OrderID]:179887111881" (device.devicePhysicalIds -any _ -eq "[PurchaseOrderId]:76222342342" |
| deviceTrustType | AzureAD、ServerAD、Workplace | device.deviceTrustType -eq "AzureAD" |
| enrollmentProfileName | Apple 裝置註冊設定檔名稱、Android Enterprise 公司擁有的專用裝置註冊設定檔名稱，或 Windows Autopilot 設定檔名稱 | device.enrollmentProfileName -eq "DEP iPhones" |
| extensionAttribute1 | 任何字串值 | device.extensionAttribute1 -eq "some string value" |
| extensionAttribute2 | 任何字串值 | device.extensionAttribute2 -eq "某個字串值" |
| extensionAttribute3 | 任何字串值 | device.extensionAttribute3 -eq "某個字串值" |
| extensionAttribute4 | 任何字串值 | device.extensionAttribute4 -eq "某個字串值" |
| extensionAttribute5 | 任何字串值 | device.extensionAttribute5 -eq "某個字串值" |
| extensionAttribute6 | 任何字串值 | device.extensionAttribute6 -eq "某個字串值" |
| extensionAttribute7 | 任何字串值 | device.extensionAttribute7 -eq "某個字串值" |
| extensionAttribute8 | 任何字串值 | device.extensionAttribute8 -eq "某個字串值" |
| extensionAttribute9 | 任何字串值 | device.extensionAttribute9 -eq "某個字串值" |
| extensionAttribute10 | 任何字串值 | device.extensionAttribute10 -eq "某個字串值" |
| extensionAttribute11 | 任何字串值 | device.extensionAttribute11 -eq "某個字串值" |
| extensionAttribute12 | 任何字串值 | device.extensionAttribute12 -eq "某個字串值" |
| extensionAttribute13 | 任何字串值 | device.extensionAttribute13 -eq "某個字串值" |
| extensionAttribute14 | 任何字串值 | device.extensionAttribute14 -eq "某個字串值" |
| extensionAttribute15 | 任何字串值 | device.extensionAttribute15 -eq "某個字串值" |
| isRooted | true false | device.isRooted -eq true |
| managementType | MDM (適用於行動裝置) | device.managementType -eq "MDM" |
| memberOf | 任何字串值 (有效的群組物件識別碼) | device.memberof -any (group.objectId -in ['value']) |
| objectId | 有效的 Microsoft Entra 物件識別碼 | device.objectId -eq "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" |
| profileType | Microsoft Entra ID 中有效的設定檔類型 | device.profileType -eq "RegisteredDevice" |
| systemLabels | 比對 Intune 裝置屬性以觸發新式工作場所的裝置的任何字串 | device.systemLabels -startsWith "M365Managed" |
注意
使用 deviceOwnership 為裝置建立動態群組時，您需要將此值設定為等於 Company。 在 Intune 上，裝置擁有權會改以 Corporate 表示。 如需詳細資訊，請參閱 OwnerTypes 以取得詳細資料。
使用 deviceTrustType 建立裝置的動態群組時，您必須將值設定為等於 AzureAD 以代表已使用 Microsoft Entra 而聯結的裝置；ServerAD 用於代表已使用 Microsoft Entra 混合式而聯結的裝置，或設定為 Workplace 來代表已使用 Microsoft Entra 而註冊的裝置。
使用 extensionAttribute1-15 為裝置建立動態群組時，您需要在裝置上為 extensionAttribute1-15 設定值。 深入了解如何在extensionAttributes Microsoft Entra 裝置物件寫入
下一步
這些文章提供有關 Microsoft Entra ID 中群組的其他資訊。
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應