Compartilhar via

  • Artigo

New-CsAddressBookConfiguration

 

Tópico modificado em: 2012-03-23

Cria uma nova coleção de definições de configuração de Catálogo de Endereços.

Sintaxe

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>]]

Descrição Detalhada

Servidores do Catálogo de Endereços são intermediários entre os AD DS e o Microsoft Lync Server 2010. O servidor do Catálogo de Endereços garante que as informações de usuário armazenadas no Lync Server 2010 estejam sincronizadas com as informações de usuário armazenadas nos AD DS. Para isso, os arquivos de Catálogo de Endereços são sincronizados periodicamente com as informações armazenadas no Banco de dados de usuários.

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

Os servidores de Catálogo de Endereços são governados pelas configurações de Catálogo de Endereços; essas configurações determinam coisas como a frequência com que esses arquivos são sincronizados com o banco de dados de usuários e com que frequência esses arquivos de índice são gerados. Quando você instala Lync Server, um conjunto de configurações globais do Catálogo de Endereços é criado para você. Você pode também criar configurações personalizadas que podem ser aplicadas a sites individuais. Estas configurações, se existirem, são aplicadas a quaisquer servidores de Catálogo de Endereços operando no site, e têm precedência sobre as configurações globais.

Configurações em nível de site são criadas com o cmdlet New-CsAddressBookConfiguration. Você pode criar configurações somente no escopo do site; se tentar criar novas configurações em qualquer outro lugar, incluindo no escopo global, seu comando irá falhar. Seu comando vai falhar também se o site em questão já tiver uma coleção de configurações do Catálogo de Endereços.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsAddressBookConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

Identificador exclusivo a ser atribuído à nova coleção de configurações do Catálogo de Endereços. Porque você pode somente criar novas coleções no escopo do site, a Identity vai sempre ser o prefixo "site:" seguida do nome do site; por exemplo "site:Redmond".

EnableFileGeneration

Opcional

Parâmetro de Opção

Quando definido como True (o valor padrão), o servidor de Catálogo de Endereços gera arquivos de índice do Catálogo de Endereços, que podem ser baixados pelos clientes. Quando definido como False, esses arquivos de índice não serão gerados. Isso significa que aplicativos cliente terão que usar o Serviço de Consulta à Web do Catálogo de Endereços para pesquisar por contatos.

IgnoreGenericRules

Opcional

Booleano

Indica se o servidor do Catálogo de Endereços vai ignorar as regras de normalização genéricas usadas na análise de números telefônicos. Regras genéricas são as regras que são criadas em Lync Server 2010. Estas regras não podem ser modificadas; no entanto, ao definir o valor desta propriedade para True, você pode instruir os seus servidores de Catálogo de Endereços a ignorarem estas regras, usando em seu lugar as regras personalizadas que você mesmo criar. O valor padrão é False.

KeepDuration

Opcional

Inteiro

Especifica o período de tempo (em dias) durante o qual os servidores do Catálogo de Endereços manterão os arquivos de alteração. Os arquivos de alteração mais antigos que o valor da propriedade KeepDuration serão excluídos. KeepDuration pode ser definido como qualquer número inteiro entre 1 e 90, inclusive. O valor padrão é 30 dias.

MaxDeltaFileSizePercentage

Opcional

Número inteiro

Quando alterações são feitas no Active Directory (assim como um novo usuário sendo habilitado para Lync Server) o servidor do Catálogo de Endereços tipicamente grava estas alterações em um "arquivo delta", um arquivo consistindo somente das informações atualizadas; Lync 2010 pode então baixar os arquivos delta ao invés de um arquivo do Catálogo de Endereços completo. A propriedade MaxDeltaFileSizePercentage determina o quão extensos os arquivos delta podem se tornar antes que eles sejam incorporados ao arquivo do Catálogos de Endereços completo. Por padrão, arquivos delta podem ser tão extensos quanto 20 por cento do arquivo do Catálogo de Endereços antes que um novo arquivo do Catálogo de Endereços seja gerado. Neste momento, clientes Lync vão baixar o arquivo completo ao invés do delta file.

MaxDeltaFileSizePercentage precisa ser entrado como um valor de porcentagem, de 1 a 100, inclusive.

RunTimeOfDay

Opcional

DateTime

Indica a hora do dia quando os servidores geram novos arquivos do Catálogo de Endereços. A propriedade RunTimeOfDay é baseada em um relógio de 24 horas (horas:minutos:segundos), com 00:00:00 representando meia-noite e 23:59:00 representando 11:59 P.M.

O valor padrão é 01:30:00 (1:30 A.M.).

SynchronizePollingInterval

Opcional

TimeSpan

Indica a frequência com que os servidores de Catálogo de Endereços sincronizam suas informações com as informações armazenadas no Banco de dados de usuários. SynchronizePollingInterval pode ser definido como qualquer valor entre 5 segundos (00:00:05) e 3 horas (03:00:00). O valor padrão é 5 minutos (00:05:00).

UseNormalizationRules

Opcional

Booleano

Indica se os servidores do Catálogo de Endereços devem usar regras de normalização de telefone quando recuperando números telefônicos. Se definido como False, números telefônicos vão ser recuperados como estão, e caberá ao aplicativo cliente aplicar as regras de normalização ao exibir esses números.

O valor padrão é True.

Force

Opcional

Parâmetros de Opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

InMemory

Opcional

Parâmetro de Opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma. New-CsAddressBookConfiguration não aceita entrada em pipeline.

Tipos de Retorno

Cria instâncias de objeto Microsoft.Rtc.Management.WritableConfig.Settings.AddressBook.AddressBookSettings.

Exemplo

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

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

O exemplo anterior cria uma nova coleção de configurações de Catálogo de Endereços com a identidade site:Redmond. Para criar uma nova coleção, chame o cmdlet New-CsAddressBookConfiguration junto com o parâmetro Identity e quaisquer outros parâmetros opcionais (por exemplo, os parâmetros KeepDuration e SynchronizePollingInterval).

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

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

O Exemplo 2 cria uma nova coleção de configurações do Catálogo de Endereços para o site Paris; esta nova coleção usa dois valores (KeepDuration e SynchronizePollingInterval) copiados das configurações do Catálogo de Endereços definidas para o site Redmond. Para realizar esta tarefa, o primeiro comando usa Get-CsAddressBookConfiguration para retornar uma coleção de todas as configurações de Catálogo de Endereços definidas para o site Redmond; essas informações são armazenadas em uma variável chamada $x.

O segundo comando então usa New-CsAddressBookConfiguration para criar configurações do Catálogo de Endereços do site Paris. Este comando inclui dois parâmetros opcionais — KeepDuration e SynchronizePollingInterval — que incluem valores copiados do site:Redmond. Por exemplo, KeepDuration utiliza o valor de parâmetro $x.KeepDuration; esse valor de parâmetro representa a informação de KeepDuration copiada do site Redmond.

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

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

Exemplo 3 mostra como você pode usar o parâmetro InMemory para criar uma instância somente em memória da coleção de configurações do Catálogo de Endereços, modificar estas configurações em memória, e então usar Set-CsAddressBookConfiguration para criar uma coleção de fato com a Identity site:Redmond. Para fazer tudo isso, o primeiro comando cria uma nova instância somente em memória das configurações do Catálogo de Endereços, armazenando esta instância em uma variável chamada $x. O parâmetro InMemory garante que estas configurações do Catálogo de Endereços vão existir somente em memória; se a sessão do Windows PowerShell for terminada ou se a variável $x for excluída, as configurações vão desaparecer e nunca serão aplicadas ao site Redmond.

Nos comandos 2 e 3, duas propriedades dessas configurações de Catálogo de Endereços "virtual" são alteradas: o comando 2 define o valor da propriedade KeepDuration como 15 dias, e o comando 3 define SynchronizePollingInterval como 10 minutos (00:10:00). O quarto e último comando então usa Set-CsAddressBookConfiguration e o parâmetro Instance para transformar as configurações virtuais do Catálogo de Endereços em uma verdadeira coleção de configurações, configurada no site Redmond.