New-PnPWeb

Tip

We encourage you to make improvements to this documentation. Please navigate to https://github.com/pnp/powershell/blob/dev/documentation/New-PnPWeb.md to change this file.

Creates a new subweb under the current web

Syntax

New-PnPWeb
   -Title <String>
   -Url <String>
   [-Description <String>]
   [-Locale <Int32>]
   -Template <String>
   [-BreakInheritance]
   [-InheritNavigation]
   [-Connection <PnPConnection>]
   [<CommonParameters>]

Examples

EXAMPLE 1

New-PnPWeb -Title "Project A Web" -Url projectA -Description "Information about Project A" -Locale 1033 -Template "STS#0"

Creates a new subweb under the current web with URL projectA

Parameters

-BreakInheritance

By default the subweb will inherit its security from its parent, specify this switch to break this inheritance

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

The description of the new web

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InheritNavigation

Specifies whether the site inherits navigation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Locale

The language id of the new web. default = 1033 for English

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Template

The site definition template to use for the new web, e.g. STS#0. Use Get-PnPWebTemplates to fetch a list of available templates

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Title

The title of the new web

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Url

The URL of the new web

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False