Install-SPFeature

Instala una característica de SharePoint con el archivo Feature.xml.

Syntax

Install-SPFeature
       [-Path] <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-CompatibilityLevel <Int32>]
       [-Confirm]
       [-Force]
       [-WhatIf]
       [<CommonParameters>]
Install-SPFeature
       [-AllExistingFeatures]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-SolutionId <String>]
       [-WhatIf]
       [<CommonParameters>]
Install-SPFeature
       [-ScanForFeatures]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-SolutionId <String>]
       [-WhatIf]
       [<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 Install-SPFeature instala una SPFeature específica proporcionando, en el parámetro Identity, la ruta de acceso relativa de la carpeta FEATURES común específica de la versión a la característica. La carpeta FEATURES específica de la versión es "$env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES" si la colección de sitios está en modo 14 y "$env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES" si la colección de sitios está en modo 15. Los archivos de la característica de SharePoint ya deben colocarse en el directorio adecuado, ya sea manualmente o mediante un instalador de solución.

If the value of the AllExistingFeatures parameter is true, the file system is scanned and all new features that are in both FEATURES folders are installed. This is generally only used during deployment and upgrade.

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

Install-SPFeature -path "MyCustomFeature"

Este ejemplo instala una nueva característica en $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES\MyCustomFeature/feature.xml.

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

Install-SPFeature -AllExistingFeatures -Whatif

This example shows the unregistered features that are available on the file system and that are installed if this command is run without the WhatIf parameter. This is commonly done after an upgrade process.

--------------EJEMPLO 3-----------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 14

En este ejemplo se instala una nueva característica en $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\FEATURES\MyCustomFeature\feature.xml.

--------------EJEMPLO 4-----------------

Install-SPFeature -path "MyCustomFeature"  -CompatibilityLevel 15

Este ejemplo instala una nueva característica en $env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions\15\TEMPLATE\FEATURES\MyCustomFeature\feature.xml.

Parámetros

- AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

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

-AllExistingFeatures

Busca características existentes no registradas y las registra en la granja.

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

-CompatibilityLevel

Especifica la versión de la característica que desea instalar. Si no proporciona ningún valor, se usará el valor MaxVersion predeterminado para las aplicaciones web.

Los valores para esto pueden ser 14 o 15.

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

-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Force

Fuerza la instalación de una característica ya instalada.

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

-Path

Especifica una ruta de acceso de archivo válida (por ejemplo, MiCaracterística).

The path to feature must be a literal path to the 14\Template\Features directory. The feature.xml file name is implied and does not need to be provided.

Si no se encuentra la ruta de acceso a la característica , se muestra el siguiente mensaje de error: "No se pudo encontrar el archivo XML en la ubicación 14\Template\Features\<file path>".

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

-ScanForFeatures

Examina y, a continuación, muestra una característica. El parámetro ScanForFeatures no instala una característica.

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

-SolutionId

Especifica el identificador de solución de las características. Si no proporciona el parámetro SolutionId, se examinarán todos los identificadores de solución.

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

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition