SharePoint Online: PowerShell to Get List Permissions

Requirement: Get List Permissions in SharePoint Online using PowerShell

How to Get List Permissions in SharePoint Online?

To view permissions applied to SharePoint Online list, follow these steps:

  • Navigate to your SharePoint Online List >> Click on Settings Gear >> List Settings
  • On the List Settings page, click on the “Permissions on this List” link
  • This page gets you all permissions on the particular list.
    sharepoint online powershell get list permissions

SharePoint Online PowerShell to Get List Permissions

Here is the PowerShell to get list permissions and export to CSV in SharePoint Online

#Load SharePoint CSOM Assemblies
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"
#Function to Get List Permissions
Function Get-SPOListPermission([String]$SiteURL, [String]$ListName)
        #Setup the context
        $Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($SiteURL)
        $Ctx.Credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($Cred.Username, $Cred.Password)
        #Get the List
        $List = $Ctx.Web.Lists.GetByTitle($ListName)
        #Get permissions assigned to the List
        $RoleAssignments = $List.RoleAssignments
        #Loop through each permission assigned and extract details
        $PermissionCollection = @()
        Foreach($RoleAssignment in $RoleAssignments)
            #Get the User Type
            $PermissionType = $RoleAssignment.Member.PrincipalType
            #Get the Permission Levels assigned
            $PermissionLevels = ($RoleAssignment.RoleDefinitionBindings | Select -ExpandProperty Name) -join ","
            #Get the User/Group Name
            $Name = $RoleAssignment.Member.Title # $RoleAssignment.Member.LoginName
            #Add the Data to Object
            $Permissions = New-Object PSObject
            $Permissions | Add-Member NoteProperty Name($Name)
            $Permissions | Add-Member NoteProperty Type($PermissionType)
            $Permissions | Add-Member NoteProperty PermissionLevels($PermissionLevels)
            $PermissionCollection += $Permissions
        Return $PermissionCollection
    Catch {
    write-host -f Red "Error Getting List Permissions!" $_.Exception.Message
#Set Config Parameters
$ReportFile = "C:\Temp\ListPermissions.csv"
#Get Credentials to connect
$Cred= Get-Credential
#Call the function to Get List Permissions
$ListPermissions = Get-SPOListPermission $SiteURL $ListName

#Get List Permissions

#Export List Permissions to CSV File
$ListPermissions | Export-CSV $ReportFile -NoTypeInformation

and the exported CSV file looks like this:

sharepoint online powershell list permissions

Salaudeen Rajack

Salaudeen Rajack is a SharePoint Architect with Two decades of SharePoint Experience. He loves sharing his knowledge and experiences with the SharePoint community, through his real-world articles!

One thought on “SharePoint Online: PowerShell to Get List Permissions

  • July 27, 2020 at 6:11 PM

    Error Getting List Permissions! Exception calling “ExecuteQuery” with “0” argument(s): “‘center’ is an unexpected
    token. The expected token is ‘”‘ or ”’. Line 7, position 12.” Unfortunately this is what I get. Must be doing something wrong.


Leave a Reply