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 |