Table of Contents

Remove-PnPTeamsTeam

SYNOPSIS

Required Permissions

  • Microsoft Graph API: Group.ReadWrite.All

Removes a Microsoft Teams Team instance and its corresponding Microsoft 365 Group

SYNTAX

Remove-PnPTeamsTeam -Identity <TeamsTeamPipeBind> [-Force]  

DESCRIPTION

Removes a Microsoft Teams Team. This also removes the associated Microsoft 365 Group, and is functionally identical to Remove-PnPMicrosoft365Group

EXAMPLES

EXAMPLE 1

Remove-PnPTeamsTeam -Identity 5beb63c5-0571-499e-94d5-3279fdd9b6b5

Removes the specified Team

EXAMPLE 2

Remove-PnPTeamsTeam -Identity testteam

Removes the specified Team. If there are multiple teams with the same display name it will not proceed deleting the team.

PARAMETERS

-Force

Specifying the Force parameter will skip the confirmation question.

Type: SwitchParameter
Parameter Sets: (All)

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Identity

Specify the group id, mailNickname or display name of the team to remove.

Type: TeamsTeamPipeBind
Parameter Sets: (All)

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Microsoft 365 Patterns and Practices