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
ordescription
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
. Defaultjson
--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¶
- Get started with Teams templates: https://docs.microsoft.com/MicrosoftTeams/get-started-with-teams-templates
- group resource type: https://docs.microsoft.com/graph/api/resources/group?view=graph-rest-1.0
- teamsAsyncOperation resource type: https://docs.microsoft.com/graph/api/resources/teamsasyncoperation?view=graph-rest-1.0