Teams#

Overview#

VOSS Automate allows you to manage Microsoft Teams from within the Admin portal. Changes you make to teams in VOSS Automate or in the Microsoft Teams online portal are synced.

A team comprises its members, its channels (where team members share messages and other resources), and its privacy and permissions settings.

Note

A Microsoft Team is a collection of people, content, and tools that are grouped together for a common purpose. For example, you may want to add a group of engineers working for the same project, to a team.

In the Microsoft Teams online portal, an admin user can:

  • Add or update a team, and give it a name and description

  • Make the team private or public.

  • Add a team owner

  • Move a team (Provider admin only)

When using a Microsoft client (desktop or phone), a Microsoft end user can add teams from teams templates.

../../_images/view-ms-teams-detail.png

Related Topics

Add and Update MS Teams#

This procedure adds, edits, or deletes Microsoft Teams, teams and team members, in VOSS Automate.

Note

Changes you make to MS teams in VOSS Automate syncs to the Microsoft Teams online portal. You can also view changes made to MS teams in the MS Teams portal online, from VOSS Automate.

Pre-requisites:

  • When configuring VOSS Automate for Microsoft, you will need to assign the following permissions to the API registration in the MS Entra admin portal to allow MS Teams objects to successfully sync in to VOSS Automate, and to allow you to manage these objects in VOSS Automate:

    • TeamMember.Read.All,

    • TeamMember.ReadWrite.All,

    • TeamMember.Read.Group

To add and update MS teams:

  1. In the VOSS Automate Admin Portal, go to (default menus) Subscriber Management > Teams.

  2. View existing teams in the list view.

    Note

    • The number of Teams in the list view matches the number of Teams in the Microsoft Portal.

    • The Teams list view displays synced in data for MS Teams. Clicking on a Team to view its details triggers a live update from the Microsoft Entra ID portal to fetch additional details for the Team, including its members and channels. This is to ensure efficient and fast data syncing for Teams and Groups from Microsoft Entra ID. Data syncs for Teams and Groups are handled in the same way in the Automate GUI. Since Microsoft doesn’t differentiate between Teams and Groups, both the Teams and Groups list view and details page point to the same model, device/msgraph/Group, with a filter applied to differentiate between these entities in the Automate GUI.

  3. Choose an option:

    • Edit a team: To edit a MS team, click on the relevant team in the list view to open its management page, then update settings, and click Save.

      Note

      You can add or remove members, change member roles, update Team settings, and archive, unarchive, or delete a team, and move a team (Provider admin only). However, channel membership type is read-only in the Automate Admin Portal, and will need to be updated in the Microsoft Portal, if required.

      To archive or unarchive a Team, select the relevant team(s) in the list view, then click the relevant toolbar option (Archive Team or Unarchive Team). The Is Archived checkbox is read-only when a team is archived, and you can’t add or update team members and channels.

      All changes are synced to the Microsoft Teams online portal.

      ../../_images/view-ms-teams-detail-member.png

    • Move a team: As a Provider admin, you can move one or more MS teams via the list view, or click on a team to open its configuration page, then move the team.

      ../../_images/manage-teams-edit.png

      Note

      When moving a team, team members remain at their existing location. Only the team is moved. However, let’s say you moved a team to a site and you want to add additional members, then you can add new members that are at the site where the team now exists, even though the team still contains members that may be at a different location in the hierarchy.

    • Add a team: To add a MS team, click the Plus icon (+) to open the Teams page, then fill out team details:

      • Fill out a display name (mandatory) and (optionally) a description.

      • Choose a privacy policy, either public or private.

        Note

        The default is Public.

      • At Is Archived define whether the team may be archived.

      • At Teams Templates, choose a template, if you wish to create the team from a predefined, custom template.

      • At Members, click the Plus icon (+) to add team members (one or more), and define the member’s role, either owner or member.

        Note

        At least one user must be assigned the team owner role.

      • At Channels, click the Plus icon (+) to add channels (one or more).

        Note

        The first channel (General), is added by default. All members you add to the team are added to this channel.

        VOSS Automate only supports adding channels with membership type Standard. In the Microsoft Teams online portal, you can add channels that have any of the following membership types: Private, Standard, or Shared

      • At Member Settings, select permissions that will apply to team members. For example, you can define whether to allow team members to add or update channels, to create private channels, to add or remove apps, or to delete channels.

      • At Guest Settings, define whether to allow guest team members to add, update, or delete channels.

      • At Messaging Settings, define permissions for messages, for example, choose whether to allow ordinary members to edit or delete messages, define whether team owners can delete messages, and whether to allow team or channel mentions.

      • At Fun Settings, define whether to allow Giphy, set a content rating for Giphy, and define whether to allow stickers and memes.