Compartilhar via

  • Artigo

Get-CsAddressBookConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as definiçoes de configuração do Catálogo de endereços.

Sintaxe

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

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

Descrição Detalhada

Os servidores do Catálogo de Endereços são intermediários entre o Serviços de Domínio Active Directory (AD DS) e o Microsoft Lync Server 2010. O servidor do Catálogo 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 Active Directory. Isso é feito sincronizando-se periodicamente 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 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 2010, cria-se um conjunto de definições globais de catálogos de endereços. É possível criar também 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.

É possível utilizar o cmdlet Get-CsAddressBookConfiguration para retornar informações sobre quaisquer (ou todas) as definições de catálogos de endereços em uso na organização.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsAddressBookConfiguration localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC criada por você), execute o seguinte comando no prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

Identificador exclusivo da coleção de definições de Catálogos de endereços a ser retornada. Para se referir às definições globais, utilize essa sintaxe: -Identity global. Para fazer referência a uma coleção configurada no escopo do site, use uma sintaxe semelhante a esta: -Identity site:Redmond.

Observe que não é possível utilizar caracteres curinga ao se especificar uma identidade. Se precisar utilizar caracteres curinga, inclua o parâmetro Filter no seu lugar.

Se esse parâmetro não for especificado, Get-CsAddressBookConfiguration retornará uma coleção de todas as definições de catálogos de endereços em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga para retornar uma coleção (ou coleções múltiplas) de definições de catálogos de endereços. Por exemplo, para retornar uma coleção de todas as definições configuradas no escopo do site, utilize esta sintaxe: -Filter site:*. Para retornar uma coleção de todas as configurações que tiverem um valor de cadeia de caracteres "EMEA" em alguma parte de sua Identity, use a sintaxe: -Filter *EMEA*.

LocalStore

Opcional

Parâmetro de opção

Recupera os dados da configuração do Catálogo de endereços na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsAddressBookConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsAddressBookConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Exemplo

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

Get-CsAddressBookConfiguration

O exemplo anterior retorna informações sobre todas as definições de configuração do Catálogo de endereços em uso na organização. Este é o comportamento padrão. se Get-CsAddressBookConfiguration for chamado sem quaisquer parâmetros adicionais.

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

Get-CsAddressBookConfiguration -Identity site:Redmond

O Exemplo 2 retorna informações sobre as definições de configuração do Catálogo de endereços cuja identidade for site:Redmond.

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

Get-CsAddressBookConfiguration -Filter site:*

No exemplo anterior, o parâmetro Filter e o valor de filtro "site:*" são utilizados para retornar informações sobre todas as definições de configuração do Catálogos de endereços que tiverem sido aplicadas no escopo de site. O filtro fornecido retorna informações para todas as definições do Catálogo de Endereços que tiverem uma identidade iniciada pelo valor da cadeia de caracteres "site:".

-------------------------- Exemplo 4 --------------------------

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

No Exemplo 4, retornam-se informações sobre todas as definições de configuração do Catálogo de endereços nas quais as definições utilizarem regras de normalização ao analisar números de telefone. Para fazer isso, o comando utiliza primeiramente Get-CsAddressBookConfiguration, para retornar uma coleção de todas as definições de catálogos de endereços na organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas as definições nas quais a propriedade UseNormalizationRules for igual a True.