Como instalar una solución (.wsp) de SharePoint 2010 via PowerShell
Esta es una copia cruzada del artículo escrito en el blog original:
Como instalar una solución (.wsp) de SharePoint 2010 via PowerShell
---------------------------------------------------------
Hola, dado la poca documentación que existe en la web al respecto de este tema he decidido escribir este artículo que estoy seguro le será de mucha utilidad a todos ustedes.
Una vez generado el paquete desde Visual Studio 2010, abrimos una consola de administración de SharePoint, sobra decir que la debemos abrir con privilegios de administrador ( clic derecho, ejecutar como administrator ).
Inicia el trabajo, revisaremos primero la forma de realizar la instalación, seguidamente como hacer la desinstalación y finalmente un tip que les será útil a todos.
Instalación de la solución
La instalación se divide en 3 partes
- Subir la solución
- Instalarla
- Activar las características
Procedemos a ejecutar los siguientes pasos en la consola de administración de SharePoint 2010, como la instalación puede ser un proceso ‘incomodo’ entonces lo primero que realizaremos será crear tres variables, una de ellas para la ubicación del sitio, otra para el nombre de la solución y una última para el nombre de la característica.
En este ejemplo los valores para esas variables son:
- url del sitio esta en http://localhost
- nombre de la solución TestWebPart.wsp
- nombre de la única característica de la solución “TestWebPart Feature1″ o su id = “64C2C32C-064D-4216-BB63-6A67EFE828D1″
Así que los primeros comandos a ejecutar son para inicializar las variables
1 2 3 | $SolName="TestWebPart.wsp"
$FeaName="TestWebPart_Feature1"
|
1. Subir la solución
Cambiamos al directorio donde esta el archivo .wsp
seguidamente ejecutamos el siguiente comando, -LiteralPath nos pide el path completo del archivo .wsp, no importa si ya estamos en el directorio en todo caso debemos poner la ruta completa.
1 | Add-SPSolution -LiteralPath "C:\TestWebPart.wsp"
|
Esto nos debe generar la siguiente salida
1 2 3 | Name SolutionId Deployed
---- ---------- --------
testwebpart.wsp 2361bfd2-d113-4f4d-8941-cfdb66edb891 False
|
2. Instalar la solución
Una vez hemos subido la solución al servidor procedemos a instalarla así
1 | Install-SPSolution -Identity $SolName -WebApplication $SiteUrl -GACDeployment
|
Si el comando fue exitoso no hay ningún feedback por consola.
3. Activación de las características de la solución
La solución ya está instalada así que ahora debemos activar las características que hemos incluido. Si hemos desarrollado un Webpart desde Visual Studio 2010 este crea automáticamente una característica, podemos instalarla haciendo uso de su nombre o de is en caso de que lo hayas generado
Tip: si el nombre de la característica tiene espacios, deberás reemplazarlos por el carácter ‘_’ (línea al piso)
1 | Install-SPSolution -Identity $SolName -WebApplication $SiteUrl -GACDeployment
|
Si el comando fue exitoso no hay ningún feedback por consola.
Con eso finalizamos la parte de la instalación, así que vamos a SharePoint y verificamos.
En este caso estamos instalando un webpart así que vamos a Acciones del sitio, Configuración, Elementos web y allí debes encontrar el webpart que acabamos de instalar.
Desinstalación de la solución
Esta parte es básicamente lo mismo pero al revez, si, así de fácil.
- Desactivar las características
- Desinstalar la solución
- Remover la solución
1. Desactivar las características
1 | Disable-SPFeature -Identity $FeaName -Url $SiteURL -Confirm:$false
|
Si es exitoso no hay respuesta
3. Remover la solución
Este comando no sirve pada nada. Así es lo tenemos que ejecutar pero no hace lo que se supone que debe hacer, o mejor, lo hace a medias…
1 | Remove-SPSolution -Identity $SolName -Confirm:$false
|
Si es exitoso no hay respuesta.
Sin embargo si revisamos nuestro webpart aún aparece solo que no se puede usar para nada. Se supone que precisamente este comando lo remueve, pero realmente remueve la solución pero no todos sus componentes, de seguro un bug.
En un próximo artículo les mostraré como eliminar por completo el rastro del webpart que no desapareció.