Compartir a través de

  • Artículo

New-CsAddressBookConfiguration

 

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

Crea una nueva recopilación de opciones de configuración de Libreta de direcciones.

Sintaxis

New-CsAddressBookConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableFileGeneration <$true | $false>] [-Force <SwitchParameter>] [-IgnoreGenericRules <$true | $false>] [-InMemory <SwitchParameter>] [-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. Esta tarea se realiza periódicamente mediante la sincronización de los archivos de la libreta de direcciones con 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 ya sea a través de estos archivos de índice o en los archivos de índice de la libreta de direcciones almacenados en el Almacén de administración central.

Los servidores de libreta de direcciones se rigen por las opciones de configuración de la libreta de direcciones; dicha configuración determina aspectos como con qué frecuencia se sincronizan los archivos de libreta de direcciones con la base de datos del usuario y con qué frecuencia se generan los archivos de índice de libreta de direcciones. Cuando instala Lync Server, se crea, para usted, un conjunto de configuraciones globales de Libreta de direcciones. También puede crear valores de configuración personalizados que se pueden aplicar a sitios individuales. Esta configuración, si existe, se aplica a cualquier servidor de libreta de direcciones que se emplee en el sitio, y siempre tienen prioridad por encima de la configuración global.

La configuración de nivel del sitio se crean mediante el uso del cmdlet New-CsAddressBookConfiguration. Solo puede crear configuraciones en el ámbito del sitio; si intenta crear configuraciones nuevas en cualquier otro lado, incluyendo en el ámbito global, se producirá un error en el comando. El comando también producirá errores si el sitio en cuestión ya contiene una recopilación de configuraciones de la Libreta de direcciones.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsAddressBookConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Único identificador que se va a asignar a la recopilación nueva de las configuraciones de la Libreta de direcciones. Como solo puede crear nuevas recopilaciones en el ámbito del sitio, la Identidad siempre será el prefijo "site:" seguido del nombre del sitio; por ejemplo, "site:Redmond".

EnableFileGeneration

Opcional

Parámetro modificador

Cuando está establecido en True (el valor predeterminado) la Libreta de direcciones genera archivos de índice de libreta de direcciones que los clientes pueden descargar. Cuando está establecido en False, estos archivos de índice no se generan. Eso significa que las aplicaciones cliente deberán usar el Servicio de consulta web de libreta de direcciones al buscar 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, o no. Las reglas genéricas son las reglas que están integradas 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 deben omitir estas reglas, y en su lugar, usar las reglas personalizadas creadas por usted. El valor predeterminado es False.

KeepDuration

Opcional

Entero

Especifica la cantidad de tiempo (en días) que los servidores de Libreta de direcciones mantendrán los archivos de cambios. Se eliminarán los archivos cambiados más antiguos que el valor de la propiedad KeepDuration. KeepDuration se puede establecer con cualquier valor entero comprendido entre 1 y 90 inclusive. El valor predeterminado es 30 días.

MaxDeltaFileSizePercentage

Opcional

Integer

Cuando se realizan cambios en Active Directory (como ser un usuario nuevo que se habilita para Lync Server), el servidor de Libreta de direcciones generalmente registra estos cambios en un "archivo delta", un archivo que solamente contiene información actualizada; luego, Lync 2010 puede descargar ,los archivos delta en lugar de un archivo completo de la Libreta de direcciones. La propiedad MaxDeltaFileSizePercentage determina cuán grande pueden llegar a ser los archivos delta antes que se incorporen en el archivo completo de la Libreta de direcciones. De manera predeterminada, los archivos delta pueden ser tan grandes como el 20 por ciento del archivo completo de la Libreta de direcciones antes de que se genere un archivo de la Libreta de direcciones nuevo. Llegado este momento, los clientes de Lync descargarán el archivo completo en vez de un archivo delta.

MaxDeltaFileSizePercentage se debe escribir como un valor de porcentaje, de 1 a 100 inclusive.

RunTimeOfDay

Opcional

DateTime

Indica el momento del día en que los servidores generan archivos nuevos de la 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 PM.

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

SynchronizePollingInterval

Opcional

TimeSpan

Indica la frecuencia con la que los servidores de libreta de direcciones sincronizan la información con la información almacenada en el Base de datos de usuarios. SynchronizePollingInterval se puede establecer en 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 usar reglas de normalización de teléfonos al recuperar 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 producirse al ejecutar el comando.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

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

Ninguno. New-CsAddressBookConfiguration no acepta entradas canalizadas.

Tipos de valores devueltos

Crea instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Ejemplo

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

New-CsAddressBookConfiguration -Identity site:Redmond -KeepDuration 15 -SynchronizePollingInterval 00:10:00

El ejemplo anterior crea una recopilación nueva de opciones de configuración de Libreta de direcciones con la identidad site:Redmond. Para crear la recopilación, usted debe llamar al cmdlet New-CsAddressBookConfiguration junto con el parámetro Identity y cualquier otro parámetro opcional (por ejemplo, los parámetros KeepDuration y SynchronizePollingInterval).

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

$x = Get-CsAddressBookConfiguration -Identity site:Redmond
New-CsAddressBookConfiguration -Identity site:Paris -KeepDuration $x.KeepDuration -SynchronizePollingInterval $x.SynchronizePollingInterval

En el ejemplo 2 se crea una recopilación nueva de las configuraciones de la Libreta de direcciones para site:Paris; esta recopilación nueva usa dos valores (KeepDuration y SynchronizePollingInterval) copiados de las configuraciones de libreta de direcciones establecidas para el conjunto Redmond. Para llevar a cabo esta tarea, el primer comando usa Get-CsAddressBookConfiguration para devolver una recopilación de todos las configuraciones de la Libreta de direcciones establecida para sitio Redmond; esta información se almacena en una variable denominada $x.

El segundo comando usa New-CsAddressBookConfiguration para crear las configuraciones de la Libreta de direcciones para sitio Paris. Este comando incluye dos parámetros opcionales, KeepDuration y SynchronizePollingInterval, que incluyen valores copiados de site:Redmond. Por ejemplo, KeepDuration usa el valor de parámetro $x.KeepDuration; ese valor de parámetro representa la información de KeepDuration copiada desde el sitio Redmond.

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

$x = New-CsAddressBookConfiguration -Identity site:Redmond -InMemory
$x.KeepDuration = 15
$x.SynchronizePollingInterval = "00:10:00"
Set-CsAddressBookConfiguration -Instance $x

En el Ejemplo 3 se muestra cómo puede usar el parámetro InMemory para crear una instancia solo en la memoria de una recopilación de configuraciones de la Libreta de direcciones, modificar esas configuraciones en la memoria y, luego, usar Set-CsAddressBookConfiguration para crear una recopilación real con el valor de Identity site:Redmond. Para lograr todo eso, el primer comando crea una instancia únicamente en la memoria de una configuración de valores de la Libreta de direcciones y almacena esa instancia en una variable denominada $x. El parámetro InMemory garantiza que estas configuraciones de la Libreta de direcciones solo existan en la memoria. Si usted estaba por finalizar la sesión de Windows PowerShell o eliminar la variable $x, las configuraciones desaparecerán y no se aplicarán al sitio Redmond.

En los comandos 2 y 3, se modifican dos propiedades de estas configuraciones virtuales de la Libreta de direcciones: el comando 2 establece el valor de la propiedad KeepDuration en 15 días y el comando 3 establece la propiedad SynchronizePollingInterval en 10 minutos (00:10:00). Luego, el cuarto y último comando usa Set-CsAddressBookConfiguration y el parámetro Instance para transformar las configuraciones virtuales de la Libreta de direcciones en una recopilación de configuración real establecida en el sitio Redmond.