Remove-PnPAzureADGroupOwner

SYNOPSIS

Required Permissions

• Microsoft Graph API : One of Directory.ReadWrite.All, Group.ReadWrite.All

Removes owners from a particular Azure Active Directory group. This can be a security, distribution or Microsoft 365 group.

SYNTAX

Remove-PnPAzureADGroupOwner -Identity <AzureADGroupPipeBind> -Users <String[]> [-Verbose]

Remove-PnPAzureADGroupOwner -Identity <AzureADGroupPipeBind> -MemberObjectId <Guid[]> [-Verbose]

DESCRIPTION

Allows to remove owners from Azure Active Directory group.

EXAMPLES

EXAMPLE 1

Remove-PnPAzureADGroupOwner -Identity "Project Team" -Users "john@contoso.onmicrosoft.com","jane@contoso.onmicrosoft.com"

Removes the provided two users as owners from the Azure Active Directory group named "Project Team".

EXAMPLE 2

# Remove an owner by ObjectId
Remove-PnPAzureADGroupOwner -Identity $groupId -MemberObjectId $ownerObjectId

Removes the owner (user or group) with ObjectId $ownerObjectId from the group identified by $groupId.

EXAMPLE 3

# Pipeline by property name (Id)
Get-PnPAzureADGroupOwner -Identity $groupId | Where-Object { $_.Id -eq $ownerObjectId } | Remove-PnPAzureADGroupOwner -Identity $groupId

Pipes an owner whose Id matches $ownerObjectId into the cmdlet and removes it.

PARAMETERS

-Identity

The Identity of the Azure Active Directory group to remove owners from.

Type: AzureADGroupPipeBind
Parameter Sets: (All)

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

-Users

The UPN(s) of the user(s) to remove as owners from the Azure Active Directory group.

Type: String[]
Parameter Sets: (All)

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

-MemberObjectId

The ObjectId(s) of directory object(s) (Users or Groups) to remove from the Azure Active Directory group as owners. Use this to remove owners that do not have a UPN.

Type: Guid[]
Parameter Sets: ByObjectId

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

RELATED LINKS

Microsoft 365 Patterns and Practices Microsoft Graph documentation