Remove-SPManagedPath

  • Referencia
Módulo:
SharePointServer
Se aplica a:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Elimina la ruta de acceso administrada especificada de la aplicación web o el encabezado host especificados.

Syntax

Remove-SPManagedPath
      [-Identity] <SPPrefixPipeBind>
      [-HostHeader]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]
Remove-SPManagedPath
      [-Identity] <SPPrefixPipeBind>
      -WebApplication <SPWebApplicationPipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Description

Este cmdlet contiene más de un conjunto de parámetros. Solo puede usar parámetros de un conjunto y no puede combinar parámetros de conjuntos distintos. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.

El Remove-SPManagedPath cmdlet elimina la ruta de acceso administrada especificada por el parámetro Identity del encabezado de host o de la aplicación web. El valor de Identity debe ser la dirección URL parcial de la ruta de acceso administrada que se va a eliminar.

Si usa colecciones de sitios con nombre de host, especifique el parámetro HostHeader. Para eliminar una ruta de acceso administrada de colección de sitios con nombre de host, proporcione el modificador HostHeader. De lo contrario, debe especificar la aplicación web que contiene la ruta de acceso administrada que se va a eliminar.

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

Remove-SPManagedPath "sites" -HostHeader

En este ejemplo se quita la ruta de acceso administrada de sitios de la lista de rutas de acceso administradas de colección de sitios con nombre de host.

Según el nivel de confirmación del sistema local, en el ejemplo anterior se puede pedir confirmación antes de la ejecución.

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

Get-SPWebApplication | Remove-SPManagedPath "personal" -confirm:$false

En este ejemplo se quita la ruta de acceso administrada personal de todas las aplicaciones web del conjunto de servidores. Este comando no pide confirmación.

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

-HostHeader

Especifica que el valor de Identity es una ruta de acceso administrada de encabezado host.

Type:SwitchParameter
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

-Identity

Especifica el nombre de la ruta de acceso administrada que se va a eliminar. Por ejemplo, en la dirección URL https://sitename/sites/site1, "sites" es el nombre de la ruta de acceso administrada.

Type:SPPrefixPipeBind
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 la identidad de la aplicación web que hospeda la ruta de acceso administrada que se va a eliminar. El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh, un nombre de aplicación web válido (por ejemplo, WebApplication1212) o un nombre válido, con el formato WebApp2423.

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