Lendo um post no fórum do MSDN com o título Recuperar ID de pasta na Biblioteca usando Web Services fiquei curioso com o problema reportado, que era conseguir consultar uma pasta do SharePoint passando o nome dela e retornando o ID, utilizando o webservice Lists.ASMX.

Este post tem um exemplo de como implementar esta necessidade.

Leia o resto deste post »

O workflow do SharePoint 2010 é muito rico em detalhes que muitas vezes são inexplorados. Um deles é o processo de aprovação, que nos permite customizar a interação do usuário com as tarefas de workflow de uma forma mais rica.

Neste post vou mostrar como editar o e-mail de tarefa atribuída que o workflow envia, mas o conteúdo deste post pode ser utilizado em outras customizações desta atividade.

Leia o resto deste post »

Como ustedes deben recordar en SharePoint 2010 usted podía utilizar la interfaz gráfica para crear o  re configurar su topología de Búsqueda empresarial, utilizando la administración de la aplicación de servicio de Búsqueda.  En dicha interfaz gráfica usted puede crear, editar o remover cualquiera de los siguientes componentes:

• Componente de Administración
• Componente de Rastreo (Crawl)
• Bases de datos de rastreo
• Componente de Consultas (Query)
• Particiones del índice.

Y era muy fácil para los administradores utilizar cualquiera de los servidores de la graja y de esta forma configurar la mejor topología de Búsqueda empresarial basados en sus requerimientos de negocio.

Una de las cosas que las personas más me comentan es que utilizar la interfaz gráfica para configurar la topología es realmente fácil, pero si uno comete algún error configurando algún parámetro o tiene algún otro problema en la granja, y al finalizar de configurar la topología empresarial de Búsqueda, y hacer clic en el botón de aplicar los cambios, luego de un buen rato aparece un error y las mayoría de los cambios realizados no se mantienen.

El anterior problema es una buena razón para configurar su topología empresarial de Búsqueda con Power Shell, porque usted tiene toda la flexibilidad de crear y re configurar los componentes,  y esto puede ayudar a identificar problemas en su granja o topología antes de que finalice de configurar en su totalidad esta.

También es importante mencionar que algunos administradores de SharePoint le temen administrar SharePoint con Power Shell, por qué piensas que están pasándose al lado de desarrollo y ellos solo quieren ser profesionales de infraestructura.  Pero lo que deben saber es que Microsoft está invirtiendo en utilizar Power Shell en la mayoría de sus productos con el fin de ofrecer una sola forma de administrarlos a todos y facilitar y flexibilizar las tareas de infraestructura.  Yo espero que este blog ayude a aquellos administradores a quitarse ese concepto de la mente.

Es de saber para las personas que ya están trabajando con SharePoint 2013, que la única vía para configurar la topología de búsqueda es atreves de Power Shell y sus cmdlets disponibles para crear los nuevo y poderosos componentes del nuevo servicio empresarial de Búsqueda de SharePoint 2013.

El propósito de esta entrada de blog es mostrar algunos ejemplos de cómo crear una topología de Búsqueda empresarial en SharePoint 2013, obviamente utilizando Power Shell, pero no solo mencionando que cmdlets utilizar, sino también como podrían automatizar esta labor y así poder repetir estos pasos las veces que sean necesarias y utilizarlos en otras implementaciones de SharePoint 2013, y adicionalmente ayudar a los administradores de SharePoint a perder ese miedo en utilizar Power Shell para administrar SharePoint.

Todos los cmdlets utilizados en esta entrada de blog están basados en el siguiente documento de TechNet:

Manage search components in SharePoint Server 2013

http://technet.microsoft.com/en-us/library/jj862354.aspx

Si usted no ha leído el anterior documento, yo recomiendo que lo haga o lo tome como referencia para la lectura de esta entrada.

A continuación voy a resumir los pasos para crea una nueva topología de Búsqueda en SharePoint 2013, y los cuales son mencionados en el anterior documento:

1. Iniciar la instancia de servicio de búsqueda: Recuerde que si quiere habilitar un servidor para que sea utilizado en la topología de Búsqueda debe antes iniciar el servicio de búsqueda en dicho servidor.
2. Obtener la referencia de la topología de búsqueda activa: Existen 2 opciones, la primera es crear una topología de búsqueda vacía, o la segunda es clonar la actual topología de búsqueda y modificarla, en este caso vamos a asumir que vamos a utilizar la actual topología para modificarla.
3. Clonar la topología de búsqueda activa: Como se mencionó anteriormente vamos a clonar la topología para después modificarla.
4. Adicionar o remover componentes de búsqueda: Cuando clonamos la topología podemos modificarla adicionándole o removiéndole componentes de tal forma que creemos la nueva deseada.
5. Activar la nueva topología de búsqueda: Finalmente después de terminar de modificar la topología debemos definir esta como activa.

Como se puede ver existen varios pasos a realizar y por lo tanto varios comandos de Power Shell deben ser ejecutados, por esta razón he creado las siguientes funciones que nos permitirán facilitar la creación de la topología de búsqueda.

GetOrStartSearchServiceInstance

La siguiente función permite identificar si un servidor tiene el servicio de búsqueda indicado, si no es así lo inicia.

En este caso la forma de llamar esta función será:

Como pudo ver en el documento de TechNet, para adicionar y remover un componente de búsqueda se utilizan los siguientes cmdlets:

• Remove-SPEnterpriseSearchComponent: Remueve un componente especifico de la topología de búsqueda.
• New-SPEnterpriseSearch<SearchComponent>Component: Donde <SerachComponente> puede ser Admin, AnalyticsProcessing, ContentProcessing, Crawl and QueryProcessing.  Y sirven para crear un componente de la topología de búsqueda.

En el caso de New-SPEnterpriseSearch<SearchComponent>Component, si usted entra en detalle a ver que parámetros acepta, es posible para todos los cmdlets proveer 2 parámetros básicos los cuales son la topología y la instancia de servicio (es decir el servidor), es por esto que he creado la siguiente función la cual permite crear cualquiera de los componentes anteriormente mencionados en la cantidad de servidores necesarios.

Set-SPSearchComponents

Esta función necesita los siguientes parámetros:

• ServerType: Es una cadena de caracteres que define el tipo de componente a crear, el cual puede ser: Admin, AnalyticsProcessing, ContentProcessing, Crawl or QueryProcessing.
• ServersStringArray: Es una cadena de caracteres que contenga el nombre de los servidores donde se desea habilitar el tipo de componente de búsqueda, estos deben estar separados por coma.
• Topology: Debe ser una variable de referencia a la topología de búsqueda que se quiera modificar.

Un ejemplo para invocar esta función podria ser el siguiente:

Finalmente para dar un gran ejemplo de cómo crear totalmente una topología empresarial de Búsqueda en SharePoint 2013, he creado la siguiente función, la cual hace uso de las anteriores.

New-SPSearchTopology

Para usar esta función se deben proveer los siguientes parámetros:

• AdminServers: Los servidores que desea utilizar que provean el componente de Admin.  Estos servidores deben estar en una cadena de caracteres separados por coma: “server1,server2,server3”.
• AnalyticsServers: Los servidores que desea utilizar que provean el componente de AnalyticsServers.  Estos servidores deben estar en una cadena de caracteres separados por coma: “server1,server2,server3”.
• ContentServers: Los servidores que desea utilizar que provean el componente de ContentServers.  Estos servidores deben estar en una cadena de caracteres separados por coma: “server1,server2,server3”.
• CrawlServers: Los servidores que desea utilizar que provean el componente de CrawlServers.  Estos servidores deben estar en una cadena de caracteres separados por coma: “server1,server2,server3”.
• QueryServers: Los servidores que desea utilizar que provean el componente de QueryServers.  Estos servidores deben estar en una cadena de caracteres separados por coma: “server1,server2,server3”.

Un ejemplo para invocar esta función podria ser el siguiente:

Espero que esta entrada haya sido de ayuda para crear su nueva topología empresarial de Búsqueda en SharePoint 2013, y recuerde que no todas las consideraciones acerca del servicio empresarial de Búsqueda de SharePoint 2013 han sido tomadas en cuenta en este artículo, en el futuro espero escribirles acerca de:

• Como detener el servicio de búsqueda en los servidores no requeridos.
• Mover la ubicación de los archivos de índice.
• Particiones del índice.
• Bases de datos de búsqueda.

As you may remember in SharePoint 2010 you had a specific user interface to create and reconfigure your enterprise Search topology, in the Search Service applications management.  There you can create, edit and remove the following components:

• Admin component
• Crawl components
• Crawl databases
• Query components
• Partitions

And it was very easy by the administrator to use any server in their farm to configure the best enterprise Search topology for their business requirements.

One thing than many people said to me was that the configuration was very easy with the UI, but if you put something wrong or your farm have any issue, when you finished to reconfigure your enterprise search topology, and you click in the button to apply all the changes, it takes a while and gives you an error and also you lose the majority of the changes that you made before.

The above problem was a good reason to configure your enterprise search topology with Power Shell, because you have the flexibility to create and reconfigure the components one by one, it help you to identify issues in your farm regarding the search service before finish to define your enterprise search topology. 

Also some Share Points administrators have afraid to manage SharePoint with Power Shell, because are thinking that are writing scripts so are developing things, and they may be don’t want to be a developers, only IT infrastructure guys.  But you must to know that the reason that Microsoft are integrating Power Shell in all our products is to try to standardize the way that you can manage the different services.  I hope this blog could help to those SharePoint administrators that have this concept in mind.

Now, for the people that are working with SharePoint 2013, knows that the only way to create or reconfigure your enterprise Search Topology is using the Power Shell cmdlets created for the new and powerful components of the SharePoint 2013 Enterprise Search Service Application.

The propose of this blog entry is to show you some examples to create an enterprise Search topology in SharePoint 2013, also with Power Shell, but not only to tell you the specific cmdlets that you must or can use to do this job, my objective is to try to automatize this work creating scripts that you can use in your different implementations of SharePoint 2013, also this can help the SharePoint administrators to lose their afraid when are using Power Shell to manage SharePoint.

All the cmdlets that I use in this entry are based in the following TechNet document:

Manage search components in SharePoint Server 2013

http://technet.microsoft.com/en-us/library/jj862354.aspx

If you didn’t read the above document, I recommend to you to do it or take as a reference for the cmdlets that you are going to see here.

I’m going to start to summarize the basics steps that you must to do when you want to create a new Enterprise search topology:

1. Start the search server instance: Remember that you must to start the server instance in all servers that you want to use for a specific service application, in this case to create a new Search topology you must to start the service instance in the servers than you want to use in your topology.
2. Retrieve the active Search topology: You have 2 options, first to create a new empty search topology or second to clone the active topology and modify them, in this case I assuming that we are creating a Search topology using some of the same components that the current topology have, so for this reason we are going to clone the active topology instead to create a new one, to do this you must to retrieve the current active Search topology.
3. Clone the active Search topology: As I explained in the above step, we are going to clone the active Search topology.
4. Add or remove search components: When we have a cloned Search topology we can remove or add components without affecting the active Search topology.  In this steps we are going to redistribute and use all the servers we defined in the first step.
5. Active the new Search topology: Finally we need to set the modified Search topology as the active topology to begin to work whit it.

As  you can see there are some steps that you must to do and in some cases you must to repeat them, for this reason I created the following power shell functions to help to create our Search topology.

GetOrStartSearchServiceInstance

The following function help us to check if the search service instance is started in a specific sever and retrieve the reference to it, or start the service instances in the case that is wasn’t started.

In this case you provide to the function a server name and the function retrieve a search service instance, you must to call it in the following way:

As you can saw in the TechNet document, to add and remove the search component we use the following functions:

• Remove-SPEnterpriseSearchComponent: To remove a specific Search topology component.
• New-SPEnterpriseSearch<SearchComponent>Component: Where <SearchComponent> could be Admin, AnalyticsProcessing, ContentProcessing, Crawl and QueryProcessing.  To create a new Search topology component.

In the case of New-SPEnterpriseSearch<SearchComponent>Component, you can dig in deep and see that you can use the same basic parameters: the Search topology and the search service instance, for that reason I created the following function to help create and remove the specific components on a the specific servers.

Set-SPSearchComponents

This functions needs the following parameters:

• ServerType: Is a string that define the component to add or remove, can be: Admin, AnalyticsProcessing, ContentProcessing, Crawl or QueryProcessing.
• ServersStringArray: The servers that you want to use to host the specific search component.  This servers must be separated by coma, for example: “server1,server2,server3”.
• Topology: The reference to the Search topology that you want to modify to add or remove the componets.

An example to use this function could be:

Finally to give you a mainly example to create a SharePoint 2013 Enterprise Search Topology, I written the following function using the functions mentioned above.

New-SPSearchTopology

To use this function must to pass the following parameters:

• AdminServers: The servers that you want to use to host the Admin search component.  This servers must be separated by coma, for example: “server1,server2,server3”.
• AnalyticsServers: The servers that you want to use to host the Analytics Processing search component.  This servers must be separated by coma, for example: “server1,server2,server3”.
• ContentServers: The servers that you want to use to host the Content Processing search component.  This servers must be separated by coma, for example: “server1,server2,server3”.
• CrawlServers: The servers that you want to use to host the Crawl search component.  This servers must be separated by coma, for example: “server1,server2,server3”.
• QueryServers: The servers that you want to use to host the Query search component.  This servers must be separated by coma, for example: “server1,server2,server3”.

An example to use this function could be:

I hope this post could help you to create your new SharePoint 2013 Enterprise Search Topology, and remember that not all the Enterprise Search considerations are taken on this scripts, in the future I going to write about how to change the following characteristics:

• Stop the search service instance.
• Move the index location.
• Move the search component.
• Index partitions.
• Search databases.