Skip to main content

teams team remove

Removes the specified Microsoft Teams team

Usage​

m365 teams team remove [options]

Options​

-i, --id [id]

The ID of the Microsoft Teams team to remove. Specify either id or name but not both.

-n, --name [name]

The display name of the Microsoft Teams team to remove. Specify either id or name but not both.

-f, --force

Don't prompt for confirming removing the specified team.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

When deleted, Microsoft 365 groups are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted. This applies only to Microsoft 365 groups.

If the command finds multiple Microsoft Teams teams with the specified name, it will prompt you to disambiguate which team it should use, listing the discovered team IDs.

Examples​

Removes the specified Microsoft Teams team by id.

m365 teams team remove --id 00000000-0000-0000-0000-000000000000

Removes the specified Microsoft Teams team by name.

m365 teams team remove --name "Team Name"

Removes the specified team without confirmation.

m365 teams team remove --id 00000000-0000-0000-0000-000000000000 --force

Response​

The command won't return a response on success.

More information​

CTRL + M