Skip to content

adaptiveScopeMembers

Adaptive Scope Members. Resolved users, groups, or sites that match an adaptive scope. The adaptiveScopeMembers entity set lives under /exchange/v1.0/adaptiveScopeMembers in the Governance & protection category.

Fact Value
Path /exchange/v1.0/adaptiveScopeMembers
Category Governance & protection
Tier Tier 5, Compliance
Read role Compliance.IPPS.Read.All (Community)
Write role none (read-only)
Backing cmdlets Get-AdaptiveScopeMembers
Method Path Synopsis Role Plan
GET /exchange/v1.0/adaptiveScopeMembers List adaptiveScopeMembers under the given scope (scope is REQUIRED). Compliance.IPPS.Read Community

List adaptiveScopeMembers under the given scope (scope is REQUIRED).

Backing cmdlet: Get-AdaptiveScopeMembers. Role: Compliance.IPPS.Read (Community).

Parameter In Type Required Description
scope query string Parent adaptive scope (Name or Identity). REQUIRED - list-all is not supported by the cmdlet.
pageResultSize query int Cap on rows per page (Wiki -PageResultSize).
state query string Filter members by state (Wiki -State). Valid values: Added (current members) | Removed (former members).
pageCookie query string Pagination continuation token. Maps -PageCookie on Get-AdaptiveScopeMembers - pass the Watermark value returned in the prior page’s metadata to fetch the next page of members.
adaptiveReportFilters query string Maps -AdaptiveReportFilters on Get-AdaptiveScopeMembers - JSON-encoded filter expression to narrow the resolved member report.

List adaptiveScopeMembers without ?scope= - 400

Section titled “List adaptiveScopeMembers without ?scope= - 400”

Get the adaptiveScopeMembers list endpoint without specifying the parent adaptive scope. Get-AdaptiveScopeMembers requires -Identity (the parent scope); the controller pre-checks ?scope= and returns 400 with a canonical MissingRequiredQuery envelope before the cmdlet runs. Fix: pass ?scope=<adaptiveScopeName|Guid>.

GET /exchange/v1.0/adaptiveScopeMembers HTTP/1.1
Authorization: Bearer {token}
HTTP/1.1 400 Bad Request
{
"error": {
"code": "MissingRequiredQuery",
"message": "The 'scope' query parameter is required. Get-AdaptiveScopeMembers requires a parent scope Identity - scope to one adaptive scope (e.g. ?scope=MyScope) to list its members."
}
}

Related: GET /exchange/v1.0/adaptiveScopes