Compartilhar via


Get-CsUserReplicatorConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as definições de configuração do Replicador de usuários em uso na organização. 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.

Sintaxe

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

Get-CsUserReplicatorConfiguration [-Filter <String>] [-LocalStore <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 para esse usuário. Isso ocorre porque o Lync Server usa o nome de exibição já armazenado no Serviços de Domínio Active Directory (AD DS).

Obviamente, as informações de conta do usuário (incluindo 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 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 as suas próprias contas. Esta sincronização entre o Active Directory 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 a qual o replicador de usuários verificará as atualizações de contas de usuários no Active Directory. 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.

Se você estiver trabalhando com o Lync Online 2010, também poderá usar os cmdlets CsUserReplicatorConfiguration para criar e gerenciar as definições de configuração no escopo do serviço. No entanto, com a versão no local do Lync Server 2010, você está limitado a uma única coleção de definições de configuração, atribuída ao escopo global.

O cmdlet Get-CsUserReplicatorConfiguration permite aos administradores retornar informações sobre todas as definições do Replicador de usuários 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-CsUserReplicatorConfiguration 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 personalizada criada por você), execute o seguinte comando no prompt Windows PowerShell:

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

Parâmetros

Parameter Obrigatório Tipo Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo das definições de configuração do Replicador de usuários a serem retornadas. Para retornar as definições no escopo de serviço, utilize uma sintaxe semelhante a esta: -Identity "service:Registrar:atl-cs-001.litwareinc.com". Observe que as definições do escopo do serviço estarão disponíveis apenas se você estiver executando o Lync Online 2010. Para retornar as definições globais, use esta sintaxe: -Identity global. Se esse parâmetro não for especificado, serão retornadas todas as definições de configuração do Replicador de Usuário sendo usadas na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao se especificar a coleção (ou coleções) de definições de configuração do Replicador de usuários a ser retornada. Por exemplo, este comando retorna todas as definições configuradas no escopo de serviço: -Filter "service:*".

LocalStore

Opcional

Parâmetro de opção

Recupera os dados da configuração do Replicador de usuários 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-CsUserReplicatorConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsUserReplicatorConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserReplicator.UserReplicatorConfiguration.

Exemplo

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

Get-CsUserReplicatorConfiguration

O comando apresentado no Exemplo 1 retorna as informações sobre todas as definições de configuração do Replicador de usuários em uso na organização.