New-SPWebApplication

參考

模組:: sharepoint-server

適用於:: SharePoint Server Subscription Edition

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

Syntax

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

Description

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

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。

範例

------------------範例 1-----------------------

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

此範例會使用 sharepoint.contoso.com 的內部主機標頭和的 http://www.contoso.com 公用 URL，建立新的 Web 應用程式。

------------------範例 2-----------------------

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

此範例會使用 sharepoint.contoso.com 的內部主機標頭和的 https://www.contoso.com 公用 URL，建立已啟用 SSL 的新 Web 應用程式。

------------------範例 3-----------------------

$ap = New-SPAuthenticationProvider
New-SPWebApplication -Name "Contoso Internet Site" -URL "https://www.contoso.com"  -Port 443 
-ApplicationPool "ContosoAppPool" 
-ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa") 
-AuthenticationProvider $ap -SecureSocketsLayer

使用網域帳戶網域\wa，在 URL https://www.contoso.com 建立 Windows 宣告 Web 應用程式。

參數

-AdditionalClaimProvider

將特定宣告提供者新增至定義的 Web 應用程式。

Type:	SPClaimProviderPipeBind[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AllowAnonymousAccess

允許對 Web 應用程式進行匿名存取。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AllowLegacyEncryption

指定允許使用較舊的 SSL 和 TLS 通訊協定版本和加密套件與此 IIS 網站搭配使用。舊版加密比新式加密弱，不建議使用。

此功能需要 Windows Server 2022 或更新版本。使用舊版 Windows Server 部署 SharePoint 時，無法使用此功能。

此參數只有在搭配 SecureSocketsLayer 參數使用時才有效。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ApplicationPool

指定要使用的應用程式集區名稱;例如，SharePoint - 1213。如果指定名稱的應用程式集區不存在，則必須提供 ApplicationPoolAccount 參數並建立新應用程式集區。若未指定值，就會使用預設應用程式集區。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ApplicationPoolAccount

指定此應用程式集區執行時所用的使用者帳戶。使用 Cmdlet Get-SPIisWebServicApplicationPool 來使用系統帳戶。

Type:	SPProcessAccountPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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 Subscription Edition

-AuthenticationMethod

使用 Kerberos 或 NTLM 指定驗證方法。若未指定值，則預設會套用 NTLM 。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AuthenticationProvider

指定驗證提供者或適用於 Web 應用程式的提供者。

Type:	SPAuthenticationProviderPipeBind[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Certificate

指定將用於此 IIS 網站之安全通訊端層 (SSL) 系結的憑證。此參數只有在搭配 SecureSocketsLayer 參數使用時才有效。

Type:	SPServerCertificatePipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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 Subscription Edition

-DatabaseCredentials

指定資料庫使用者帳戶的 Windows PowerShell Credential 物件。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabaseName

指定新 Web 應用程式之初始內容資料庫的名稱。

此類型必須是有效的資料庫名稱，例如 ContentDB1。如果未指定任何值，則會自動產生格式為 WSS_Content_ < GUID > 的值。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabaseServer

指定資料庫伺服器名稱。此類型必須是格式為 SQL1 的有效資料庫伺服器名稱，其中會使用具名執行個體，格式可顯示為 server\server。若未提供值，就會使用預設的 SQL Server 執行個體。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-HostHeader

指定此 IIS 網站的主機標頭系結。主機標頭系結可讓多個 IIS 網站共用相同的埠號碼。傳送至共用埠號碼的 Web 要求會根據用戶端所傳送的 HTTP 主機標頭值，路由傳送至正確的 IIS 網站。

如果未指定主機標頭系結，則傳送至此埠號碼的所有 Web 要求都會路由傳送至此 IIS 網站，除非另一個 IIS 網站的主機標頭系結符合用戶端所傳送的 HTTP 主機標頭。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Name

指定新 Web 應用程式的名稱。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Path

指定虛擬目錄資料夾中新 Web 應用程式的實體目錄。此類型為有效的路徑，格式為 C:\Inetpub\wwwroot\MyWebApplication。如果未指定任何值，則會套用值 %wwwroot%\wss\VirtualDirectories\ < portnumber > 。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Port

指定存取此 Web 應用程式所在的連接埠。連接埠可以是任何有效的連接埠號碼。若未指定任何連接埠，就會自動產生不衝突的連接埠號碼。

如果您指定已指派的埠號碼，IIS 在變更新網站的埠號碼或舊月臺的埠號碼之前，不會啟動新網站。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SecureSocketsLayer

為此 Web 應用程式啟用 Secure Sockets Layer (SSL) 加密。如果您選擇使用 SSL，您必須將伺服器憑證匯入 SharePoint，並將其指派給此 Web 應用程式的 IIS 網站。完成此動作之前，將無法從此 IIS 網站存取 Web 應用程式。

預設值為 False。

如果省略此參數或設定為 False，此 Web 應用程式會針對指定的埠使用 HTTP。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ServiceApplicationProxyGroup

指定要供 Web 應用程式使用的自訂服務應用程式 Proxy 群組。 Web 應用程式會使用此 Proxy 群組中的 Proxy 來連線至服務應用程式。若未指定此參數，就會使用預設的 Proxy 群組。

Type:	SPServiceApplicationProxyGroupPipeBind
Aliases:	ProxyGroup
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SignInRedirectProvider

設定登入重新導向 URL 以指向在特定驗證提供者中所定義的 URL。

Type:	SPTrustedIdentityTokenIssuerPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-SignInRedirectURL

指定 Web 應用程式的登入重新導向 URL。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Url

指定 Web 應用程式的負載平衡 URL。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-UserSettingsProvider

提供外部使用者設定提供者的存取權。

Type:	SPUserSettingsProviderPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-UseServerNameIndication

指定此 IIS 網站的安全通訊端層 (SSL) 系結應使用伺服器名稱指示 (SNI) 。伺服器名稱指示可讓具有唯一主機標頭和唯一伺服器憑證的多個 IIS 網站共用相同的 SSL 埠。如果未使用伺服器名稱指示，所有共用相同 SSL 埠的 IIS 網站都必須共用相同的伺服器憑證。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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 Subscription Edition