New-SPWebApplication
Crea una nueva aplicación web en la granja de servidores local.
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
Crea una nueva aplicación web que especifica el parámetro Name. El usuario que especifica el parámetro DatabaseCredentials debe ser miembro del rol fijo de servidor dbcreator del servidor de base de datos.
Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.
Ejemplos
------------------EJEMPLO 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")En este ejemplo se crea una nueva aplicación web mediante un encabezado host interno de sharepoint.contoso.com y una dirección URL pública de http://www.contoso.com.
------------------EJEMPLO 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")En este ejemplo se crea una nueva aplicación web habilitada para SSL mediante un encabezado host interno de sharepoint.contoso.com y una dirección URL pública de https://www.contoso.com.
------------------EJEMPLO 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 -SecureSocketsLayerCrea una aplicación web de notificaciones de Windows en la dirección URL https://www.contoso.com mediante la cuenta de dominio domain\wa.
Parámetros
-AdditionalClaimProvider
Agrega un proveedor de notificaciones específico a la aplicación web definida.
| Type: | SPClaimProviderPipeBind[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AllowAnonymousAccess
Permite el acceso anónimo a la aplicación 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
Especifica que las versiones anteriores de los protocolos SSL y TLS y los conjuntos de cifrado pueden usarse con este sitio web de IIS. El cifrado heredado es más débil que el cifrado moderno y no se recomienda.
Esta característica requiere Windows Server 2022 o superior. Esta característica no está disponible cuando SharePoint se implementa con versiones anteriores de Windows Server.
Este parámetro solo es válido cuando se usa con el parámetro 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
Especifica el nombre de un grupo de aplicaciones que se va a usar; por ejemplo, SharePoint - 1213. Si no existe ningún grupo de aplicaciones con el nombre determinado, se debe proporcionar el parámetro ApplicationPoolAccount y se creará un nuevo grupo de aplicaciones. Si no se especifica ningún valor, se usará el grupo de aplicaciones predeterminado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ApplicationPoolAccount
Especifica la cuenta de usuario con la que se ejecutará este grupo de aplicaciones.
Use el Get-SPIisWebServicApplicationPool cmdlet para usar una cuenta del sistema.
| Type: | SPProcessAccountPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AssignmentCollection
Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.
Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global.
Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AuthenticationMethod
Usa Kerberos o NTLM para especificar el método de autenticación. Si no se especifica ningún valor, se aplicará el valor predeterminado, 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
Especifica el proveedor o proveedores de autenticación que se aplican a una aplicación 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
Especifica el certificado que se usará para el enlace capa de sockets seguros (SSL) de este sitio web de IIS. Este parámetro solo es válido cuando se usa con el parámetro 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
Le pide confirmación antes de ejecutar el comando.
Para obtener más información, escriba el siguiente comando: 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
Especifica el objeto Credential de Windows PowerShell para la cuenta de usuario de base de datos.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DatabaseName
Especifica el nombre de la base de datos de contenido inicial para la nueva aplicación web.
El tipo debe ser un nombre de base de datos válido, como por ejemplo, ContentDB1. Si no se especifica ningún valor, se genera automáticamente un valor con el formato 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
Especifica el nombre de servidor de base de datos. El tipo debe ser un nombre de servidor de base de datos válido, con el formato SQL1; donde se usan instancias con nombre, el formato puede aparecer como server\server. La instancia predeterminada de SQL Server se usa si no se proporciona un valor.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-HostHeader
Especifica el enlace de encabezado de host para este sitio web de IIS. Un enlace de encabezado de host permite que varios sitios web de IIS compartan el mismo número de puerto. Las solicitudes web enviadas a un número de puerto compartido se enrutan al sitio web de IIS correcto en función del valor del encabezado de host HTTP enviado por el cliente.
Si no se especifica ningún enlace de encabezado de host, todas las solicitudes web enviadas a este número de puerto se enrutarán a este sitio web iis a menos que otro sitio web iis tenga un enlace de encabezado de host que coincida con el encabezado de host HTTP enviado por el cliente.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Name
Especifica el nombre de la nueva aplicación 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
Especifica el directorio físico de la nueva aplicación web en la carpeta directorios virtuales. El tipo es una ruta de acceso válida, con el formato C:\Inetpub\wwwraíz\MiAplicaciónWeb. Si no se especifica ningún valor, se aplica el valor %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
Especifica el puerto por el que se puede tener acceso a esta aplicación web. Puede ser cualquier número de puerto válido. Si no hay ningún puerto especificado, se generará automáticamente un número de puerto que no entre en conflicto.
Si especifica un número de puerto que ya esté asignado, IIS no inicia el nuevo sitio hasta que cambie el número de puerto del nuevo sitio o el del antiguo.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SecureSocketsLayer
Habilita el cifrado de Capa de sockets seguros (SSL) para esta aplicación web. Si decide usar SSL, debe importar un certificado de servidor a SharePoint y asignarlo al sitio web de IIS para esta aplicación web. Hasta que esto se haga, la aplicación web no será accesible desde este sitio web de IIS.
El valor predeterminado es False.
Si este parámetro se omite o se establece en False, esta aplicación web usará HTTP para el puerto especificado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ServiceApplicationProxyGroup
Especifica un grupo personalizado de servidores proxy de aplicaciones de servicio para la aplicación web que se va a usar. La aplicación web usará los servidores proxy de este grupo para conectarse a aplicaciones de servicio. Si no se especifica este parámetro, se usará el grupo de servidores proxy predeterminado de la granja de servidores.
| 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
Establece que la dirección URL de redireccionamiento de inicio de sesión dirija a la dirección URL definida en el proveedor de autenticación especificado.
| Type: | SPTrustedIdentityTokenIssuerPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SignInRedirectURL
Especifica la dirección URL de redireccionamiento de inicio de sesión para la aplicación web.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Url
Especifica la dirección URL de carga equilibrada para la aplicación web.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-UserSettingsProvider
Proporciona acceso al proveedor de configuración de usuario externo.
| Type: | SPUserSettingsProviderPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-UseServerNameIndication
Especifica que el enlace capa de sockets seguros (SSL) de este sitio web de IIS debe usar la indicación de nombre de servidor (SNI). Indicación de nombre de servidor permite que varios sitios web de IIS con encabezados de host únicos y certificados de servidor únicos compartan el mismo puerto SSL. Si no se usa la indicación de nombre de servidor, todos los sitios web de IIS que comparten el mismo puerto SSL deben compartir el mismo certificado de servidor.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WhatIf
Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando.
Para obtener más información, escriba el siguiente comando: 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 |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de