New-SPAlternateURL

Crea una dirección URL interna o pública para el recurso o la zona de la aplicación web especificada.

Syntax

New-SPAlternateURL
   [-Url] <String>
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Internal]
   [-WhatIf]
   [-Zone <SPUrlZone>]
   [<CommonParameters>]
New-SPAlternateURL
   [-Url] <String>
   -ResourceName <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Internal]
   [-WhatIf]
   [-Zone <SPUrlZone>]
   [<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.

The New-SPAlternateUrl cmdlet creates a new public or internal URL for the specified Web application zone or resource. Use the ResourceName parameter if the alternate URL is for an external resource.

Cada aplicación web se puede asociar a una colección de asignaciones entre direcciones URL internas y públicas. Las direcciones URL internas y públicas constan del protocolo y la parte del dominio de la dirección URL completa (por ejemplo, https://www.fabrikam.com. Los usuarios escriben una dirección URL pública para ir al sitio de SharePoint y dicha dirección URL se muestra en los vínculos de las páginas. Las direcciones URL internas se encuentran en las solicitudes de URL que se envían al sitio de SharePoint. Muchas direcciones URL internas se pueden asociar a una única dirección URL pública en los conjuntos de varios servidores (por ejemplo, cuando un equilibrador de carga enruta las solicitudes a direcciones IP específicas para varios servidores del clúster de equilibrio de carga).

Each Web application supports five collections of mappings per URL; the five collections correspond to five zones (default, intranet, extranet, Internet, and custom). When the Web application receives a request for an internal URL in a particular zone, links on the pages returned to the user have the public URL for that zone.

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

#create the public URL
New-SPAlternateURL https://www.contoso.com -Zone "Internet"

#create the internal URL
New-SPAlternateURL https://sharepoint.contoso.com -Zone "Internet" -internal

En este ejemplo se traducen las solicitudes entrantes de https://www.contoso.com en https://sharepoint.contoso.com (en la zona de Internet).

Cuando se va a configurar un proxy inverso para manipular la terminación SSL de la dirección URL pública, se deben configurar asignaciones alternativas de acceso para manipular la traducción de la dirección URL.

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

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

-Interno

Convierte esta dirección URL alternativa en una dirección URL interna. Si no se proporciona este parámetro, la dirección URL es una dirección URL pública.

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

-ResourceName

Especifica el nombre del recurso si la dirección URL alternativa es para un recurso externo. Si no se especifica ningún valor, el valor se deja en blanco.

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 pública a la que tienen acceso los usuarios para iniciar sesión en la aplicación web.

El tipo debe ser una dirección URL válida, con el formato https://server_name.

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

-WebApplication

Especifica el nombre, la dirección URL o el GUID de la aplicación web para la que se debe crear la asignación.

El tipo debe ser un nombre válido, una dirección URL, con el formato WebApplication-1212, https://server_name o un GUID, con el formato 1234-5678-9876-0987.

Type:SPWebApplicationPipeBind
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 las que está asociada la dirección URL.

El tipo debe ser una zona válida: 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