Peoplepicker-searchadforests: propiedad de Stsadm (Office SharePoint Server)

Artículo
06/12/2012

Permite a un usuario buscar desde un segundo dominio o bosque de confianza unidireccional.

Todos los servidores de una granja deben encontrarse dentro de un dominio. Los usuarios del bosque al que pertenece el servidor (es decir, un bosque de recursos) se muestran automáticamente. Se pueden realizar búsquedas en los bosques que tienen al menos una confianza unidireccional con el fin de encontrar usuarios para agregar.

Cuando una aplicación web utiliza la autenticación de Windows, el Selector de personas busca en todos los bosques y dominios de confianza bidireccional. Sin embargo, si desea buscar desde un bosque o dominio de confianza unidireccional, debe ejecutar la operación setapppassword y, a continuación, ejecutar la propiedad peoplepicker-searchadforests.

La propiedad peoplepicker-searchadforests permite buscar en varios valores cuando se seleccionan los usuarios. También puede agregar varios bosques, dominios, cuentas e incluso búsquedas de propiedades específicas.

Nota

De forma predeterminada, Microsoft Office SharePoint Server 2007 se comunica con el controlador de dominio del dominio en el que está instalado Office SharePoint Server 2007 y con todos los dominios de confianza para los dominios de confianza bidireccionales.

Sintaxis

La sintaxis para la operación setproperty es:

stsadm -o setproperty

-propertyname peoplepicker-searchadforests

-propertyvalue <lista válida de bosques o dominios>

[-url] <Dirección URL>

La sintaxis para la operación getproperty es la siguiente:

stsadm -o getproperty

propertyname peoplepicker-searchadforests

[-url] <Dirección URL>

Nota

Puede sustituir -pn por -propertyname y -pv por -propertyvalue.

Valores

En la siguiente tabla se muestran los valores posibles.

Nombre	Valor
propertyname	Obtiene o establece el nombre de la propiedad.
propertyvalue	Una lista válida de bosques o dominios. El formato de la lista de valores de bosques o dominios incluye los siguientes elementos: forest:nombreDNS,nombreDeInicioDeSesión,Contraseña domain:nombreDNS,nombreDeInicioDeSesión,Contraseña Nota Si usa Contraseña, debe ejecutar primero stsadm –o setapppassword–password <Cadena> en cada servidor cliente web. <Cadena> puede ser una cadena cualquiera y se usará como clave para cifrar la contraseña en el dominio:nombreDNS,nombreDeInicioDeSesión,Contraseña o bosque:nombreDNS,nombreDeInicioDeSesión,Contraseña y almacenar la contraseña cifrada en la base de datos. Sin embargo, si los dominios o bosques son de confianza, no es necesario pasar el nombre de inicio de sesión ni la contraseña. Se utiliza el siguiente formato: forest:nombreDNS o domain:nombreDNS.
url	Normalmente, una ruta de acceso a la dirección URL de la aplicación web, con el formato http://nombre_de_servidor.

propertyname

Obtiene o establece el nombre de la propiedad.

propertyvalue

Una lista válida de bosques o dominios. El formato de la lista de valores de bosques o dominios incluye los siguientes elementos:

forest:*nombreDNS,nombreDeInicioDeSesión,Contraseña*
domain:*nombreDNS,nombreDeInicioDeSesión,Contraseña*

Nota

Si usa Contraseña, debe ejecutar primero stsadm –o setapppassword–password <Cadena> en cada servidor cliente web. <Cadena> puede ser una cadena cualquiera y se usará como clave para cifrar la contraseña en el dominio:nombreDNS,nombreDeInicioDeSesión,Contraseña o bosque:nombreDNS,nombreDeInicioDeSesión,Contraseña y almacenar la contraseña cifrada en la base de datos. Sin embargo, si los dominios o bosques son de confianza, no es necesario pasar el nombre de inicio de sesión ni la contraseña. Se utiliza el siguiente formato: forest:nombreDNS o domain:nombreDNS.

url

Normalmente, una ruta de acceso a la dirección URL de la aplicación web, con el formato http://*nombre_de_servidor*.

Ejemplos

Búsqueda en más dominios o bosques

Para enumerar una lista de usuarios mediante el Selector de personas desde un segundo bosque o dominio, utilice la siguiente sintaxis:

stsadm –o setproperty –pn peoplepicker-searchadforests –pv <lista de bosques o dominios> -url <aplicación_web>

Especificar una cuenta de usuario y una contraseña desde una confianza unidireccional

Para especificar el nombre de usuario y la contraseña desde una confianza unidireccional, de modo que el Selector de personas pueda buscar esta información, utilice la siguiente sintaxis:

stsadm -o setproperty -url http://<servidor:puerto> -pn peoplepicker-searchadforests -pv "forest:contoso.corp.com;domain:bar.contoso.corp.com", <nombreDeInicioDeSesión>, <Contraseña>

Propiedades y operaciones relacionadas

Puede incluir otros usuarios y grupos de varios bosques. Para obtener más información acerca de cómo seleccionar y agregar usuarios, vea Selección de usuarios de dominios de varios bosques y Adición de usuarios de varios dominios de bosque.