< Back

Remove-TeamUser

Sat Jan 18, 2020 4:18 pm

NAME Remove-TeamUser



SYNOPSIS

Remove an owner or member from a team, and from the unified group which backs the team.



Note: the command will return immediately, but the Teams application will not reflect the update immediately. The

Teams application may need to be open for up to an hour before changes are reflected.



Note: last owner cannot be removed from the team.





SYNTAX

Remove-TeamUser -GroupId <String> -User <String> -Role <String> [<CommonParameters>]





DESCRIPTION







PARAMETERS

-GroupId <String>

GroupId of the team



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-User <String>

User's UPN (user principal name - e.g. johndoe@example.com)



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Role <String>

Specify the role of the user you are removing from the team.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



NOTES









-------------------------- Example 1 --------------------------



Remove-TeamUser -GroupId 31f1ff6c-d48c-4f8a-b2e1-abca7fd399df -User dmx@example.com -Role Owner







RELATED LINKS