New-SPWebApplicationExtension

Crea una nueva versión de zona para la aplicación web.

Syntax

New-SPWebApplicationExtension
   [-Identity] <SPWebApplicationPipeBind>
   -Name <String>
   -Zone <SPUrlZone>
   [-Port <UInt32>]
   [-HostHeader <String>]
   [-Certificate <SPServerCertificatePipeBind>]
   [-UseServerNameIndication]
   [-AllowLegacyEncryption]
   [-Path <String>]
   [-Url <String>]
   [-AuthenticationMethod <String>]
   [-AllowAnonymousAccess]
   [-SecureSocketsLayer]
   [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
   [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
   [-SignInRedirectURL <String>]
   [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El New-SPWebApplicationExtension cmdlet crea una nueva instancia de zona para la aplicación web. Esto se llama también extender una aplicación web y permite configurar permisos alternativos para el mismo contenido disponible en la aplicación web existente.

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

Get-SPWebApplication http://sitename | New-SPWebApplicationExtension -Name "ExtranetSite" -SecureSocketsLayer -Zone "Extranet" -URL "https://extranet.sitename.com"

En este ejemplo se extiende la aplicación web especificada en http://sitename a la zona extranet para su uso SSL.

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 zona de 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

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

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

-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

-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 la aplicación web que se va a extender.

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

-Name

Especifica el nombre del nuevo sitio web de IIS en la aplicación web.

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

-Path

Especifica el directorio físico del nuevo sitio web (en la carpeta directorios virtuales). El tipo es una ruta de acceso válida, con el formato C:\Inetpub\wwwraíz\MiAplicaciónWeb.

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 de la aplicación. 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 se especifica un número de puerto que ya está asignado, IIS no inicia el nuevo sitio hasta que se cambie el número de puerto del sitio nuevo o el sitio anterior.

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

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

-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

-Zone

Especifica una de las cinco zonas con la que se debe asociar la dirección URL interna de esta nueva extensión. Esta zona no puede estar en uso.

El tipo debe ser cualquiera 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