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

為能適當處置物件而管理物件。使用 SPWebSPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWebSPSiteSPSiteAdministration 物件時,若未使用指派集合或 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 參考的值。

See Also

Reference

Get-SPWeb
Set-SPWeb
Remove-SPWeb
Import-SPWeb