Compartilhar via

  • Artigo

Set-CsUserReplicatorConfiguration

 

Tópico modificado em: 2012-03-25

Modifica uma coleção existente 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 Serviços de Domínio Active Directory (AD DS) e sincroniza as novas informações com os dados do usuário atual, armazenados pelo Microsoft Lync Server 2010.

Sintaxe

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

Set-CsUserReplicatorConfiguration [-ADDomainNamingContextList <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 2010 ainda se baseia no AD DS 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 para exibição. Isso ocorre porque o Lync Server usa o nome para exibição já armazenado no AD DS.

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 seu sobrenome e, por sua vez, pode também precisar alterar seu nome de usuário. Para garantir que o banco de dados do Lync Server e o AD DS permaneçam sincronizados, o Lync Server deve verificar periodicamente o AD DS, recuperar as últimas atualizações de contas de usuários e modificar os bancos de dados de usuários do Lync Server. Esta sincronização entre o AD DS e o Lync Server é realizada pelo Replicador de usuários.

Ao se instalar o Lync Server, 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 que o Replicador de usuários verificará as atualizações de contas de usuários no AD DS. Por padrão, o Replicador de usuários descobre e se sincroniza com todos os domínios disponíveis. No entanto, ao se usar a propriedade AdDomainNamingContextList, é possível restringir a sincronização a um conjunto específico de domínios: os domínios que aparecem na propriedade AdDomainNamingContextList.

É possível criar também coleções adicionais no escopo de serviço, mas somente se estiver trabalhando com Microsoft Lync Online 2010.

O cmdlet Set-CsUserReplicatorConfiguration permite modificar quaisquer das definições do Replicador de usuários em uso na organização. É possível utilizar este cmdlet para adicionar ou remover domínios da lista de domínios com que o Replicador de usuários deve se sincronizar e para modificar o intervalo de tempo entre os ciclos de replicação.

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

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo das definições de configuração do Replicador de usuários a ser modificado. Para modificar as definições globais, use a sintaxe a seguir: -Identity global.

Instance

Opcional

Objeto UserReplicatorConfiguration

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

ADDomainNamingContextList

Opcional

Modificador de Lista PS

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

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

Se essa propriedade for definida com o valor null, o Replicador de usuários descobrirá e se sincronizará com todos os domínios disponíveis. Se essa propriedade não for null, 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á antes de verificar se há atualizações da conta do usuário no AD DS. 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 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.UserReplicator.UserReplicatorConfiguration. Set-CsUserReplicatorConfiguration aceita a entrada canalizada do objeto de configuração do Replicador de usuários.

Tipos de Retorno

Set-CsUserReplicatorConfiguration não retorna qualquer objeto ou valor. Em vez disso, o cmdlet modifica a instância global (a única instância desse tipo) do objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration.

Exemplo

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

Set-CsUserReplicatorConfiguration -Identity global -ReplicationCycleInterval "00:05:00"

O comando anterior define o valor de ReplicationCycleInterval das definições globais do Replicador de usuários como cinco minutos (00 horas: 05 minutos: 00 segundos).

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

Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList $Null

O comando exibido no Exemplo 2 limpa o valor da propriedade ADDomainNamingContextList. Esta tarefa é realizada pela inclusão do parâmetro ADDomainNamingContextList e pela definição do valor do parâmetro como null. Ao definir esse valor como null, o Replicador de usuários descobrirá e se sincronizará automaticamente com todos os domínios disponíveis.

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

Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList @{Add="dc=fabrikam,dc=com"}

No Exemplo 3, um nome adicional é incluído à propriedade ADDomainNamingContextList das definições globais do Replicador de usuários. Para fazer isso, utiliza-se a sintaxe @{Add=}, juntamente com o nome diferenciado do domínio sendo adicionado. Quando este comando for executado, fabrikam.com será adicionado à lista de nomes de domínio. Para configurar os parâmetros globais, de modo a apresentar uma lista onde conste somente fabrikam.com, utilize a seguinte sintaxe:

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

Quando a propriedade AdDomainNamingContextList estiver definida com qualquer valor diferente de um valor nulo, o Replicador de usuários se sincronizará apenas com os domínios listados no valor da propriedade. Isso ocorrerá mesmo se houver outros domínios na implantação.

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

Set-CsUserReplicatorConfiguration -Identity global -ADDomainNamingContextList @{Remove="dc=fabrikam,dc=com"}

O Exemplo 4 remove o domínio fabrikam.com da propriedade ADDomainNamingContextList das definições globais do Replicador de usuários. Para fazer isso, utiliza-se a sintaxe @{Remove=}, juntamente com o nome diferenciado (DN) do domínio (dc=fabrikam,dc=com).