Get-SPAlternateURL

Referencia

Módulo:: sharepoint-server

Se aplica a:: SharePoint Server Subscription Edition

Devuelve todas las direcciones URL alternativas que coinciden con un conjunto de criterios específico.

Syntax

Get-SPAlternateURL
   [[-Identity] <SPAlternateUrlPipeBind>]
   -ResourceName <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Zone <SPUrlZone>]
   [<CommonParameters>]

Get-SPAlternateURL
   [[-Identity] <SPAlternateUrlPipeBind>]
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-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 Get-SPAlternateURL devuelve todas las direcciones URL alternativas que coinciden con el ámbito especificado por el parámetro Identity opcional o por una combinación de los parámetros WebApplication, Zone o Resource opcionales. Cada criterio que se agrega limita el ámbito. Si no se especifica ningún criterio, se devuelven todas las direcciones URL alternativas.

Si se usa el parámetro Identity, solo se devuelve la dirección URL alternativa específica que coincide. Si no existe ninguna dirección URL alternativa con la identidad determinada en el ámbito especificado, no se devuelve ningún resultado.

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

Get-SPAlternateURL -WebApplication https://sitename

En este ejemplo se muestran todas las direcciones URL alternativas en una aplicación web determinada.

--------------EJEMPLO 2-----------------

Get-SPAlternateURL -ResourceName "MyResource"

En este ejemplo se muestran todas las direcciones URL alternativas para un recurso determinado.

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

-Identity

Especifica la dirección URL o el GUID de la dirección URL alternativa que se va a obtener.

El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh, o una dirección URL válida, en el formulario. https://server_name.

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

-ResourceName

Especifica el nombre del recurso desde el cual se enumeran las direcciones URL alternativas.

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

-WebApplication

Especifica la aplicación web desde la cual se enumeran las direcciones URL alternativas.

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

-Zone

Especifica una de las cinco zonas con las que se asocian las direcciones URL alternativas.

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