Compartilhar via

  • Artigo

New-CsUserReplicatorConfiguration

 

Tópico modificado em: 2012-03-26

Cria uma nova coleção de definições de configuração do Replicador de usuários. O Replicador de usuários recupera periodicamente informações atualizadas da conta do usuário do Active Directory e sincroniza as novas informações com os dados atuais do usuário armazenados pelo Microsoft Lync Server 2010. Esse cmdlet é projetado para uso com o Microsoft Lync Online 2010 e não funcionará com a versão local do Lync Server 2010.

Sintaxe

New-CsUserReplicatorConfiguration -Identity <XdsIdentity> [-ADDomainNamingContextList <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-ReplicationCycleInterval <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Apesar de o Lync Server 2010 manter o seu próprio banco de dados de contas e dados de usuários, o Lync Server ainda se baseia no Active Directory como fonte mais recorrida às informações de usuários. Por exemplo: quando se cria uma nova conta de usuário no Active Directory, deve-se fornecer informações básicas sobre ela (como o nome de exibição no Active Directory). No entanto, quando um usuário for habilitado para o Lync Server, não será necessário especificar um novo nome de exibição. Isso ocorre porque o Lync Server 2010 usa o nome de exibição já armazenado no Active Directory.

As informações de conta de usuário, inclusive o nome de exibição no Active Directory, estarão sujeitas a alteração com o tempo. Por exemplo: uma usuária que se casar pode alterar o seu sobrenome e, por sua vez, pode também precisar alterar o seu nome de usuário. Para garantir que o banco de dados do Lync Server e o Active Directory permaneçam sincronizados, o Lync Server deve verificar periodicamente o Active Directory, recuperar as últimas atualizações de contas de usuários e modificar o banco de dados do usuário do Lync Server adequadamente. Esta sincronização entre o Active Directory e o Lync Server é realizada pelo Replicador de usuários.

Ao se instalar o Lync Server 2010, cria-se um conjunto global de definições de configuração do Replicador de usuários. Por padrão, essas definições são usadas para gerenciar o Replicador de usuários em toda a organização. O gerenciamento do Replicador de usuários consiste na identificação dos domínios com os quais o Lync Server necessita se sincronizar e na indicação da frequência com a qual o replicador de usuários verificará as atualizações de contas de usuários no Active Directory. É possível criar também coleções adicionais no escopo de serviço, mas somente se estiver trabalhando com Lync Online 2010.

As novas definições de configuração do Replicador de usuários são criadas usando-se o cmdlet New-CsUserReplicatorConfiguration. Observe que essas definições podem ser criadas apenas no escopo de serviço e apenas para Lync Online 2010. Não é possível criar novas definições do Replicador de usuários na versão local do Lync Server.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsUserReplicatorConfiguration: 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 (inclusive qualquer função RBAC personalizada criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo das definições de configuração do Replicador de usuários a serem criadas. As definições podem ser criadas apenas no escopo de serviço e apenas no serviço de Registrador. Isso significa que as novas definições terão uma Identidade semelhante a esta: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Observe que isso se aplica apenas ao Lync Online 2010.

ADDomainNamingContextList

Opcional

Modificador de Lista PS

Nomes diferenciados dos domínios do Active Directory com os quais o Replicador de usuários deverá se sincronizar. Por exemplo, para adicionar um domínio à lista, utilize uma sintaxe semelhante a esta:

-ADDomainNamingContextList @{Add="dc=fabrikam,dc=com"}

É possível adicionar mais de um nome de domínio ao se chamar New-CsUserReplicatorConfiguration. Para isso, basta separar os nomes de domínio usando uma vírgula:

-ADDomainNamingContextList @{Add="dc=fabrikam,dc=com",”dc=contoso,dc=com”}

Se essa propriedade for definida com um valor nulo, o replicador de usuários descobrirá e se sincronizará com todos os domínios disponíveis. Se essa propriedade não for nula, o replicador de usuários se sincronizará apenas com os domínios especificados em ADDomainNamingContextList.

ReplicationCycleInterval

Opcional

TimeSpan

Representa o tempo que o Replicador de usuários aguardará até verificar se há atualizações de contas de usuários no Active Directory. O intervalo do ciclo de replicação pode ser qualquer valor entre um segundo e 23 horas, 59 minutos e 59 segundos. O valor padrão é um minuto. O intervalo deve ser expresso utilizando-se o formato horas:minutos:segundos. Por exemplo, a sintaxe a seguir define o intervalo de tempo como sendo uma hora e 15 minutos: -ReplicationCycleInterval 01:15:00.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa surgir durante a 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-CsUserReplicatorConfiguration não aceita a entrada canalizada.

Tipos de Retorno

New-CsUserReplicatorConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration.

Exemplo

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

New-CsUserReplicatorConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"

O comando exibido no Exemplo 1 cria uma nova coleção de definições de configuração do Replicador de usuários do serviço Registrar:atl-cs-001.litwareinc.com. Como nenhum parâmetro adicional foi especificado, a nova coleção usará os valores do replicador de usuários padrão.

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

New-CsUserReplicatorConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com" -ADDomaiNamingContextList @{Add="dc=fabrikam,dc=com","dc=contoso.com"}

O Exemplo 2 cria uma nova coleção de definições de configuração do replicador de usuários para o serviço Registrar:atl-cs-001.litwareinc.com. No entanto, nesse caso, adiciona-se ADDomainNamingContextList, juntamente com os nomes diferenciados dos dois domínios a serem sincronizados: fabrikam.com e contoso.com. Essa nova coleção de definições de configuração do replicador de usuários irá configurar apenas esses dois domínios, mesmo se houver outros domínios disponíveis.