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

- AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
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
Accept pipeline input:True
Accept wildcard characters:False

- WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AdditionalClaimProvider

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

Type:SPClaimProviderPipeBind[]
Position:Named
Default value:None
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
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
Accept pipeline input:False
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
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
Accept pipeline input:False
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identidad

Especifica la aplicación web que se va a extender.

Type:SPWebApplicationPipeBind
Position:1
Default value:None
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
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
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
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
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
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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition