Move-CsUser
Tópico modificado em: 2012-03-23
Move uma ou mais contas de usuário habilitadas para o Microsoft Lync Server 2010 para um novo pool de Registrador.
Sintaxe
Move-CsUser -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O cmdlet Move-CsUser permite que você mova uma conta de usuário habilitada para o Lync Server 2010 de um pool de Registrador para outro. Move-CsUser afeta somente o local da conta de usuário no Lync Server; a conta do Active Directory do usuário não é movida para uma nova OU (unidade organizacional) ou um novo local.
Se o Lync Server coexistir com o Office Communications Server 2007 R2 ou o Office Communications Server 2007, o cmdlet Move-CsUser poderá ser usado para mover um usuário de volta do Lync Server para a instalação herdada do Office Communications Server. Para mover um usuário de volta para o Office Communications Server, atribua o FQDN (nome de domínio totalmente qualificado) do pool herdado ao parâmetro Target. Se fizer isso, tenha em mente que usuários movidos de volta para o Office Communications Server provavelmente perderão dados e funcionalidades; isso ocorre porque o Lync Server tem mais recursos do que o Office Communications Server 2007 e o Office Communications Server 2007 R2. Os usuários que forem movidos de volta também pode ter que instalar versões anteriores de seu software cliente, e ter que reagendar reuniões criadas quando suas contas de usuário eram hospedadas no Lync Server.
Para mover usuários do Communications Server 2007 ou do Communications Server 2007 R2 para o Lync Server, use o cmdlet Move-CsLegacyUser. Move-CsUser foi criado para mover usuários de um Lync Server para outro outro pool do Lync Server, ou para mover um usuário de um pool do Lync Server para um pool do Office Communications Server. Move-CsLegacyUser move usuários do Office Communications Server para o Lync Server.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Move-CsUser 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-CsUser"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
UserIdParameter |
Indica a identidade da conta de usuário a ser movida. 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 do usuário; 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 de exibição do 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 |
FQDN |
O FQDN (por exemplo, atl-cs-001.litwareinc.com) do pool de Registrador para o qual a conta de usuário deve ser movida. Além de um pool de Registrador, o Target pode ser também o FQDN de um Servidor Front-End do Office Communications Server herdado ou um provedor de hospedagem. Quaisquer contas movidas de um provedor de hospedagem (por exemplo, Microsoft Lync Online 2010) irão perder todos os dados de usuário associados. Por exemplo, conferências que o usuário tenha agendado serão excluídas e não estarão disponíveis no Lync Online 2010. |
DomainController |
Opcional |
Cadeia de caracteres |
Permite que você se conecte a um controlador de domínio especificado para recuperar informações de contato. 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). |
ProxyPool |
Opcional |
Cadeia de caracteres |
Este parâmetro é usado somente para o Microsoft Lync Online 2010. Não deve ser usado com uma implementação local do Lync Server. |
Force |
Opcional |
Parâmetro de opção |
Se presente, move a conta de usuário, mas exclui quaisquer dados de usuário associados (como conferências que o usuário tenha agendado). Se não estiver presente, tanto a conta quanto os dados associados serão movidos. |
PassThru |
Opcional |
Parâmetro 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-CsUser não passa objetos através do pipeline. |
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 |
Permite ignorar o prompt de confirmação que seria exibido na tentativa de mover um usuário. Para ignorar o prompt de confirmação, inclua o parâmetro Confirm usando esta sintaxe: -Confirm:$False Se preferir ter o prompt de confirmação, use esta sintaxe: -Confirm |
Tipos de Entrada
Cadeia de caracteres ou objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Move-CsUser aceita um valor de cadeia de caracteres em pipeline representando o parâmetro Identity de uma conta de usuário que tenha sido habilitada para o Lync Server. O cmdlet também aceita instâncias em pipeline do objeto de usuário do Active Directory.
Tipos de Retorno
Move-CsUser não retorna um valor ou objeto. Em vez disso, o cmdlet modifica instâncias do objeto do Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Exemplo
-------------------------- Exemplo 1 --------------------------
Move-CsUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com"
No exemplo anterior, Move-CsUser é usado para mover a conta de usuário com identidade igual a Pilar Ackerman para o pool do Registrador atl-cs-001.litwareinc.com.
-------------------------- Exemplo 2 --------------------------
Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Move-CsUser -Target "atl-cs-001.litwareinc.com"
No Exemplo 2, todas as contas de usuário na OU (unidade organizacional) Finance são movidas para o pool de Registrador atl-cs-001.litwareinc.com. 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 os dados serem recuperados, as informações são canalizadas para Move-CsUser, que então move cada conta da coleção para o pool de Registrador atl-cs-001.litwareinc.com.
-------------------------- Exemplo 3 --------------------------
Move-CsUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com" -Force
No exemplo anterior, Move-CsUser é usado para mover a conta de usuário com identidade igual a Pilar Ackerman para o pool do Registrador atl-cs-001.litwareinc.com. Além disso, o parâmetro Force é usado para garantir que apenas a conta propriamente dita seja movida; os dados de usuário associados à conta (como conferências que Pilar tenha agendado) não serão movidos, mas sim descartados. O parâmetro Force só deve ser usado se a tentativa de movimentação com Move-CsUser sem o parâmetro tiver falhado.