Compartir a través de

  • Artículo

Get-CsAddressBookConfiguration

 

Última modificación del tema: 2012-03-23

Devuelve información sobre los valores de configuración de la libreta de direcciones.

Sintaxis

Get-CsAddressBookConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsAddressBookConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Los servidores de libreta de direcciones son intermediarios entre Active Directory Domain Services (AD DS) y Microsoft Lync Server 2010. El servidor de libreta de direcciones comprueba que la información de los usuarios almacenada en Lync Server 2010 está sincronizada con la información de los usuarios almacenada en Active Directory. Para ello se sincronizan periódicamente los archivos de libreta de direcciones con la información almacenada en la Base de datos de usuarios.

Asimismo, los servidores de libreta de direcciones generan periódicamente archivos de índice que se descargan en los equipos que ejecutan Lync 2010. Cuando un usuario busca contactos, busca en estos archivos de índice o en los archivos de índice de libreta de direcciones almacenados en el Almacén de administración central.

Los servidores de libreta de direcciones se rigen por las configuraciones de la libreta de direcciones; estas configuraciones determinan, por ejemplo, la frecuencia con la que los archivos de la libreta de direcciones se sincronizan con la base de datos de usuarios y la frecuencia con que se generan archivos de índice de la libreta de direcciones. Al instalar Lync Server 2010, se crea un conjunto de opciones de configuración globales de libreta de direcciones. También puede crear parámetros de configuración personalizados que se pueden aplicar a sitios individuales. Estas configuraciones, si existen, se aplican a cualquier servidor de libreta de direcciones que se emplee en el sitio y tienen prioridad por encima de la configuración global.

Puede usar el cmdlet Get-CsAddressBookConfiguration para devolver información acerca de cualquier configuración (o de todas ellas)) de la libreta de direcciones que esté en uso en su organización en ese momento.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsAddressBookConfiguration de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo), ejecute el siguiente comando desde el símbolo del sistema de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAddressBookConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la colección de configuraciones de libreta de direcciones que se va a devolver. Para hacer referencia a la configuración global, use la siguiente sintaxis: -Identity global. Para hacer referencia a una colección configurada en el ámbito de sitio, use la sintaxis siguiente: -Identity site:Redmond.

Tenga en cuenta que no se pueden utilizar comodines al especificar una Identidad. Si tiene que usar caracteres comodín, incluya, en su lugar, el parámetro Filter.

Si no define este parámetro, entonces Get-CsAddressBookConfiguration devolverá una colección de todas las configuraciones de libreta de direcciones que se estén utilizando en la organización.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín para devolver una colección (o varias) de configuraciones de la libreta de direcciones. Por ejemplo, para devolver una colección de todas las configuraciones definidas en el ámbito del sitio, use la sintaxis: -Filter site:*. Para devolver una colección de todas las configuraciones que tienen el valor de cadena de caracteres "EMEA" en alguna parte de la identidad, use esta sintaxis: -Filter *EUROPA*.

LocalStore

Opcional

Parámetro modificador

Recupera los datos de configuración de libreta de direcciones de la réplica local del Almacén de administración central, en lugar del Almacén de administración central en sí.

Tipos de entrada

Ninguno. Get-CsAddressBookConfiguration no acepta la entrada transferida.

Tipos de valores devueltos

Get-CsAddressBookConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Get-CsAddressBookConfiguration

En el ejemplo anterior se devuelve información acerca de todos los valores de configuración de libreta de direcciones de la organización. Se trata del comportamiento predeterminado si llama a Get-CsAddressBookConfiguration sin ningún parámetro adicional.

-------------------------- Ejemplo 2 --------------------------

Get-CsAddressBookConfiguration -Identity site:Redmond

En el ejemplo 2 se devuelve información para los valores de configuración de libreta de direcciones con la identidad site:Redmond.

-------------------------- Ejemplo 3 --------------------------

Get-CsAddressBookConfiguration -Filter site:*

En el ejemplo anterior, el parámetro Filter y el valor de filtro "site:*" se usan para devolver información acerca de todos los valores de configuración de libreta de direcciones que se han aplicado en el ámbito del sitio. El valor del filtro proporcionado devuelve información para todas las configuraciones de libreta de direcciones que tienen un parámetro Identity que comienza con el valor de cadena de caracteres "site:".

-------------------------- Ejemplo 4 --------------------------

Get-CsAddressBookConfiguration | Where-Object {$_.UseNormalizationRules -eq $True}

En el Ejemplo 4, se devuelve información para todos los valores de configuración de libreta de direcciones en los que se usen reglas de normalización al analizar números de teléfono. Para ello, en primer lugar el comando llama a Get-CsAddressBookConfiguration para devolver una colección de todas las configuraciones de libreta de direcciones de la organización. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona solo aquellas configuraciones en las que la propiedad UseNormalizationRules es igual a True.