spo page add¶
Creates modern page
Usage¶
m365 spo page add [options]
Options¶
-n, --name <name>
- Name of the page to create
-u, --webUrl <webUrl>
- URL of the site where the page should be created
-t, --title [title]
- Title of the page to create. If not specified, will use the page name as its title
-l, --layoutType [layoutType]
- Layout of the page. Allowed values
Article,Home
. DefaultArticle
-p, --promoteAs [promoteAs]
- Create the page for a specific purpose. Allowed values
HomePage,NewsPage
--commentsEnabled
- Set to enable comments on the page
--publish
- Set to publish the page
--publishMessage [publishMessage]
- Message to set when publishing the page
--description [description]
- The description to set for the page
-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
. Defaulttext
--verbose
- Runs command with verbose logging
--debug
- Runs command with debug logging
Remarks¶
If you try to create a page with a name of a page that already exists, you will get a The file exists
error.
If you choose to promote the page using the promoteAs
option or enable page comments, you will see the result only after publishing the page.
Examples¶
Create new modern page. Use the Article layout
m365 spo page add --name new-page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team
Create new modern page and set its title
m365 spo page add --name new-page.aspx --title 'My page' --webUrl https://contoso.sharepoint.com/sites/a-team
Create new modern page. Use the Home page layout and include the default set of web parts
m365 spo page add --name new-page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --layoutType Home
Create new article page and promote it as a news article
m365 spo page add --name new-page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --promoteAs NewsPage
Create new page and set it as the site's home page
m365 spo page add --name new-page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --layoutType Home --promoteAs HomePage
Create new article page and promote it as a template
m365 spo page add --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --promoteAs Template
Create new article page and enable comments on the page
m365 spo page add --name new-page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --commentsEnabled
Create new article page and publish it
m365 spo page add --name new-page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --publish
Create new article page with description
m365 spo page add --name page.aspx --webUrl https://contoso.sharepoint.com/sites/a-team --description "Description to add for the page"