New-SPSite
適用版本: SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間: 2015-03-09
在指定的 URL 建立新的網站集合。
Syntax
New-SPSite [-Url] <String> -OwnerAlias <SPUserPipeBind> [-AdministrationSiteType <None | TenantAdministration>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-ContentDatabase <SPContentDatabasePipeBind>] [-Description <String>] [-HostHeaderWebApplication <SPWebApplicationPipeBind>] [-Language <UInt32>] [-Name <String>] [-OwnerEmail <String>] [-QuotaTemplate <SPQuotaTemplatePipeBind>] [-SecondaryEmail <String>] [-SecondaryOwnerAlias <SPUserPipeBind>] [-SiteSubscription <SPSiteSubscriptionPipeBind>] [-Template <SPWebTemplatePipeBind>] [-WhatIf [<SwitchParameter>]]
詳細描述
New-SPSite Cmdlet 會使用 Url 及 OwnerAlias 參數所指定的 URL 及擁有者建立新的網站集合。
Parameters
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Url |
必要 |
System.String |
指定新網站集合使用的 URL。如果 URL 不是主機標頭網站,即必須以 Web 應用程式 URL 開始。 |
OwnerAlias |
必要 |
System.String |
指定網站擁有者的使用者登入名稱。 此類型必須是格式為 Domain\username 的有效使用者別名。 |
AdministrationSiteType |
選用 |
Microsoft.SharePoint.SPAdministrationSiteType |
指定網站類型。 有效值為 None 或 TentantAdministration。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。 注意 使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。 |
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
執行命令之前,會先提示您進行確認。如需詳細資訊,請輸入下列命令:get-help about_commonparameters |
ContentDatabase |
選用 |
Microsoft.SharePoint.PowerShell.SPContentDatabasePipeBind |
指定要在其中建立新網站的內容資料庫名稱或 GUID。若不指定任何內容資料庫,即會自動選取網站集合。 此類型必須是格式為 SiteContent1212 的有效資料庫名稱,或格式為 1234-5678-9807 的 GUID。 |
Description |
選用 |
System.String |
描述新網站。若不指定任何值,該值會保持空白。 |
HostHeaderWebApplication |
選用 |
Microsoft.SharePoint.PowerShell.SPWebApplicationPipeBind |
指定當提供的 URL 為主機標頭時,HostHeaderWebApplication 參數必須是此網站集合建立所在之 Web 應用程式的名稱、URL、GUID 或 SPWebApplication 物件。若未指定任何值,該值會保持空白。 此類型必須是格式為 WebApplication-1212 的有效名稱、URL (例如 http://server_name) 或 GUID (例如 1234-5678-9876-0987)。 |
Language |
選用 |
System.Int32 |
指定新網站集合的語言識別碼。若不指定任何語言,即使用安裝產品時所指定的相同語言建立網站集合。 這必須是有效的語言識別碼 (LCID)。 |
Name |
選用 |
System.String |
指定新網站集合的標題。若未指定任何名稱,即套用預設名稱。 |
OwnerEmail |
選用 |
System.String |
指定網站擁有者的電子郵件地址。若不指定任何值,該值會保持空白。 此類型必須是格式為 someone@example.com 的有效電子郵件地址。 |
QuotaTemplate |
選用 |
Microsoft.SharePoint.PowerShell.SPQuotaTemplatePipeBind |
指定新網站的配額範本。此範本必須已存在。若不指定任何範本,即不套用任何配額。 |
SecondaryEmail |
選用 |
System.String |
指定次要網站擁有者的電子郵件地址。若不指定任何值,此值會保持空白。 此類型必須是格式為 someone@example.com 的有效電子郵件地址。 |
SecondaryOwnerAlias |
選用 |
System.String |
指定次要網站擁有者的使用者登入認證。若不指定任何值,該值會保持空白。 此類型必須是格式為 Domain\username 的有效使用者別名。 |
SiteSubscription |
選用 |
Microsoft.SharePoint.PowerShell.SPSiteSubscriptionPipeBind |
指定取得網站集合的網站群組。 |
Template |
選用 |
Microsoft.SharePoint.PowerShell.SPWebTemplatePipeBind |
指定新網站集合之根網站的網站範本。此範本必須已安裝。若不指定任何範本,即不佈建任何範本。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters |
輸入類型
傳回類型
Example
------------------範例 1-----------------------
New-SPSite http://sitename/sites/test -OwnerAlias "DOMAIN\JDoe" -Language 1033
此範例會在使用者 DOMAIN\Jdoe
擁有的 http://sitename/sites/test
建立英文網站集合。
------------------範例 2-----------------------
$w = Get-SPWebApplication http://sitename
New-SPSite https://www.contoso.com -OwnerAlias "DOMAIN\jdoe" -HostHeaderWebApplication $w -Name "Contoso" -Template "STS#0"
此範例會建立主機標頭網站集合。因為已提供範本,所以會建立此網站集合的根網站。
------------------範例 3-----------------------
Get-SPWebTemplate | Where{ $_.Title -eq "Team Site" } | ForEach-Object{ New-SPSite http://sitename/sites/test -OwnerAlias DOMAIN\jdoe -Template $_ }
此範例會使用 "Team Site"
網站範本建立網站集合。
See Also
Reference
Get-SPSite
Set-SPSite
Backup-SPSite
Move-SPSite
Restore-SPSite