Compartir a través de

  • Artículo

Remove-CsAddressBookConfiguration

 

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

Quita la colección especificada de opciones de configuración de libreta de direcciones.

Sintaxis

Remove-CsAddressBookConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Los servidores de libreta de direcciones son intermediarios entre AD DS y Microsoft Lync Server 2010. El servidor de 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. Con este fin, sincroniza 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 un contacto, puede buscar en los 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 libreta de direcciones; estas opciones de configuración determinan, por ejemplo, la frecuencia con la que los archivos de libreta de direcciones se sincronizan con la base de datos de usuarios y la frecuencia con que se generan archivos de índice de libreta de direcciones. Al instalar Lync Server, se crea automáticamente 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 opciones de configuración, si existen, se aplican a cualquier servidor de libreta de direcciones que se emplee en el sitio y tienen prioridad sobre la configuración global.

El cmdlet New-CsAddressBookConfiguration permite crear opciones de configuración de libreta de direcciones de nivel de sitio. Si posteriormente desea quitar las opciones de libreta de direcciones configuradas en el ámbito de sitio, utilice el cmdlet Remove-CsAddressBookConfiguration. Tenga en cuenta que también puede ejecutar Remove-CsAddressBookConfiguration con la configuración global, aunque realmente no es posible quitarla. En su lugar, al ejecutar Remove-CsAddressBookConfiguration con la configuración global, se restablecerán los valores predeterminados de todas las propiedades globales.

Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Remove-CsAddressBookConfiguration: 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 "Remove-CsAddressBookConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de la colección de opciones de configuración de libreta de dirección que se va a quitar. Para quitar la recopilación global, use la sintaxis siguiente: -Identity global. (Cuando se "quita" la configuración global, lo que se hace realmente es restablecer los valores predeterminados de todas las propiedades). Para quitar una colección de sitios, use una sintaxis similar a esta: -Identity site:Redmond. Tenga en cuenta que no puede usar caracteres comodín para especificar una identidad (Identity) de directiva.

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. Remove-CsAddressBookConfiguration acepta la entrada transferida de objetos de configuración de libreta de direcciones.

Tipos de valores devueltos

Remove-CsAddressBookConfiguration no devuelve un valor u objeto. En su lugar, el cmdlet quita las instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Ejemplo

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

Remove-CsAddressBookConfiguration -Identity site:Redmond

En este ejemplo, se usa Remove-CsAddressBookConfiguration para eliminar la configuración de libreta de direcciones con la identidad site:Redmond. Al usar el parámetro Identity, se garantiza que solo se quitará la configuración de libreta de direcciones especificada.

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

Get-CsAddressBookConfiguration -Filter site:* | Remove-CsAddressBookConfiguration

En el Ejemplo 2, se quitan todas las colecciones de opciones de configuración de libreta de dirección en el ámbito del sitio. Con este fin se usa el cmdlet Get-CsAddressBookConfiguration para recuperar una colección de todas las opciones de configuración de libreta de direcciones que se hayan definido en el ámbito del sitio. Para ello, se utiliza el parámetro Filter y el valor de filtro "site:*". A continuación, la colección recuperada se transfiere al cmdlet Remove-CsAddressBookConfiguration, que quita todos los elementos de la colección.

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

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

El comando anterior quita todas las opciones de configuración de libreta de direcciones cuyos archivos de cambios se conserven durante menos de 30 días. Para llevar a cabo esta tarea, se usa Get-CsAddressBookConfiguration para devolver una colección de todas las opciones de configuración de libreta de direcciones en uso en la organización. A continuación, esta colección se transfiere a Where-Object, que selecciona únicamente las opciones de configuración en las que la propiedad KeepDuration sea menor que 30 días. (Preste atención a la sintaxis: 30., con un punto tras el número de días.) Por último, la colección filtrada se transfiere a Remove-CsAddressBookConfiguration, que elimina todos los elementos incluidos en la colección.