microsoftgraph / microsoftgraph/entra-powershell

🚀 -ExpandProperty support

Open
#1,452 0 comments 5 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Feature P0 ToTriage
Dominant language
PowerShell
Stars
213
Forks
46
PR merge metrics
No merged PRs in 30d

Description

Current Challenge:

Users often query complex Graph objects with deeply nested properties (e.g., user.assignedLicenses, group.members). Without -ExpandProperty, users must manually parse nested objects or make additional Get-Mg* or API calls, which increases script complexity and runtime. This is not ideal for usability.

Why it matters:

Entra PowerShell reduces customer friction and improves usability through thoughtful cmdlet and parameter design. This feature supports that goal. Admins frequently need nested data (e.g., user's manager, group membership, license assignments) in reporting and automation tasks.

-ExpandProperty provides a first-class experience for common identity and access management scenarios - addressing real-world scenarios.

Benefits:
  • Reduces Number of API Calls - this reduces throttling risks and speeds up large batch operations—critical in large tenants.
  • Aligns with Microsoft Graph REST API Capabilities - the underlying Microsoft Graph API supports $expand for many properties (e.g., /users?$expand=manager). Supporting -ExpandProperty in PowerShell ensures feature parity and reduces the learning curve for Graph API users transitioning to PowerShell.
Roadmap tracker:

This issue serves as a https://github.com/orgs/microsoftgraph/projects/69/.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the Microsoft Graph $expand capability and the roadmap tracker linked in the issue. The issue does not name cmdlets, files, tests, or a defined completion scope, so clarify which Graph objects and PowerShell commands must support -ExpandProperty and how completion will be verified.

Written by the indexing model from the issue text.

Assessment

Tech stack
powershell
Domain
api, developer-experience
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.