CIPP.app icon

CIPP.app

Manage Microsoft 365 tenants via CIPP.app

Actions619

Mailbox → List Restricted Users

AI-generated

Summary

Queries the specified tenant to retrieve a list of users marked as restricted in Microsoft 365 Exchange Online.

Inputs

  • tenantFilter (required) — The tenant to perform the operation on. Select from a list of available tenants or enter a specific domain (e.g., contoso.onmicrosoft.com).
  • returnAll — Whether to return all results or only up to a given limit.
  • limit — Max number of results to return (1-500). Only applies when Return All is disabled.

Output shape

a list of items

Each item represents a restricted user. The exact field structure depends on the CIPP API response; typically includes identifiers like User Principal Name (UPN) and display names.

Examples

Example 1: List restricted users in a specific tenant with a maximum of 100 results.

Tenant: [Select Tenant], Return All: false, Limit: 100

Example 2: Retrieve the complete list of restricted users without a size limit.

Tenant: [Select Tenant], Return All: true

Links

Discussion