Skip to content

teams team add

Adds a new Microsoft Teams team

Usage

teams team add [options]

Options

Option Description
--help output usage information
-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 or description are supplied, these take precedence over the template values
--wait Wait for the team to be provisioned before completing the command
--query [query] JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output] Output type. json,text. Default text
--pretty Prettifies json output
--verbose Runs command with verbose logging
--debug Runs command with debug logging

Remarks

Attention

This command is based on an API that is currently in preview and is subject to change once the API reached general availability.

If you want to add a Team to an existing Office 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

teams team add --name 'Architecture' --description 'Architecture Discussion'

Add a new Microsoft Teams team using a template

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

teams team add --name 'Architecture' --description 'Architecture Discussion' --templatePath 'template.json' --wait

More information