exchange-graph-test

Simple test tool for Microsoft Graph API for populating Exchange mailboxes (e.g. room mailboxes) with calendar events. It illustrates fetching, creating and deleting events and use of batching in Graph API also.

Components used:

• .NET 5
• Microsoft Graph SDK
• System.CommandLine

Detail

This is a specific use case and may not be of use to others directly but feel free to fork and customise or just use as an example.

This is based on a test set up with test mailboxes with the same name pattern differing by number.

e.g. testroom1@mydomain, testroom2@mydomain, etc

--mailboxTemplate must be supplied as a format string, e.g. testroom{0}@mydomain for it to populate the mailbox addresses to use.

--numMailbox specifies the number of mailboxes to iterrate and --startMailbox the initial number (default 1)

A transactionId is used per event to track for testing and to allow the delete command to find the events. --transactionId allows specifying of an ID. This is used as a prefix, each event will have a unique ID appended. On delete it searches for the prefix in each event.

create does 10 runs through all mailboxes incrementing date every 2 hours and creates a random number of events per mailbox. Due to concurrency limits per mailbox (4 requests) it will only create up to 4 events per mailbox in a run. --maxEvents controls how many events to create per mailbox (a value greater than 4 will result in a max of 4).

get fetches events for the mailboxes with a summary count of events, or with --dumpEvents it will trace the event responses. If --transactionId is specified it filters to only those with that prefix in TransactionId.

delete deletes the events based on --transactionId used as prefix for the TransactionId.

Azure AD Application requirements

This requires an application created and configured in Azure AD with application permissions for Graph API for calendar access. See https://docs.microsoft.com/en-us/graph/auth-v2-service

Calendars.ReadWrite is the main permissions required and admin consent will be required for the application permission. It is also possible to scope the permissions to specific mailboxes using ApplicationAccessPolicy. https://docs.microsoft.com/en-us/graph/auth-limit-mailbox-access

Usage

ExchangeGraphTool
  Exchange Graph API test tool for creating bulk events

Usage:
  ExchangeGraphTool [options] [command]

Options:
  --clientId <clientId>                Graph API Client ID
  --tenantId <tenantId>                Graph API Tenant ID
  --clientSecret <clientSecret>        Graph API Client Secret
  --mailboxTemplate <mailboxTemplate>  Mailbox address template (format <name>{0}@<domain>)
  --numMailbox <numMailbox>            Number of mailboxes to use in template
  --startMailbox <startMailbox>        Start number of mailboxes to use in template, default one
  --version                            Show version information
  -?, -h, --help                       Show help and usage information

Commands:
  get     Fetches events matching specified transaction ID, or all events if not specified
  Options:
    --transactionId                    Use specified ID as prefix for transaction ID on events or return all events otherwise
    --dumpEvents                       Dump event detail
  create  Creates sample events
  Options:
    --maxEvents                        Max number of events per mailbox, default 1
    --transactionId                    Use specified ID as prefix for transaction ID on events, otherwise generates a new GUID
  delete  Deletes events matching specified transaction ID
  Options:
    --transactionId                    Use specified ID as prefix for transaction ID to match events to delete