Compartir a través de

  • Artículo

Set-CsAddressBookConfiguration

 

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

Modifica una colección existente de configuraciones de libreta de direcciones.

Sintaxis

Set-CsAddressBookConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsAddressBookConfiguration [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-Instance <PSObject>] [-KeepDuration <UInt32>] [-MaxDeltaFileSizePercentage <UInt32>] [-RunTimeOfDay <DateTime>] [-SynchronizePollingInterval <TimeSpan>] [-UseNormalizationRules <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Los servidores de libreta de direcciones son intermediarios entre AD DS y Microsoft Lync Server 2010. El servidor de la libreta de direcciones garantiza que la información del usuario almacenada en Lync Server 2010 esté sincronizada con la información del usuario almacenada en AD DS. Lo hace sincronizando periódicamente los archivos de la 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 un contacto, puede buscar en los archivos de índice o en los archivos de índice de la libreta de direcciones almacenados en 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, se crea un conjunto de opciones de configuración globales de libreta de direcciones. También puede crear opciones de configuración personalizadas que pueden aplicarse 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.

El cmdlet Set-CsAddressBookConfiguration permite modificar cualquiera de las colecciones de configuraciones de la libreta de direcciones que estén en uso en la organización.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsAddressBookConfiguration de forma local: 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 (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único asignado a la colección de opciones de configuración de la libreta de direcciones. 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. No se pueden usar caracteres comodín al especificar una Identidad.

Si se omite este parámetro, Set-CsAddressBookConfiguration modificará la configuración global.

Instance

Requerido

Objeto AddressBookSettings

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

EnableFileGeneration

Opcional

Parámetro modificador

Si está en True (el valor predeterminado) el servidor de libreta de direcciones genera archivos de índice de libreta de direcciones que los clientes se pueden descargar. Si está en False, no se generan los archivos de índice. Por tanto, las aplicaciones cliente tendrán que utilizar el Servicio de consulta web de libreta de direcciones para la búsqueda de contactos.

IgnoreGenericRules

Opcional

Booleano

Indica si el servidor de libreta de direcciones ignora la normalización de reglas genéricas que se usan al analizar números de teléfono. Las reglas genéricas son las reglas que se integran en Lync Server 2010. Estas reglas no se pueden cambiar; sin embargo, si establece el valor de esta propiedad en True, puede indicar a los servidores de libretas de direcciones que ignoren estas reglas y que, en lugar de eso, usen las reglas personalizadas creadas por usted. El valor predeterminado es False.

KeepDuration

Opcional

TimeSpan

Especifica la cantidad de tiempo (en días) que los servidores de libreta de direcciones conservan los archivos de cambios. Los archivos de cambios cuya antigüedad supere el valor de la propiedad KeepDuration se eliminarán. Este parámetro se puede configurar con cualquier valor entero comprendido entre 1 y 90 inclusive. El valor predeterminado es 30 días.

MaxDeltaFileSizePercentage

Opcional

Entero

Cuando se realizan cambios en Active Directory (por ejemplo, se habilita un nuevo usuario para Lync Server), el servidor de libreta de direcciones suele registrar estos cambios en un "archivo delta" que contiene únicamente la información actualizada; a continuación, Lync 2010 puede descargar los archivos delta en vez de todo el archivo de la libreta de direcciones. La propiedad MaxDeltaFileSizePercentage determina el tamaño que pueden alcanzar los archivos delta antes de incorporarlos en el archivo completo de la libreta de direcciones. De forma predeterminada, los archivos delta pueden llegar a alcanzar un tamaño equivalente al 20% de todo el archivo de la libreta de direcciones antes de que se genere un nuevo archivo de libreta de direcciones. Llegado este momento, los clientes de Lync descargarán el archivo completo en vez de un archivo delta.

MaxDeltaFileSizePercentage se debe indicar mediante un valor porcentual comprendido entre 1 y 100, ambos incluidos.

RunTimeOfDay

Opcional

DateTime

Indica la hora del día a la que los servidores generan nuevos archivos de libreta de direcciones. La propiedad RunTimeOfDay se basa en un reloj de 24 horas (horas:minutos:segundos); 00:00:00 representa la media noche, y 23:59:00, las 11:59 p.m.

El valor predeterminado es 01:30:00 (1:30 a.m.).

SynchronizePollingInterval

Opcional

TimeSpan

Indica cuán seguido los servidores de libreta de direcciones sincronizan su información con la información almacenada en la Base de datos de usuarios. Para SynchronizePollingInterval se puede definir cualquier valor entre 5 segundos (00:00:05) y 3 horas (03:00:00). El valor predeterminado es 5 minutos (00:05:00).

UseNormalizationRules

Opcional

Booleano

Indica si los servidores de libreta de direcciones deberían utilizar reglas de normalización telefónica cuando recuperen números de teléfono. Si se establece en False, los números de teléfono se recuperan tal cual, y será la aplicación del cliente la que decidirá si se aplicarán reglas de normalización cuando se muestren estos números.

El valor predeterminado es True.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir al ejecutar el comando.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings. Set-CsAddressBookConfiguration acepta la entrada transferida de objetos de configuración de la libreta de direcciones.

Tipos de valores devueltos

Set-CsAddressBookConfiguration no devuelve ningún valor ni objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Ejemplo

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

Set-CsAddressBookConfiguration -identity site:Redmond -RunTimeOfDay 23:00

En este ejemplo se establece la propiedad RunTimeOfDay (que determina la hora del día a la que se sincroniza la libreta de direcciones) en las 23:00 (11:00 PM en un reloj en formato de 24 horas). El parámetro Identity se usa para limitar el cambio a la configuración de la libreta de direcciones con la identidad site:Redmond.

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

Get-CsAddressBookConfiguration -Filter site:* | Set-CsAddressBookConfiguration -RunTimeOfDay 23:00

En el Ejemplo 2, la propiedad RunTimeOfDay se ha establecido en 11:00 PM (23:00) para todos las colecciones de configuraciones de libreta de direcciones definidas en el ámbito de sitio. Para ello, en primer lugar el comando usa Get-CsAddressBookConfiguration y el parámetro Filter para devolver una colección de todas las configuraciones específicas del sitio; el valor de filtro "site:*" limita los datos devueltos a colecciones configuradas en el ámbito de sitio. A continuación, esta información se transfiere a Set-CsAddressBookConfiguration, que modifica el valor de la propiedad RunTimeOfDay para cada elemento de la colección.

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

Get-CsAddressBookConfiguration | Where-Object {$_.KeepDuration -lt 30} | Set-CsAddressBookConfiguration -KeepDuration 30

El comando anterior modifica la propiedad KeepDuration de cualquier colección de configuraciones de libreta de direcciones para el que KeepDuration sea inferior a 30 días. Para llevar a cabo esta tarea, se usa Get-CsAddressBookConfiguration sin parámetros adicionales para devolver una colección de todas las configuraciones de libreta de direcciones que se vayan a usar en la organización. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona únicamente las configuraciones en las que la propiedad KeepDuration sea menor que 30 días. A continuación, la colección filtrada se transfiere a Set-CsAddressBookConfiguration, que modifica el valor de la propiedad KeepDuration a 30 días para cada elemento.