Get-SPFeature
Devuelve las características de SharePoint basadas en un ámbito determinado.
Syntax
Get-SPFeature
[[-Identity] <SPFeatureDefinitionPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Farm]
[-Limit <String>]
[<CommonParameters>]
Get-SPFeature
[[-Identity] <SPFeatureDefinitionPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Limit <String>]
[-Site <SPSitePipeBind>]
[-Sandboxed]
[<CommonParameters>]
Get-SPFeature
[[-Identity] <SPFeatureDefinitionPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Limit <String>]
[-Web <SPWebPipeBind>]
[<CommonParameters>]
Get-SPFeature
[[-Identity] <SPFeatureDefinitionPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Limit <String>]
[-WebApplication <SPWebApplicationPipeBind>]
[<CommonParameters>]
Get-SPFeature
[[-Identity] <SPFeatureDefinitionPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Limit <String>]
[-CompatibilityLevel <Int32>]
[<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 obtener más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de https://go.microsoft.com/fwlink/?LinkID=18781cmdlet .
Todos los conjuntos de parámetros toman el parámetro Identity, que puede ser la ruta de acceso relativa de la característica de SharePoint (se considera el nombre de la característica) o el GUID de una definición de característica.
Si se indica el parámetro Identity, el cmdlet intenta encontrar la definición o versión de característica determinada para el ámbito especificado. Si no se especifica ningún parámetro, se devuelven todas las características instaladas.
El cmdlet Get-SPFeature se comporta de forma diferente en cada ámbito y devuelve las características habilitadas en cada nivel. Si no se indica ningún ámbito, se devuelven todas las características instaladas.
Para obtener permisos y la información más reciente sobre Windows PowerShell para productos de SharePoint, consulte la documentación en línea en https://go.microsoft.com/fwlink/p/?LinkId=251831.
Ejemplos
--------------EJEMPLO 1-----------------
Get-SPFeature -Limit ALL | Where-Object {$_.Scope -eq "SITE"}
En este ejemplo se devuelve una lista de todas las características con ámbito SITE instaladas.
--------------EJEMPLO 2-----------------
Get-SPSite https://somesite | Get-SPWeb -Limit ALL |%{ Get-SPFeature -Web $_ } | Select DisplayName,ID -Unique
En este ejemplo se devuelve el nombre y el identificador (ID) de cada característica habilitada de forma única en cada objeto SPWeb de la colección de sitios en https://somesite.
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
Especifica la versión de plantillas que se usará al crear un nuevo objeto SPSite. Este valor definirá el valor CompatibilityLevel inicial para la colección de sitios. Si no se especifica este parámetro, CompatibilityLevel asumirá de forma predeterminada la versión más avanzada posible de la aplicación web, conforme al valor de CompatibilityRange.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Farm
Especifica que, si se usa este parámetro, solo se muestran las características de conjunto de servidores habilitadas.
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 que se va a recuperar.
El tipo debe ser el nombre completo o parcial, en el formulario Feature1, o un GUID, con el formato 1234-4567-9879, de la característica que se va a obtener.
Type: | SPFeatureDefinitionPipeBind |
Position: | 1 |
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 |
-Limit
Limita los resultados para mostrar. Si se especifica "All", se muestran todas las características.
El tipo debe ser un número válido mayor que 0. El valor predeterminado es 200.
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 |
-Sandboxed
Especifica que se recuperarán las características del espacio aislado.
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 |
-Site
Especifica el nombre de la colección de sitios desde donde se obtienen las características habilitadas.
El tipo debe ser una dirección URL válida para una colección de sitios, con el formato https://server_name.
Type: | SPSitePipeBind |
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 |
-Web
Especifica la dirección URL o el GUID del sitio web.
El tipo debe ser una dirección URL válida, con el formato https://server_name o un GUID, con el formato 1234-5678-9876-0987.
Type: | SPWebPipeBind |
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 |
-WebApplication
Especifica el nombre de la aplicación web desde donde se obtienen las características habilitadas.
El tipo debe ser una dirección URL válida a la aplicación web, con el formato https://server_name.
Type: | SPWebApplicationPipeBind |
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 |