New-PnPTenantSite.md

external help file	applicable	schema
	SharePoint Server 2013, SharePoint Server 2016, SharePoint Online	2.0.0

New-PnPTenantSite

SYNOPSIS

Creates a new site collection for the current tenant

SYNTAX

New-PnPTenantSite -Title <String>
                  -Url <String>
                  -Owner <String>
                  -TimeZone <Int>
                  [-Description <String>]
                  [-Lcid <UInt32>]
                  [-Template <String>]
                  [-ResourceQuota <Double>]
                  [-ResourceQuotaWarningLevel <Double>]
                  [-StorageQuota <Int>]
                  [-StorageQuotaWarningLevel <Int>]
                  [-RemoveDeletedSite [<SwitchParameter>]]
                  [-Wait [<SwitchParameter>]]
                  [-Force [<SwitchParameter>]]
                  [-Connection <SPOnlineConnection>]

DESCRIPTION

The New-PnPTenantSite cmdlet creates a new site collection for the current company. However, creating a new SharePoint Online site collection fails if a deleted site with the same URL exists in the Recycle Bin. If you want to use this command for an on-premises farm, please refer to http://blogs.msdn.com/b/vesku/archive/2014/06/09/provisioning-site-collections-using-sp-app-model-in-on-premises-with-just-csom.aspx

EXAMPLES

------------------EXAMPLE 1------------------

PS:> New-PnPTenantSite -Title Contoso -Url https://tenant.sharepoint.com/sites/contoso -Owner user@example.org -TimeZone 4 -Template STS#0

This will add a site collection with the title 'Contoso', the url 'https://tenant.sharepoint.com/sites/contoso', the timezone 'UTC+01:00',the owner '[email protected]' and the template used will be STS#0, a TeamSite

------------------EXAMPLE 2------------------

PS:> New-PnPTenantSite -Title Contoso -Url /sites/contososite -Owner user@example.org -TimeZone 4 -Template STS#0

This will add a site collection with the title 'Contoso', the url 'https://tenant.sharepoint.com/sites/contososite' of which the base part will be picked up from your current connection, the timezone 'UTC+01:00', the owner '[email protected]' and the template used will be STS#0, a TeamSite

PARAMETERS

-Description

Specifies the description of the new site collection

Type: String
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Force

Do not ask for confirmation.

Type: SwitchParameter
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Lcid

Specifies the language of this site collection. For more information, see Locale IDs Assigned by Microsoft: https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.splanguage.lcid.aspx

Type: UInt32
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Owner

Specifies the user name of the site collection's primary owner. The owner must be a user instead of a security group or an email-enabled security group.

Type: String
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: False

-RemoveDeletedSite

Specifies if any existing site with the same URL should be removed from the recycle bin

Type: SwitchParameter
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-ResourceQuota

Specifies the quota for this site collection in Sandboxed Solutions units. This value must not exceed the company's aggregate available Sandboxed Solutions quota. The default value is 0. For more information, see Resource Usage Limits on Sandboxed Solutions in SharePoint 2010 : http://msdn.microsoft.com/en-us/library/gg615462.aspx.

Type: Double
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-ResourceQuotaWarningLevel

Specifies the warning level for the resource quota. This value must not exceed the value set for the ResourceQuota parameter

Type: Double
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-StorageQuota

Specifies the storage quota for this site collection in megabytes. This value must not exceed the company's available quota.

Type: Int
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-StorageQuotaWarningLevel

Specifies the warning level for the storage quota in megabytes. This value must not exceed the values set for the StorageQuota parameter

Type: Int
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Template

Specifies the site collection template type. Use the Get-PnPWebTemplate cmdlet to get the list of valid templates. If no template is specified, one can be added later. The Template and LocaleId parameters must be a valid combination as returned from the Get-PnPWebTemplates cmdlet.

Type: String
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-TimeZone

Use Get-PnPTimeZoneId to retrieve possible timezone values

Type: Int
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: False

-Title

Specifies the title of the new site collection

Type: String
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: False

-Url

Specifies the full URL of the new site collection. It must be in a valid managed path in the company's site. For example, for company contoso, valid managed paths are https://contoso.sharepoint.com/sites and https://contoso.sharepoint.com/teams.

Type: String
Parameter Sets: (All)

Required: True
Position: Named
Accept pipeline input: False

-Wait

Type: SwitchParameter
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

-Connection

Optional connection to be used by cmdlet. Retrieve the value for this parameter by eiter specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type: SPOnlineConnection
Parameter Sets: (All)

Required: False
Position: Named
Accept pipeline input: False

RELATED LINKS

SharePoint Developer Patterns and PracticesLocale IDsResource Usage Limits on Sandboxed Solutions in SharePoint 2010Creating on-premises site collections using CSOM