spo list view add¶
Adds a new view to a SharePoint list
Usage¶
m365 spo list view add [options]
Options¶
-u, --webUrl <webUrl>
- URL of the site where the list is located.
--listId [listId]
- ID of the list to which the view should be added. Specify either
listId
,listTitle
orlistUrl
but not multiple. --listTitle [listTitle]
- Title of the list to which the view should be added. Specify either
listId
,listTitle
orlistUrl
but not multiple. --listUrl [listUrl]
- Relative URL of the list to which the view should be added. Specify either
listId
,listTitle
orlistUrl
but not multiple. --title <title>
- Title of the view to be created for the list.
--fields <fields>
- Comma-separated list of case-sensitive internal names of the fields to add to the view.
--viewQuery [viewQuery]
- XML representation of the list query for the underlying view.
--personal
- View will be created as personal view, if specified.
--default
- View will be set as default view, if specified.
--paged
- View supports paging, if specified (recommended to use this).
--rowLimit [rowLimit]
- Sets the number of items to display for the view. Default value is 30.
-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
. Defaultjson
--verbose
- Runs command with verbose logging
--debug
- Runs command with debug logging
Remarks¶
We recommend using the paged
option. When specified, the view supports displaying more items page by page (default behavior). When not specified, the rowLimit
is absolute, and there is no link to see more items.
Examples¶
Add a view called All events to a list with specific title.
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "My List" --title "All events" --fields "FieldName1,FieldName2,Created,Author,Modified,Editor" --paged
Add a view as default view with title All events to a list with a specific URL.
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl "/Lists/MyList" --title "All events" --fields "FieldName1,Created" --paged --default
Add a personal view called All events to a list with a specific ID.
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listId 00000000-0000-0000-0000-000000000000 --title "All events" --fields "FieldName1,Created" --paged --personal
Add a view called All events with defined filter and sorting.
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "My List" --title "All events" --fields "FieldName1" --viewQuery "<OrderBy><FieldRef Name='Created' Ascending='FALSE' /></OrderBy><Where><Eq><FieldRef Name='TextFieldName' /><Value Type='Text'>Field value</Value></Eq></Where>" --paged