Skip to content

teams team add

Adds a new Microsoft Teams team

Usage

m365 teams team add [options]

Options

-n, --name [name]
Display name for the Microsoft Teams team. Required if template not supplied
-d, --description [description]
Description for the Microsoft Teams team. Required if template not supplied
--template [template]
Template to use to create the team. If name or description are supplied, these take precedence over the template values
--wait
Wait for the team to be provisioned before completing the command
-h, --help
output usage information
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Remarks

If you want to add a Team to an existing Microsoft 365 Group use the aad o365group teamify command instead.

This command will return different responses based on the presence of the --wait option. If present, the command will return a group resource in the response. If not present, the command will return a teamsAsyncOperation resource in the response.

Examples

Add a new Microsoft Teams team

m365 teams team add --name "Architecture" --description "Architecture Discussion"

Add a new Microsoft Teams team using a template from a file

m365 teams team add --name "Architecture" --description "Architecture Discussion" --template @template.json

Add a new Microsoft Teams team using a template and wait for the team to be provisioned

m365 teams team add --name "Architecture" --description "Architecture Discussion" --template @template.json --wait

More information