New-SPWebApplication

参考

模块:: sharepoint-server

适用于:: SharePoint Server Subscription Edition

在本地服务器场中创建新的 Web 应用程序。

语法

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>]

说明

创建由 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 的内部主机标头和公共 URL http://www.contoso.com创建新的 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 和公共 URL 创建新的启用了 SSL 的 https://www.contoso.comWeb 应用程序。

------------------示例 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 或更高版本。当 SharePoint 与早期版本的 Windows Server 一起部署时，此功能不可用。

仅当与 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

指定将运行此应用程序池的用户帐户的身份。使用 Get-SPIisWebServicApplicationPool cmdlet 使用系统帐户。

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 参数，则会自动处理这些对象。

使用全局参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 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 应用程序启用安全套接字层 (SSL) 加密。如果选择使用 SSL，则必须将服务器证书导入 SharePoint 并将其分配给此 Web 应用程序的 IIS 网站。在完成此操作之前，Web 应用程序将无法从此 IIS 网站访问。

默认值为 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 应用程序要使用的自定义服务应用程序代理组。 Web 应用程序将使用此代理组中的代理来连接服务应用程序。如果未指定此参数，则使用服务器场的默认代理组。

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