New-CsAddressBookConfiguration

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

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.

Consulte Também

Outros Recursos

Get-CsAddressBookConfiguration
Remove-CsAddressBookConfiguration
Set-CsAddressBookConfiguration