[Index]

Model: relation/MicrosoftTeams

Manage Teams

Full HTML Help

Overview

VOSS Automate allows you to manage teams of Microsoft Teams users 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:

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

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:

To add and update MS teams:

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

  2. View existing teams in the list view.

  3. Choose an option:

Model Details: relation/MicrosoftTeams

Title Description Details
Id Id of Team
  • Field Name: id
  • Type: String
Channels The collection of channels and messages associated with the team. Changes to a team, such as adding or removing members, can take up to 10 minutes to appear in search results.
  • Field Name: channels.[n]
  • Type: Array
Display Name Display name of team channel member can be set on add and also be updated.
  • Field Name: channels.[n].displayName
  • Type: String
Description Description of team channel member can be set on add and also be updated.
  • Field Name: channels.[n].description
  • Type: String
Membership Type Shows if a channel is a private, standard, or shared channel. You cannot update the Membership Type value for an existing channel. Default: standard
  • Field Name: channels.[n].membershipType
  • Type: String
  • Default: standard
  • Choices: ["Standard", "Private", "Shared"]
Id Id of team channel.
  • Field Name: channels.[n].id
  • Type: String
Email Email of team channel.
  • Field Name: channels.[n].email
  • Type: String
Display Name * Name of the team to be added or updated.
  • Field Name: displayName
  • Type: String
Description An optional description for the team. Maximum length: 1024 characters.
  • Field Name: description
  • Type: String
Discovery Settings
  • Field Name: discoverySettings
  • Type: Object
Show In Teams Search And Suggestions
  • Field Name: discoverySettings.showInTeamsSearchAndSuggestions
  • Type: Boolean
Fun Settings Settings to configure use of Giphy, memes, and stickers in the team.
  • Field Name: funSettings
  • Type: Object
Allow Giphy
  • Field Name: funSettings.allowGiphy
  • Type: Boolean
Giphy Content Rating Giphy Content Rating
  • Field Name: funSettings.giphyContentRating
  • Type: String
  • Choices: ["Moderate", "Strict"]
Allow Stickers And Memes
  • Field Name: funSettings.allowStickersAndMemes
  • Type: Boolean
Allow Custom Memes
  • Field Name: funSettings.allowCustomMemes
  • Type: Boolean
Guest Settings Settings to configure whether guests can create, update, or delete channels in the team.
  • Field Name: guestSettings
  • Type: Object
Allow Create Update Channels
  • Field Name: guestSettings.allowCreateUpdateChannels
  • Type: Boolean
Allow Delete Channels
  • Field Name: guestSettings.allowDeleteChannels
  • Type: Boolean
Is Membership Limited To Owners
  • Field Name: isMembershipLimitedToOwners
  • Type: Boolean
Is Archived Whether this team is in read-only mode.
  • Field Name: isArchived
  • Type: Boolean
Members Members and owners of the team. Changes to a team, such as adding or removing members, can take up to 10 minutes to appear in search results.
  • Field Name: members.[n]
  • Type: Array
Username Username.
  • Field Name: members.[n].username
  • Type: String
  • Target: device/msgraph/MsolUser
  • Target attr: UserPrincipalName
  • Format: uri
Role Shows whether a user in the list is a team owner or member. Default: member
  • Field Name: members.[n].role
  • Type: String
  • Default: member
  • Choices: ["Owner", "Member"]
Id
  • Field Name: members.[n].id
  • Type: String
Display Name
  • Field Name: members.[n].displayName
  • Type: String
Member Settings Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team.
  • Field Name: memberSettings
  • Type: Object
Allow Create Update Channels
  • Field Name: memberSettings.allowCreateUpdateChannels
  • Type: Boolean
Allow Create Private Channels
  • Field Name: memberSettings.allowCreatePrivateChannels
  • Type: Boolean
Allow Delete Channels
  • Field Name: memberSettings.allowDeleteChannels
  • Type: Boolean
Allow Add Remove Apps
  • Field Name: memberSettings.allowAddRemoveApps
  • Type: Boolean
Allow Create Update Remove Tabs
  • Field Name: memberSettings.allowCreateUpdateRemoveTabs
  • Type: Boolean
Allow Create Update Remove Connectors
  • Field Name: memberSettings.allowCreateUpdateRemoveConnectors
  • Type: Boolean
Messaging Settings Settings to configure messaging and mentions in the team.
  • Field Name: messagingSettings
  • Type: Object
Allow User Edit Messages
  • Field Name: messagingSettings.allowUserEditMessages
  • Type: Boolean
Allow User Delete Messages
  • Field Name: messagingSettings.allowUserDeleteMessages
  • Type: Boolean
Allow Owner Delete Messages
  • Field Name: messagingSettings.allowOwnerDeleteMessages
  • Type: Boolean
Allow Team Mentions
  • Field Name: messagingSettings.allowTeamMentions
  • Type: Boolean
Allow Channel Mentions
  • Field Name: messagingSettings.allowChannelMentions
  • Type: Boolean
Teams Templates
  • Field Name: teamsTemplates
  • Type: String
Privacy The visibility of the group and team. Defaults to Public.
  • Field Name: visibility
  • Type: String
  • Choices: ["Public", "Private"]
Noinstance
  • Field Name: noinstance.[n]
  • Type: Array
  • Cardinality: [0..1]
Name *
  • Field Name: noinstance.[n].name
  • Type: String
  • MaxLength: 1024