New-SPAlternateURL

Referencia

Módulo:: sharepoint-server

Se aplica a:: SharePoint Server Subscription Edition

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.

El cmdlet New-SPAlternateUrl crea una dirección URL interna o pública para el recurso o la zona de la aplicación web especificada. Use el parámetro ResourceName si la dirección URL alternativa es para un recurso externo.

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

Cada aplicación web admite cinco colecciones de asignaciones por dirección URL; las cinco colecciones se corresponden con cinco zonas (predeterminada, intranet, extranet, Internet y personalizada). Cuando la aplicación web recibe una solicitud de una dirección URL interna en una zona determinada, los vínculos de las páginas devueltas al usuario tienen la dirección URL pública para dicha zona.

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

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

-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

-Internal

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
Required:	False
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
Required:	True
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, en el formulario https://server_name.

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