Compartir a través de

Enable-SPFeature

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

Habilita una característica de SharePoint instalada en el ámbito especificado.

Syntax

Enable-SPFeature
      [-Identity] <SPFeatureDefinitionPipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-Force]
      [-PassThru]
      [-Url <String>]
      [-WhatIf]
      [<CommonParameters>]
Enable-SPFeature
      [-Identity] <SPFeatureDefinitionPipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-Force]
      [-PassThru]
      [-WhatIf]
      [-CompatibilityLevel <Int32>]
      [<CommonParameters>]

Description

El cmdlet Enable-SPFeature habilita una característica instalada en el ámbito especificado. Si la característica es una característica de conjunto de servidores, no se necesita ninguna dirección URL. De lo contrario, proporcione la dirección URL donde se va a habilitar la característica y se habilitará en el ámbito adecuado en función de la definición de característica.

Este cmdlet no tiene ninguna salida a menos que se proporcione el parámetro PassThru, en cuyo caso se devuelve el objeto SPFeatureDefinition para la característica recién habilitada.

Si intenta usar el parámetro Url en una característica con ámbito de granja de servidores, recibirá el siguiente mensaje de error:

La característica "<nombre> de característica" se aplica a toda la granja de servidores; el parámetro Url no se puede usar con características con ámbito de granja de servidores.

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

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

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

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

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

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

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

-CompatibilityLevel

{{Fill CompatibilityLevel Description}}

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

-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

Aplica la activación de una característica. Esto hace que cualquier código personalizado asociado con la característica se vuelva a ejecutar.

Nota:

Tenga en cuenta que -Force no funcionará si actualizó la característica con Update-SPSolution. En este caso, primero debe deshabilitar la característica con Disable-SPFeature y, a continuación, volver a habilitarla con Enable-SPFeature

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 GUID que se va a desinstalar.

El tipo debe ser el nombre de la carpeta de la característica ubicada en la carpeta 14\Template\Features o el GUID, 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

-PassThru

Si se proporciona, el cmdlet da como resultado el objeto de definición de característica tras la habilitación.

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

-Url

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

El tipo debe ser una dirección URL válida; por ejemplo, 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