New-SPWeb
適用版本: SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間: 2015-03-09
在現有的網站集合中建立新網站。
Syntax
New-SPWeb [-Url] <String> [-AddToQuickLaunch <SwitchParameter>] [-AddToTopNav <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Language <UInt32>] [-Name <String>] [-Template <SPWebTemplatePipeBind>] [-UniquePermissions <SwitchParameter>] [-UseParentTopNav <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
New-SPWeb cmdlet 會在 Url 參數所指定的現有網站集合中建立新網站。您可以指定 Language 參數,以特定的預設語言建立網站。若未指定任何語言,即使用安裝產品時所指定的相同語言建立網站。您可指定 Template 參數,以特定的範本建立網站。若未指定任何範本,仍會建立網站,範本可以後再提供或由第一位使用者登入時提供。
如需 Windows PowerShell for SharePoint 產品的權限及最新資訊,請參閱線上文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Url |
必要 |
System.String |
指定新網站建立所在的 URL。此 URL 必須位在現有的網站集合內。此 URL 必須是有效的 URL,格式為 http://server_name/site1。 |
Language |
選用 |
System.UInt32 |
指定新網站的語言範本識別碼。若未指定任何語言,即使用安裝產品時所指定的相同語言建立網站。 此類型必須是有效的語言識別碼 (LCID)。 |
Template |
選用 |
SPWebTemplatePipeBind |
指定新網站的網站範本。此範本必須已存在。若未指定任何範本,即不套用任何範本,可稍後再選取範本。 |
Name |
選用 |
System.String |
指定新網站的標題。若未指定任何標題,即套用預設標題。預設標題係為各範本所設定。 |
Description |
選用 |
System.String |
描述新網站。若未指定任何描述,此項目會保持空白。 |
AddToQuickLaunch |
選用 |
System.Management.Automation.SwitchParameter |
將此網站新增至 [快速啟動]。 |
UniquePermissions |
選用 |
System.Management.Automation.SwitchParameter |
指定要以獨特的權限建立此網站。 |
AddToTopNav |
選用 |
System.Management.Automation.SwitchParameter |
將此網站新增至最上層的導覽列。 |
UseParentTopNav |
選用 |
System.Management.Automation.SwitchParameter |
指定此網站與上層網站使用相同的最上層導覽列。 |
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 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters |
輸入類型
無
傳回類型
Example
------------------範例-----------------------
New-SPWeb http://somesite/subweb1 -Template "STS#0"
此範例會使用所提供之 URL (http://somesite/subweb1
) 的「小組網站」範本建立新的子網站。「小組網站」範本是提供 Template
參數當成變數 STS#0
參考的值。