Compartilhar via

  • Artigo

Remove-CsAddressBookConfiguration

 

Tópico modificado em: 2012-03-26

Remove a coleção especificada de definições de configuração do Catálogo de endereços.

Sintaxe

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

Descrição Detalhada

Os servidores do Catálogo de endereços são intermediários entre o AD DS e o Microsoft Lync Server 2010. O servidor de Catálogos de endereços garante que as informações de usuários armazenadas no Lync Server 2010 estejam sincronizadas com as informações de usuários armazenadas no AD DS. Isso é feito sincronizando-se periodicamente os arquivos do Catálogo de endereços com as informações armazenadas no Banco de dados de usuários.

Além disso, os servidores do Catálogo de endereços periodicamente geram arquivos de índice, que são baixados para computadores que estiverem executando o Lync 2010. Quando um usuário procura contatos, ele pesquisa por esses arquivos de índice ou pesquisa nos arquivos de índice do Catálogo de endereços armazenados no Repositório de Gerenciamento Central.

Os servidores do Catálogo de endereços são governados usando-se as definições de configuração do Catálogo de endereços; essas definições determinam ações como a frequência com que os arquivos do Catálogo de endereços são sincronizados com o banco de dados de usuários e a frequência com que são gerados os arquivos de índice do Catálogo de endereços. Ao se instalar o Lync Server, cria-se um conjunto de definições globais de catálogos de endereços. Também é possível criar definições de configuração personalizadas, que podem ser aplicadas a sites específicos. Essas definições, se existirem, se aplicarão a quaisquer servidores de catálogos de endereços que estiverem em vigor no site e sempre têm precedência sobre as definições globais.

O cmdlet New-CsAddressBookConfiguration permite a criação de definições de configuração de Catálogos de Endereços no nível do site. Para remover qualquer definição de catálogos de endereços configuradas no escopo de site, utilize o cmdlet Remove-CsAddressBookConfiguration. Observe que também é possível executar Remove-CsAddressBookConfiguration concomitantemente às definições globais; no entanto, as definições globais não podem ser removidas. Em vez disso, a execução de Remove-CsAddressBookConfiguration em relação às definições globais redefinirá todas as propriedades globais para os seus valores padrão.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsAddressBookConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

XdsIdentity

Identificador exclusivo da coleção de definições de configuração de catálogos de endereços a ser removida. Para remover a coleção global, use a seguinte sintaxe: -Identity global. Quando as definições globais forem "removidas", redefina todas as propriedades para seus valores padrão. Para remover uma coleção de site, utilize uma sintaxe similar a esta: -Identity site:Redmond. Observe que não é possível utilizar caracteres curinga ao se especificar uma identidade de política.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings. Remove-CsAddressBookConfiguration aceita a entrada canalizada do objeto de configuração do catálogo de endereços.

Tipos de Retorno

Remove-CsAddressBookConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet remove instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Exemplo

-------------------------- Exemplo 1 --------------------------

Remove-CsAddressBookConfiguration -Identity site:Redmond

Nesse exemplo, Remove-CsAddressBookConfiguration é utilizado para excluir as definições de configuração de catálogos de endereços cuja identidade for site:Redmond. A utilização do parâmetro Identity garante a remoção apenas das definições de catálogos de endereços especificadas.

-------------------------- Exemplo 2 --------------------------

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

No Exemplo 2, serão removidas todas as coleções de definições do Catálogo de endereços configuradas no escopo de site. Para isso, o cmdlet Get-CsAddressBookConfiguration é usado para recuperar uma coleção de todas as definições de catálogos de endereços que tiverem sido configuradas no escopo de site; isso é feito usando-se o parâmetro Filter e o valor de filtro "site:*". A coleção recuperada será então canalizada para o cmdlet Remove-CsAddressBookConfiguration, que removerá todos os itens nessa coleção.

-------------------------- Exemplo 3 --------------------------

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

O comando anterior remove todas as definições de catálogos de endereços cujos arquivos de alterações forem mantidos por menos de 30 dias. Para realizar essa tarefa, utiliza-se Get-CsAddressBookConfiguration, para retornar uma coleção de todas as definições de catálogos de endereços em uso na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade KeepDuration for menor do que 30 dias. (observe a sintaxe: 30., com um ponto depois do número de dias). Finalmente, a coleção filtrada será canalizada para Remove-CsAddressBookConfiguration, que excluirá cada item nessa coleção.