New-SPSite

在指定的 URL 建立新的網站集合。

Syntax

New-SPSite
   [-Url] <String>
   -OwnerAlias <SPUserPipeBind>
   [-AdministrationSiteType <SPAdministrationSiteType>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-ContentDatabase <SPContentDatabasePipeBind>]
   [-Description <String>]
   [-HostHeaderWebApplication <SPWebApplicationPipeBind>]
   [-Language <UInt32>]
   [-Name <String>]
   [-OverrideCompatibilityRestriction]
   [-OwnerEmail <String>]
   [-QuotaTemplate <SPQuotaTemplatePipeBind>]
   [-SecondaryEmail <String>]
   [-SecondaryOwnerAlias <SPUserPipeBind>]
   [-SiteSubscription <SPSiteSubscriptionPipeBind>]
   [-Template <SPWebTemplatePipeBind>]
   [-WhatIf]
   [-CreateFromSiteMaster]
   [<CommonParameters>]

Description

Cmdlet New-SPSite 會使用 URL 和擁有者 URL 和 OwnerAlias 參數來建立新的網站集合。 此 Cmdlet 可以在使用舊版範本和功能的 SharePoint Server 模式中建立網站集合,也可以在使用新版範本和功能的 SharePoint Server 模式中建立。

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet

範例

------------------範例 1-----------------------

New-SPSite https://webApp/sites/test -OwnerAlias "DOMAIN\JDoe" -Language 1033 -Template STS#0

此範例會在使用者 DOMAIN\Jdow 所擁有的 HTTPs:// < 網站名稱 > /網站/測試建立英文網站集合。

------------------範例 2-----------------------

$w = Get-SPWebApplication https://webApp
New-SPSite https://www.contoso.com -OwnerAlias "DOMAIN\jdow" -HostHeaderWebApplication $w -Name "Contoso" -Template STS#0

此範例會建立名為 主機的網站集合。 因為已提供範本,所以將會建立此網站集合的根網站。

------------------範例 3-----------------------

Get-SPWebTemplate | Where{ $_.Title -eq "Team Site" } | ForEach-Object{ New-SPSite https://<site name</sites/test -OwnerAlias DOMAIN\jdow -Template $_ }

此範例會使用「小組網站」網站範本來建立網站集合。

------------------EXAMPLE 4-----------------------

New-SPSite -URL https://webApp/sites/testsite -OwnerAlias "DOMAIN\JDow" -Language 1033 -CompatibilityLevel 14 -Template STS#0

此範例會使用使用者 DOMAIN\Jdow 所擁有的小組網站範本,在 HTTPs:// < site name > /sites/testsite 建立英文 14 模式網站集合

參數

-AdministrationSiteType

指定網站類型。

有效值為 None 或 TentantAdministration 。

Type:SPAdministrationSiteType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AssignmentCollection

管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

使用 Global 參數時,所有物件會包含在全域儲存區內。 如果不立即使用物件,或使用 Stop-SPAssignment 命令加以捨棄,則可能會有記憶體不足的狀況發生。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CompatibilityLevel

指定在建立新 SPSite 物件時,所要使用的範本版本。

此值會設定網站集合的初始 CompatibilityLevel 值。

若未指定此參數,CompatibilityLevel 會預設為 Web 應用程式的最高可能版本,視 SiteCreationMode 設定而定。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

在執行命令之前,提示您確認操作。 如需詳細資訊,請輸入下列命令:get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ContentDatabase

指定要在其中建立新網站的內容資料庫名稱或 GUID。 若不指定任何內容資料庫,即會自動選取網站集合。

此類型必須是格式為 SiteContent1212 的有效資料庫名稱,或格式為 1234-5678-9807 的 GUID。

Type:SPContentDatabasePipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CreateFromSiteMaster

指定是否要使用網站主機建立新網站。

有效值為 True 或 False 。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Description

說明新網站。

若不指定任何值,該值會保持空白。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-HostHeaderWebApplication

指定如果提供的 URL 是主機名稱網站集合,則 HostHeaderWebApplication 參數必須是建立此網站集合之 Web 應用程式的名稱、URL、GUID 或 SPWebApplication 物件。

若未指定任何值,該值會保持空白。

此類型必須為下列格式之一的有效名稱:

--A WebApplication

--URL (例如 https://server_name)

--例如 GUID (,1234-5678-9876-0987)

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Language

指定新網站集合的語言識別碼。

若不指定任何語言,即使用安裝產品時所指定的相同語言建立網站集合。

這必須是有效的語言識別碼 (LCID)。

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Name

指定新網站集合的標題。

若未指定任何名稱,即套用預設名稱。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-OverrideCompatibilityRestriction

指定是否要使用網站的相容性限制。

有效值為 True 或 False 。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-OwnerAlias

指定網站擁有者的使用者登入名稱。

此類型必須是格式為 Domain\username 的有效使用者別名。

Type:SPUserPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-OwnerEmail

指定網站擁有者的電子郵件地址。 若不指定任何值,該值會保持空白。

此類型必須是格式為 的電子郵件地址。 someone@example.com

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-QuotaTemplate

指定新網站的配額範本。範本必須已經存在。

若不指定任何範本,即不套用任何配額。

Type:SPQuotaTemplatePipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SecondaryEmail

指定次要網站擁有者的電子郵件地址。 若不指定任何值,此值會保持空白。

此類型必須是電子郵件地址,格式 someone@example.com 為 。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SecondaryOwnerAlias

指定次要網站擁有者的使用者登入認證。

若不指定任何值,該值會保持空白。

此類型必須是格式為 Domain\username 的有效使用者別名。

Type:SPUserPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SiteSubscription

指定取得網站集合的網站群組。

Type:SPSiteSubscriptionPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Template

指定新網站集合之根網站的網站範本。

此範本必須已安裝。

若不指定任何範本,即不佈建任何範本。

Type:SPWebTemplatePipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Url

指定新網站集合使用的 URL。

如果 URL 不是主機標頭網站,URL 必須以 Web 應用程式 URL 開頭。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

顯示訊息會描述命令的功效而不執行命令。 如需詳細資訊,請輸入下列命令:get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019