Add-PnPPage
SYNOPSIS
Creates a new page
SYNTAX
Add-PnPPage [-Name] <String> [-LayoutType <PageLayoutType>]
[-PromoteAs <PagePromoteType>] [-ContentType <ContentTypePipeBind>] [-CommentsEnabled] [-Publish]
[-HeaderLayoutType <PageHeaderLayoutType>] [-ScheduledPublishDate <DateTime>]
[-Translate][-TranslationLanguageCodes <Int[][]>]
[-Connection <PnPConnection>]
DESCRIPTION
Creates a new page. The page will be located inside the Site Pages library of the site currently connected to.
EXAMPLES
EXAMPLE 1
Add-PnPPage -Name "NewPage"
Creates a new page named 'NewPage'
EXAMPLE 2
Add-PnPPage -Name "NewPage" -Title "Welcome to my page"
Creates a new page NewPage.aspx with the title as provided
EXAMPLE 3
Add-PnPPage -Name "NewPage" -ContentType "MyPageContentType"
Creates a new page named 'NewPage' and sets the content type to the content type specified
EXAMPLE 4
Add-PnPPage -Name "NewPageTemplate" -PromoteAs Template
Creates a new page named 'NewPage' and saves as a template to the site.
EXAMPLE 5
Add-PnPPage -Name "Folder/NewPage"
Creates a new page named 'NewPage' under 'Folder' folder and saves as a template to the site.
EXAMPLE 6
Add-PnPPage -Name "NewPage" -HeaderLayoutType ColorBlock
Creates a new page named 'NewPage' using the ColorBlock header layout
EXAMPLE 7
Add-PnPPage -Name "NewPage" Article -ScheduledPublishDate (Get-Date).AddHours(1)
Creates a new page named 'NewPage' using the article layout and schedule it to be published in 1 hour from now
EXAMPLE 8
Add-PnPPage -Name "NewPage" -Translate
Creates a new page named 'NewPage' and also creates the necessary translated page for the supported languages in the site collection.
EXAMPLE 9
Add-PnPPage -Name "NewPage" -Translate -TranslationLanguageCodes 1043
Creates a new page named 'NewPage' and also creates the necessary translated page for the specified language in the site collection. In this case, it will create the translated page for Dutch language. If the Dutch language is not enabled, it will enable the language and then create the translated page.
EXAMPLE 10
Add-PnPPage -Name "NewPage" -Translate -TranslationLanguageCodes 1043,1035
Creates a new page named 'NewPage' and also creates the necessary translated page for the specified languages in the site collection. In this case, it will create the translated pages for Dutch and Finnish languages. If these languages are not enabled, it will enable these languages and then create the translated pages for the specified languages.
PARAMETERS
-Connection
Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
Type: PnPConnection
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CommentsEnabled
Enables or Disables the comments on the page
Type: SwitchParameter
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ContentType
Specify either the name, ID or an actual content type.
Type: ContentTypePipeBind
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HeaderLayoutType
Type of layout used for the header
Type: PageHeaderLayoutType
Parameter Sets: (All)
Accepted values: FullWidthImage, NoImage, ColorBlock, CutInShape
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LayoutType
Specifies the layout type of the page.
Type: PageLayoutType
Parameter Sets: (All)
Accepted values: Article, Home, SingleWebPartAppPage, RepostPage, HeaderlessSearchResults, Spaces, Topic
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Specifies the name of the page. It will also be used to define the filename. I.e. if you provide MyPage, it will create a page MyPage.aspx inside the Site Pages library.
Type: String
Parameter Sets: (All)
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PromoteAs
Allows to promote the page for a specific purpose (HomePage | NewsPage)
Type: PagePromoteType
Parameter Sets: (All)
Accepted values: None, HomePage, NewsArticle, Template
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Publish
Publishes the page once it is saved. Applicable to libraries set to create major and minor versions.
Type: SwitchParameter
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScheduledPublishDate
If provided, the page will be scheduled to be published on the provided date and time. It will enable page scheduling on the Site Pages library if not already enabled. If not provided, the publishing of the page will not be scheduled.
Type: DateTime
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Translate
Creates multilingual pages for all the languages specified in the site collection
Type: SwitchParameter
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TranslationLanguageCodes
Creates multilingual pages for specified languages.
Type: Integer array
Parameter Sets: (All)
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False