Table of Contents

Update-PnPTeamsUser

SYNOPSIS

Required Permissions

  • Microsoft Graph API: Group.ReadWrite.All

Updates a user's role in an existing Microsoft Teams instance.

SYNTAX

Update-PnPTeamsUser -Team <TeamsTeamPipeBind> -User <String> -Role <String>

DESCRIPTION

This cmdlet updates the role of the specified user in the selected Teams instance to Member or Owner.

EXAMPLES

EXAMPLE 1

Update-PnPTeamsUser -Team MyTeam -User john@doe.com -Role Owner

Updates a user as an owner of the team.

EXAMPLE 2

Update-PnPTeamsUser -Team MyTeam -User john@doe.com -Role Member

Updates a user as a member of the team.

EXAMPLE 3

Update-PnPTeamsUser -Team a0c0a395-4ba6-4fff-958a-000000506d18 -User john@doe.com -Role Member -Force

Updates john@doe.com user as a member of the team and skips the confirmation question.

PARAMETERS

-Role

Specify the role of the user

Type: String
Parameter Sets: (All)
Accepted values: Owner, Member

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

-Team

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

Type: TeamsTeamPipeBind
Parameter Sets: (All)

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

-User

Specify the UPN (e.g. john@doe.com)

Type: String
Parameter Sets: (All)

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

-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

Microsoft 365 Patterns and Practices Microsoft Graph documentation

Edit this page