< Back
Remove-TeamUser
Post
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
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