Disable-SPFeature

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

Deshabilita una característica de SharePoint instalada en un ámbito determinado.

Syntax

Disable-SPFeature
       [-Identity] <SPFeatureDefinitionPipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-Url <String>]
       [-WhatIf]
       [<CommonParameters>]

Description

El cmdlet Disable-SPFeature deshabilita una característica de SharePoint en un ámbito determinado. Si el ámbito de la característica es el conjunto de servidores, no se necesita la dirección URL. De lo contrario, proporcione la dirección URL en donde se debe desactivar esta característica (no se requiere un ámbito explícito).

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

Disable-SPFeature -identity "MyCustom" -URL https://somesite

En este ejemplo se deshabilita la característica con ámbito de sitio web "MyCustom" en https://somesite.

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

C:\PS>$w = Get-SPWeb https://somesite/myweb | ForEach{ $_.URL }
Get-SPFeature -Web $w |%{ Disable-SPFeature -Identity $_ -URL $w}

En este ejemplo se deshabilitan todas las características del subsitio en https://somesite/myweb.

En este caso, no es necesario usar los cmdlets SPAssignment porque el objeto web no está almacenado, solo el valor de cadena 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

-Force

Fuerza la deshabilitación de una característica.

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

-Identity

Especifica el nombre de la característica o el GUID que se debe deshabilitar.

El tipo debe ser el nombre de la carpeta de característica ubicada en el GUID o la carpeta 14\Template\Features, con el formato 21d186e1-7036-4092-a825-0eb6709e9281.

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

-Url

Especifica la dirección URL de la aplicación web, la colección de sitios o el sitio web para los que se deshabilita la característica.

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

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

-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