Get-MgDynamicAdminUnit
SYNOPSIS
Retrieves the dynamic administrative units from Entra ID with membership rule analysis.SYNTAX
DESCRIPTION
The Get-MgDynamicAdminUnit function retrieves the Entra ID administrative units whose membership is dynamic, with their membership rule, the user and device attributes the rule reads and the member count. It flags the administrative units whose rule uses the deprecated MemberOf rule operator and lists the source groups that rule reads. By default, only the member count is returned (MembersCount). Use -IncludeMembers to also get the concatenated lists of member names and IDs, or -MemberReport to get one row per (administrative unit, member). Dynamic groups are covered by Get-DynamicGroup.EXAMPLES
EXAMPLE 1
EXAMPLE 2
EXAMPLE 3
EXAMPLE 4
EXAMPLE 5
PARAMETERS
-AdminUnitId
When specified, retrieves only the dynamic administrative unit with this object ID. If not specified, retrieves all dynamic administrative units.-DeprecatedMemberOfRuleOnly
When specified, returns only the administrative units whose membership rule uses the deprecated MemberOf rule operator (e.g. user.memberof -any (group.objectId -in […])). Microsoft ends this preview operator: after November 3, 2026, affected memberships stop updating and stay in their last known state. Tenants with Microsoft Entra ID Governance keep it working until March 31, 2027 (MC1488839). Without this switch, the DeprecatedMemberOfRule property still flags affected administrative units.-ExportPath
Optional output directory for the Excel export (defaults to the user profile).-ExportToExcel
When specified, exports the result to an Excel file in the user’s profile directory instead of returning it. When combined with -MemberReport, the member rows are written to a second worksheet named “Members” in the same workbook.-IncludeMembers
When specified, populates the MembersName (pipe-separated display names) and MembersId (pipe-separated object IDs) properties in addition to MembersCount. By default, only MembersCount is populated to avoid slow enumeration on large administrative units. Ignored when -MemberReport is used.-MemberReport
When specified, the function returns one row per (administrative unit, member) pair instead of the per-administrative unit objects. Output columns: AdminUnitId, AdminUnitName, MembershipRule, MemberId, MemberDisplayName, MemberPrincipal, MemberType.CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.INPUTS
OUTPUTS
System.Collections.Generic.List[PSCustomObject]
Not documented.NOTES
OUTPUT PROPERTIES (default / -IncludeMembers mode)- AdminUnitId: Unique identifier of the administrative unit
- Name: Display name of the administrative unit
- Type: Dynamic User or Dynamic Device, from the objects the membership rule reads
- MembershipRule: The membership rule, on one line
- MembershipRuleProcessingState: On or Paused
- UserAttributes: Pipe-separated list of user attributes referenced in the membership rule
- DeviceAttributes: Pipe-separated list of device attributes referenced in the membership rule
- SourceGroupIds: Pipe-separated list of the group IDs a MemberOf rule reads (empty otherwise)
- MembersCount: Number of current members of the administrative unit
- MembersName: Pipe-separated list of member display names (only with -IncludeMembers)
- MembersId: Pipe-separated list of member IDs (only with -IncludeMembers)
- Description, Visibility, IsMemberManagementRestricted
- DeprecatedMemberOfRule: True if the membership rule uses the deprecated MemberOf rule operator (preview ending: memberships stop updating after November 3, 2026)
- Warning: Deprecation warning if the administrative unit uses the MemberOf rule operator
- AdminUnitId, AdminUnitName, MembershipRule
- MemberId, MemberDisplayName, MemberPrincipal, MemberType