Cross-team channel inventory and audit.

Lists every channel across teams with its membership type, archive status, and email, and summarizes how channels are structured.

Private and shared channels extend the collaboration surface (guests, external members), so this flags them for security review.

Permissions

Requires delegated or application permissions: Team.ReadBasic.All List all teams Channel.ReadBasic.All List channels

Reference

• https://learn.microsoft.com/en-us/graph/api/team-list-channels

View source

import argparse
from collections import Counter
from typing import Optional

from office365.graph_client import GraphClient
from tests.settings import client_id, client_secret, tenant


def _resolve_teams(client: GraphClient, team_id: Optional[str]):
    if team_id:
        team = client.teams[team_id].get().execute_query()
        return [team] if team else []
    return list(client.teams.get_all().execute_query() or [])


def main():
    parser = argparse.ArgumentParser(description="Cross-team channel inventory and audit")
    parser.add_argument("--team", default=None, help="only inspect this team id (otherwise all teams)")
    parser.add_argument("--max-teams", type=int, default=0, help="limit the number of teams scanned (default: all)")
    args = parser.parse_args()

    client = GraphClient(tenant=tenant).with_client_secret(client_id, client_secret)
    teams = _resolve_teams(client, args.team)
    if args.max_teams:
        teams = teams[: args.max_teams]

    summary: Counter = Counter()
    extended = 0
    for team in teams:
        try:
            channels = team.channels.get().execute_query()
        except Exception:
            continue
        print(f"[{team.display_name}]  {len(channels)} channel(s)")
        for ch in channels:
            membership = str(ch.membership_type.value)
            archived = ch.is_archived or False
            summary[membership] += 1
            if membership != "standard":
                extended += 1
            print(
                f"  {ch.display_name or '(unnamed)':30s} type={membership:9s} "
                f"archived={'yes' if archived else 'no ':3s} email={ch.email or '-'}"
            )

    print("\nSummary:")
    for membership, count in summary.most_common():
        print(f"  {membership:9s}: {count}")
    print(f"  private/shared (extended surface): {extended}")


if __name__ == "__main__":
    main()

---

← Back to Microsoft Teams