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.
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" -internalEn 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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |