General settings

The CtrlTMS configuration has one section per concern: how it signs in to Microsoft Graph, the properties shared by teams and channels, one section each for teams, members and channels, the workflow that drives a team’s life cycle, and discovery. Every setting is listed at the foot of this page, and each section has a page of its own with the data type every setting accepts.

Graph configuration

Client ID, Client Secret and Tenant ID come from the Entra ID registration. Leave Authentication URL, API URL and API Version at their defaults, which point at the global Microsoft Graph. See Graph configuration.

Common, team, member and channel

These sections name the vault structure CtrlTMS reads and writes, created in the vault structure step:

Common Configuration holds the properties teams and channels share: whether one is active, its Graph ID and Graph URL, and the team a channel belongs to. See Common configuration.
Team Configuration and Channel Configuration name the object type and class for each, and the properties for the display name, description, owners and members. A team also has a groups property, whose people are added to the team as members, and a property saying whether it is private. See Team configuration and Channel configuration.
Member Configuration names the object type that represents people, such as Employee, and the property holding their email address, which is how CtrlTMS matches them to Microsoft 365 accounts. See Member configuration.

Channel types

A channel is standard, private or shared, and CtrlTMS records which in a lookup property. Create a value list with one item for each of the three types first. Then, under Channel Types, select that value list and the item standing for each type, and name the lookup in Channel Type Property. See Channel types.

Workflow

A team’s life cycle is a workflow. Moving a team into Create State starts its creation in Microsoft Teams, and CtrlTMS moves it on to Created State when that succeeds or to Error State when it fails. Archived State, Deleted State and Discovered State are where archived, deleted and discovered teams sit. A team in the archived state is left out of the down-sync. See Workflow configuration.

Discovery

Discovery finds teams and channels that already exist in Microsoft Teams and creates them as objects in the vault. It runs as a background operation on Auto-run schedule, and the three switches decide whether it also brings in private teams, members and owners, and channels. See Discover configuration.