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. If the library does not exist yet, tries to ensure it is created.
EXAMPLES
EXAMPLE 1
Add-PnPPage -Name "NewPage"
Creates a new page named 'NewPage'. The resulting file will accordingly be named 'NewPage.aspx'. If a file with that name already exists, executing the commandlet will fail.
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
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