Skip to content

spo list get

Gets information about the specific list

Usage

m365 spo list get [options]

Options

-u, --webUrl <webUrl>
URL of the site where the list to retrieve is located
-i, --id [id]
ID of the list to retrieve information for. Specify either id or title but not both
-t, --title [title]
Title of the list to retrieve information for. Specify either id or title but not both
-p, --properties [properties]
Comma-separated list of properties to retrieve from the list. Will retrieve all properties possible from default response, if not specified.
--withPermissions
Set if you want to return associated roles and permissions of the list.
-h, --help
output usage information
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Examples

Return information about a list with ID 0cd891ef-afce-4e55-b836-fce03286cccf located in site https://contoso.sharepoint.com/sites/project-x

m365 spo list get --id 0cd891ef-afce-4e55-b836-fce03286cccf --webUrl https://contoso.sharepoint.com/sites/project-x

Return information about a list with title Documents located in site https://contoso.sharepoint.com/sites/project-x

m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/sites/project-x

Get information about a list returning the specified list properties

m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Id,HasUniqueRoleAssignments,AllowContentTypes"

Get information about a list along with the roles and permissions

m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/sites/project-x --withPermissions

More information