New-SPWebApplication

發行項
03/07/2017

適用版本： SharePoint Foundation 2010, SharePoint Server 2010

上次修改主題的時間： 2015-03-09

在本機伺服器陣列內建立新 Web 應用程式。

Syntax

New-SPWebApplication -ApplicationPool <String> -Name <String> [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>] [-AllowAnonymousAccess <SwitchParameter>] [-ApplicationPoolAccount <SPProcessAccountPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-AuthenticationMethod <String>] [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>] [-Confirm [<SwitchParameter>]] [-DatabaseCredentials <PSCredential>] [-DatabaseName <String>] [-DatabaseServer <String>] [-HostHeader <String>] [-Path <String>] [-Port <UInt32>] [-SecureSocketsLayer <SwitchParameter>] [-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>] [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>] [-SignInRedirectURL <String>] [-Url <String>] [-WhatIf [<SwitchParameter>]]

詳細描述

建立由 Name 參數指定的新 Web 應用程式。由 DatabaseCredentials 參數所指定的使用者必須是資料庫伺服器上 dbcreator 固定伺服器角色的成員。

Parameters

參數	必要	類型	描述
ApplicationPool	必要	System.String	指定要使用的應用程式集區名稱，例如，SharePoint – 1213。如果指定名稱的應用程式集區不存在，則必須提供 ApplicationPoolAccount 參數並建立新應用程式集區。若未指定值，就會使用預設應用程式集區。
Name	必要	System.String	指定新 Web 應用程式的名稱。
AdditionalClaimProvider	選用	Microsoft.SharePoint.PowerShell.SPClaimProviderPipeBind[]	新增特定宣告提供者至定義的 Web 應用程式。
AllowAnonymousAccess	選用	System.Management.Automation.SwitchParameter	允許匿名存取 Web 應用程式。
ApplicationPoolAccount	選用	Microsoft.SharePoint.PowerShell.SPProcessAccountPipeBind	指定此應用程式集區執行時所用的使用者帳戶。使用 Get-SPIisWebServicApplicationPool Cmdlet 可使用系統帳戶。
AssignmentCollection	選用	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。注意使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。
AuthenticationMethod	選用	System.String	使用 Kerberos 或 NTLM 來指定驗證方法。若未指定值，則預設會套用 NTLM。
AuthenticationProvider	選用	Microsoft.SharePoint.PowerShell.SPAuthenticationProviderPipeBind[]	指定驗證提供者或適用於 Web 應用程式的提供者。
Confirm	選用	System.Management.Automation.SwitchParameter	執行命令之前，會先提示您進行確認。如需詳細資訊，請輸入下列命令：get-help about_commonparameters
DatabaseCredentials	選用	System.Management.Automation.PSCredential	指定資料庫使用者帳戶的 Windows PowerShell Credential 物件。
DatabaseName	選用	System.String	指定新 Web 應用程式之初始內容資料庫的名稱。此類型必須是有效的資料庫名稱，例如 ContentDB1。若未指定值，就會自動產生格式為 WSS_Content_<GUID> 的值。
DatabaseServer	選用	System.String	指定資料庫伺服器名稱。此類型必須是格式為 SQL1 的有效資料庫伺服器名稱，其中會使用具名執行個體，格式可顯示為 server\server。若未提供值，就會使用預設的 SQL Server 執行個體。
HostHeader	選用	System.String	指定已指派給必須與備用存取對應設定相關聯之 Web 應用程式的有效 URL，格式為 server_name。當 HostHeader 參數存在時，此欄位的值為 Web 應用程式的內部 URL。Url 參數係用於指定公用 URL。若未指定值，則此值會保留空白。
Path	選用	System.String	在虛擬目錄資料夾中指定新 Web 應用程式的實體目錄。此類型是格式為 C:\Inutepub\wwwroot\MyWebApplication 的有效路徑。若未指定值，就會套用 %wwwroot%\wss\VirtualDirectories\<portnumber> 值。
Port	選用	System.UInt32	指定存取此 Web 應用程式所在的連接埠。連接埠可以是任何有效的連接埠號碼。若未指定任何連接埠，就會自動產生不衝突的連接埠號碼。重要若指定已被指派的連接埠號碼，尚未變更新網站或舊網站的連接埠號碼時，IIS 不會啟動新網站。
SecureSocketsLayer	選用	System.Management.Automation.SwitchParameter	為此 Web 應用程式啟用 Secure Sockets Layer (SSL) 加密。如果選擇使用 SSL，就必須使用 IIS 管理工具在每部伺服器上新增憑證。在此作業完成之前，您無法由此 IIS 網站存取 Web 應用程式。
ServiceApplicationProxyGroup	選用	Microsoft.SharePoint.PowerShell.SPServiceApplicationProxyGroupPipeBind	指定 Web 應用程式要使用的自訂服務應用程式 Proxy 群組。Web 應用程式會使用此 Proxy 群組中的 Proxy 來連線至服務應用程式。若未指定此參數，就會使用預設的 Proxy 群組。
SignInRedirectProvider	選用	Microsoft.SharePoint.PowerShell.SPTrustedIdentityTokenIssuerPipeBind	設定登入重新導向 URL 以指向在特定驗證提供者中所定義的 URL。
SignInRedirectURL	選用	System.String	指定 Web 應用程式的登入重新導向 URL。
Url	選用	System.String	指定 Web 應用程式的負載平衡 URL。
WhatIf	選用	System.Management.Automation.SwitchParameter	顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters

輸入類型

傳回類型

Example

------------------範例-----------------------

New-SPWebApplication -Name "Contoso Internet Site" -Port 80 -HostHeader sharepoint.contoso.com -URL "https://www.contoso.com" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\jdoe")

此範例會使用 sharepoint.contoso.com 的內部主機標題與 https://www.contoso.com 的公開 URL 建立新的 Web 應用程式。