• Artigo

Move-CsLegacyUser

 

Tópico modificado em: 2012-05-21

Migra uma ou mais contas de usuário do Microsoft Office Communications Server 2007 R2 ou do Microsoft Office Communications Server 2007 para o Microsoft Lync Server 2010.

Sintaxe

Move-CsLegacyUser -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExcludeArchivingPolicy <SwitchParameter>] [-ExcludeConferencingPolicy <SwitchParameter>] [-ExcludeDialPlan <SwitchParameter>] [-ExcludeExternalAccessPolicy <SwitchParameter>] [-ExcludePresencePolicy <SwitchParameter>] [-ExcludeVoicePolicy <SwitchParameter>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Muitas organizações que instalam o Lync Server 2010 também estão executando uma versão mais antiga do software (o Office Communications Server 2007 R2 ou o Office Communications Server 2007). Felizmente, isso não representa um problema: é possível executar simultaneamente a versão mais recente e uma versão mais antiga do software. Com o passar do tempo, você pode começar a migrar as configurações, diretivas e, por fim, as contas de usuário para o Lync Server 2010.

O cmdlet Move-CsLegacyUser não apenas permite a migração de usuários para o Lync Server 2010, como também oferece um controle considerável sobre o processo de migração. Por exemplo, em sua forma mais simples, você pode passar ao Move-CsLegacyUser a identidade do usuário a ser migrado e o FQDN (nome de domínio totalmente qualificado) do pool de Registrador do Lync Server 2010 no qual essa conta de usuário será hospedada; por sua vez, Move-CsLegacyUser irá mover a conta de usuário e manter as diretivas e configurações existentes que tenham sido aplicadas à conta. Vamos supor, por exemplo, que Ken Myer tenha sido atribuído a um plano de discagem no Office Communications Server. Por padrão, com a migração da conta de Ken, o plano de discagem dele também é migrado: isso quer dizer que Move-CsLegacyUser irá atribuir automaticamente a Ken Myer o equivalente do Lync Server 2010 ao plano de discagem atribuído a ele no Communications Server 2007 R2.

Obviamente, isso só vai acontecer se os planos de discagem tiverem sido migrados, e se houver um equivalente do Lync Server 2010 ao plano de discagem ao qual Ken Myer foi atribuído no Communications Server 2007 R2. Outra opção é instalar o Lync Server 2010 sem migrar os planos de discagem. Nesse caso, chame Move-CsLegacyUser junto com o parâmetro ExcludeDialPlan. Quando este parâmetro é usado, os planos de discagem não são migrados junto com a conta de usuário: ou seja, a conta de usuário de Ken Myer será movida para o Lync Server 2010, mas que nenhum plano de discagem será atribuído a ela (isso também acontece mesmo que o plano de discagem tenha sido migrado; os parâmetros ExcludeDialPlan impedem a atribuição da conta de usuário migrada a um plano de discagem). Outros parâmetros permitem excluir diretivas de voz, diretivas de conferência, diretivas de arquivamento, diretivas de acesso externo e/ou diretivas de presença ao migrar contas de usuário.

Para poder executar o Merge-CsLegacyTopology, primeiro instale o pacote de interfaces de Compatibilidade com Versões Anteriores do WMI; esse aplicativo é instalado executando o OCSWMIBC.msi (OCSWMIBC.msi pode ser encontrado no DVD de instalação, na pasta Setup). Depois de instalar o pacote de interfaces de Compatibilidade, Merge-CsLegacyUser pode ser chamado para mover uma ou mais contas de usuário do Communications Server 2007 R2 ou do Communications Server 2007 para o Lync Server 2010.

Se for necessário mover um usuário do Lync Server de volta para o Office Communications Server, não use o cmdlet Move-CsLegacyUser. Em vez disso, use o cmdlet Move-CsUser, e use o FQDN do pool herdado do Office Communications Server como valor do parâmetro Target de Move-CsUser. Por exemplo:

Move-CsUser –Identity "Ken Myer" –Target "ocs13.litwareinc.com"

Quem pode executar este cmdlet? Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Move-CsLegacyUser localmente: RTCUniversalUserAdmins. 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 "Move-CsLegacyUser"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Indica a Identidade da conta de usuário a ser migrada. As identidades de usuários podem ser especificadas usando um de quatro formatos: 1) O endereço SIP do usuário; 2) o nome UPN; 3) o nome de domínio do usuário e nome de logon, na forma domínio\logon (por exemplo, litwareinc\kenmyer); e, 4) o nome para exibição dos Serviços de Domínio Active Directory do usuário (por exemplo, Ken Myer). As Identidades de Usuário também podem ser referenciadas usando-se o nome diferenciado de usuário do Active Directory.

Você pode usar o caractere curinga asterisco (*) ao usar o nome para exibição como identidade do usuário. Por exemplo, a Identidade "* Smith" retorna todos os usuários com nome para exibição terminando com o valor de cadeia de caracteres " Smith".

Target

Obrigatório

Cadeia de caracteres

O FQDN do pool do Registrador onde a conta de usuário deve ser hospedada. Por exemplo: -Target atl-cs-001.litwareinc.com.

DomainController

Opcional

Cadeia de caracteres

Permite conectar ao controlador de domínio especificado para mover uma conta de usuário. Para se conectar a um determinado controlador de domínio, inclua o parâmetro DomainController seguido pelo nome do computador (por exemplo, atl-cs-001) ou por seu FQDN (por exemplo, atl-cs-001.litwareinc.com).

ExcludeArchivingPolicy

Opcional

Parâmetros de Opção

Quando presente, quaisquer diretivas de arquivamento atribuídas à conta de usuário não serão mantidas quando a conta for migrada.

ExcludeConferencingPolicy

Opcional

Parâmetros de Opção

Quando presente, quaisquer diretivas de conferência atribuídas à conta de usuário não serão mantidas quando a conta for migrada.

ExcludeDialPlan

Opcional

Parâmetros de Opção

Quando presente, quaisquer planos de discagem atribuídos à conta de usuário não serão mantidos quando a conta for migrada.

ExcludeExternalAccessPolicy

Opcional

Parâmetros de Opção

Quando presente, quaisquer diretivas de acesso externo atribuídas à conta de usuário não serão mantidas quando a conta for migrada.

ExcludePresencePolicy

Opcional

Parâmetros de Opção

Quando presente, quaisquer diretivas de presença atribuídas à conta de usuário não serão mantidas quando a conta for migrada.

ExcludeVoicePolicy

Opcional

Parâmetros de Opção

Quando presente, quaisquer diretivas de voz atribuídas à conta de usuário não serão mantidas quando a conta for migrada.

ProxyPool

Opcional

Cadeia de caracteres

Este parâmetro é usado somente com o Microsoft Lync Online 2010. Não deve ser usado com uma implementação local do Lync Server.

Force

Opcional

Parâmetros de Opção

Suprime a exibição de mensagens de erro não fatais que possam ser geradas pela execução do comando.

PassThru

Opcional

Parâmetros de Opção

Permite que você passe um objeto de usuário através do pipeline que representa a conta de usuário que está sendo movida. Por padrão, o cmdlet Move-CsLegacyUser não passa objetos pela pipeline.

WhatIf

Opcional

Parâmetros de Opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetros de Opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma. Move-CsLegacyUser não aceita entrada em pipeline.

Tipos de Retorno

Move-CsLegacyUser não retorna nenhum valor ou objeto. Em vez disso, o cmdlet move instâncias do objeto do Microsoft.Rtc.Management.ADConnect.Schema.ADUser.

Exemplo

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

Move-CsLegacyUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com"

No exemplo anterior, Move-CsLegacyUser é usado para migrar a conta de usuário com identidade igual a Pilar Ackerman para o pool do Registrador atl-cs-001.litwareinc. Como nenhum parâmetro adicional foi incluído, quaisquer diretivas ou configurações atribuídas anteriormente a esta conta também serão migradas. Isso significa que, se uma diretiva herdada (como um plano de discagem) tiver sido atribuída à usuária Pilar Ackerman, a diretiva equivalente do Lync Server 2010 será atribuída a ela quando sua conta for movida.

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

Move-CsLegacyUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com" -ExcludeDialPlan

O comando mostrado no Exemplo 2 migra a conta de usuário de Pilar Ackerman, mas não migra nenhum plano de discagem atribuído anteriormente a essa conta. Após a migração da conta, Pilar não terá nenhum plano de discagem atribuído a ela.

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

Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Move-CsLegacyUser -Target "atl-cs-001.litwareinc.com"

No Exemplo 3, todas as contas de usuário na OU Finance são movidas para o pool de registrador atl-cs-001.litwareinc.com do Lync Server. Para executar esta tarefa, o comando primeiro usa o Get-CsUser e o parâmetro OU para recuperar uma coleção de todas as contas de usuário na OU Finance. Após as contas serem recuperadas, a coleção é canalizada para Move-CsLegacyUser, que move cada conta para o novo pool de Registrador. Este comando presume que todos os usuários na OU Finance sejam usuários herdados.

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

Get-CsUser -UnassignedUser | Move-CsLegacyUser -Target "atl-cs-001.litwareinc.com"

No exemplo anterior, Move-CsLegacyUser é usado para atribuir um pool de Registrador a todos os usuários habilitados para o Lync Server que não estejam atribuídos atualmente a um pool de Registrador. Neste comando, o cmdlet Get-CsUser é chamado primeiro, junto com o parâmetro UnassignedUser, para retornar uma coleção de todos os usuários não atribuídos atualmente a um pool de registrador. Essa coleção é então canalizada para Move-CsLegacyUser que, por sua vez, atribui cada usuário ao pool atl-cs-001.litwareinc.com. Este exemplo presume que todos os usuários não atribuídos sejam usuários herdados.