Compartir a través de

New-SPWebApplication

Módulo:
SharePointServer module

Crea una nueva aplicación web en la granja de servidores local.

Sintaxis

Default (Es el valor predeterminado). 

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

Crea 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

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Agrega un proveedor de notificaciones específico a la aplicación web definida.

Propiedades del parámetro

Tipo:

SPClaimProviderPipeBind[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AllowAnonymousAccess

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Permite el acceso anónimo a la aplicación web.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ApplicationPool

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ApplicationPoolAccount

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:SPProcessAccountPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AssignmentCollection

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:SPAssignmentCollection
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AuthenticationMethod

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AuthenticationProvider

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica el proveedor o proveedores de autenticación que se aplican a una aplicación web.

Propiedades del parámetro

Tipo:

SPAuthenticationProviderPipeBind[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DatabaseCredentials

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica el objeto Credential de Windows PowerShell para la cuenta de usuario de base de datos.

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DatabaseName

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DatabaseServer

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-HostHeader

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica una dirección URL válida asignada a la aplicación web que debe correlacionarse con la configuración de la asignación alternativa de acceso, con el formato nombre_del_servidor.

Cuando está presente el parámetro HostHeader, el valor de este campo es la dirección URL interna de la aplicación web. El parámetro Url se usa para especificar la dirección URL pública. Si no se especifica ningún valor, el valor se deja en blanco.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica el nombre de la nueva aplicación web.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Path

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica el directorio físico de la nueva aplicación web en la carpeta de 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> .

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Port

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SecureSocketsLayer

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Habilita el cifrado de Capa de sockets seguros (SSL) para esta aplicación web. Si decide usar SSL, debe agregar el certificado a cada servidor mediante las herramientas de administración de IIS. Hasta entonces, no se podrá tener acceso a la aplicación web desde este sitio web de IIS.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServiceApplicationProxyGroup

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:SPServiceApplicationProxyGroupPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ProxyGroup

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SignInRedirectProvider

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:SPTrustedIdentityTokenIssuerPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SignInRedirectURL

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica la dirección URL de redireccionamiento de inicio de sesión para la aplicación web.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Url

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica la dirección URL de carga equilibrada para la aplicación web.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UserSettingsProvider

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Proporciona acceso al proveedor de configuración de usuario externo.

Propiedades del parámetro

Tipo:SPUserSettingsProviderPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.