Set-SPWebApplication
Configura la aplicación web especificada.
Syntax
Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
[-DefaultTimeZone <Int32>]
[-DefaultQuotaTemplate <String>]
[-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-Zone <SPUrlZone>
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-SignInRedirectURL <String>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-AuthenticationMethod <String>]
[-Force]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-Zone <SPUrlZone>
[-SecureSocketsLayer]
[-HostHeader <String>]
[-Certificate <SPServerCertificatePipeBind>]
[-UseServerNameIndication]
[-AllowLegacyEncryption]
-Port <Int32>
[-Url <String>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-SMTPServer <String>
[-SMTPServerPort <Int32>]
[-OutgoingEmailAddress <String>]
[-ReplyToEmailAddress <String>]
[-SMTPCredentials <PSCredential>]
[-DisableSMTPEncryption]
[-Certificate <SPServerCertificatePipeBind>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Este cmdlet contiene más de un conjunto de parámetros. Es posible que solo pueda usar parámetros procedentes de un conjunto de parámetros y no pueda combinar los parámetros de distintos conjuntos de parámetros. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.
El Set-SPWebApplication cmdlet configura la aplicación web especificada por el parámetro Identity.
Para cualquier configuración específica de la zona (para el conjunto de parámetros Zone), se debe proporcionar la zona que se va a configurar.
La zona proporcionada ya debe existir.
Se debe volver a especificar toda la configuración de enlace de IIS al actualizar el enlace de un sitio web de IIS a través del Set-SPWebApplication cmdlet . Esto incluye la dirección URL, la configuración de capa de sockets seguros, el número de puerto, el encabezado de host y el certificado. Si no se vuelve a especificar una configuración de enlace, se revertirá a su valor predeterminado.
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
$credentials = Get-Credential
Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -SMTPServerPort 587 -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $credentialsEn este ejemplo se establece que la http://servername aplicación web use el servidor SMTP mail.example.com, el puerto de servidor SMTP 587, la dirección from, la dirección user@example.comreplyto@example.comde respuesta y las credenciales almacenadas en el objeto $credentials.
EJEMPLO 2
Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $nullEn este ejemplo se establece que la http://servername aplicación web use el servidor SMTP mail.example.com, el puerto de servidor SMTP predeterminado, la dirección from, la dirección user@example.comreplyto@example.comde respuesta y para conectarse al servidor SMTP de forma anónima.
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 |
-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 |
-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
Use para establecer una aplicación web en autenticación de Windows clásica. Los valores válidos son NTLM o Kerberos.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AuthenticationProvider
Define los proveedores de autenticación que se aplican a la 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 o para autenticarse en un servidor SMTP para enviar correo electrónico.
Al configurar 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. Al configurar la autenticación SMTP, este parámetro solo es válido cuando no se especifica el parámetro DisableSMTPEncryption.
| 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 |
-DefaultQuotaTemplate
Especifica la nueva plantilla de cuota de sitio predeterminada para esta 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 |
-DefaultTimeZone
Especifica la zona horaria predeterminada para las nuevas colecciones de sitios en esta aplicación web.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DisableSMTPEncryption
Especifica si se va a activar o desactivar el cifrado de SMTP.
El valor predeterminado es False.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Force
Suprime los mensajes de confirmación implicados en la configuración de una aplicación web.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| 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 |
-Identity
Especifica el nombre o la dirección URL de la aplicación web.
El tipo debe ser un nombre válido, con el formato WebApplication-1212, o una dirección URL, con el formato https://example.contoso.com.
| Type: | SPWebApplicationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-NotProvisionGlobally
Solo aprovisiona la aplicación web en el servidor local con los cambios especificados por este cmdlet. Las aplicaciones web de otros servidores de la granja de servidores no se aprovisionarán con estos cambios.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-OutgoingEmailAddress
Especifica la nueva dirección de correo electrónico saliente para los mensajes de correo electrónico enviados desde esta aplicación web. El tipo debe ser una dirección válida; por ejemplo, someone@example.com.
| 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 en el que se puede acceder a esta aplicación web. Puede ser cualquier número de puerto válido.
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: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ReplyToEmailAddress
Configura la dirección de correo electrónico de respuesta.
El tipo debe ser una dirección válida; por ejemplo, someone@example.com.
| Type: | String |
| 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 de proxy de aplicación de servicio personalizado para la aplicación web que se va a usar. La aplicación web usará los servidores proxy de este grupo de proxy para conectarse a las aplicaciones de servicio. Si no se especifica este parámetro, se usa el grupo de proxy predeterminado de la granja.
| 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 de 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 |
-SMTPCredentials
Especifica las credenciales para autenticarse en el servidor SMTP. Establezca el valor en $null para conectarse al servidor SMTP de forma anónima. Si no se especifica este parámetro, se conservará la configuración de autenticación existente.
Debe usar el Set-SPApplicationCredentialKey cmdlet de PowerShell para establecer una clave de credencial de aplicación idéntica en cada servidor de la granja de servidores antes de especificar las credenciales.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SMTPServer
Especifica el nuevo servidor SMTP de salida que usará esta aplicación web. Establezca en $null para borrar la configuración del servidor.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SMTPServerPort
Especifica un valor de puerto SMTP.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Url
Especifica la dirección URL con equilibrio de carga para la zona de 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 |
-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 SSL.
| 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 |
-Zone
Al configurar opciones específicas de zona, se debe especificar la zona que se va a configurar. Esta zona ya debe existir.
El tipo debe ser uno de los siguientes valores: Default, Intranet, Internet, Extranet o Custom.
| Type: | SPUrlZone |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |