Remove-TeamChannelUser

Module:

MicrosoftTeamsPowerShell

Nota

The command will return immediately, but the Teams application will not reflect the update immediately, please refresh the members page to see the update.

To turn an existing Owner into a Member, specify role parameter as Owner.

Nota

Last owner cannot be removed from the private channel.

Syntax

PowerShell

Remove-TeamChannelUser
      -GroupId <String>
      -DisplayName <String>
      -User <String>
      [-Role <String>]
      [<CommonParameters>]

Description

Nota

This cmdlet is part of the Public Preview version of Teams PowerShell Module, for more information see Install Teams PowerShell public preview and also see Microsoft Teams PowerShell Release Notes.

Examples

Example 1

PowerShell

Remove-TeamChannelUser -GroupId 31f1ff6c-d48c-4f8a-b2e1-abca7fd399df -DisplayName "Engineering" -User dmx@example.com

Parameters

-DisplayName

Display name of the private channel

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

-GroupId

GroupId of the team

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

-Role

Use this to demote a user from owner to member of the team

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

-User

User's email address (e.g. johndoe@example.com)

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