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
templatePath
not supplied -d, --description [description]
- Description for the Microsoft Teams team. Required if
templatePath
not supplied --templatePath [templatePath]
- Local path to the file containing the template. 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
. Defaulttext
--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
m365 teams team add --name "Architecture" --description "Architecture Discussion" --templatePath "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" --templatePath "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