Move-CsUser
Última modificación del tema: 2012-03-23
Mueve una o más cuentas de usuario habilitadas para Microsoft Lync Server 2010 a un nuevo grupo de registrador.
Sintaxis
Move-CsUser -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El cmdlet Move-CsUser le permite mover una cuenta de usuario habilitada para Lync Server 2010 de un grupo de registradores a otro. Move-CsUser afecta únicamente a la ubicación de la cuenta de Lync Server del usuario; no mueve la cuenta de Active Directory del usuario a una nueva unidad organizativa (OU) ni a ninguna otra nueva ubicación.
Si Lync Server coexiste con Office Communications Server 2007 R2 o Office Communications Server 2007, el cmdlet Move-CsUser se puede usar para mover nuevamente un usuario desde Lync Server a la instalación tradicional o Office Communications Server. Para mover nuevamente a un usuario a Office Communications Server, asigne el nombre de dominio completo (FQDN) del grupo heredado al parámetro Target. Si lo hace, tenga en cuenta que los usuarios transferidos nuevamente a Office Communications Server posiblemente experimenten pérdida de funcionalidad y datos; esto se debe a que Lync Server tiene muchas más capacidades que Office Communications Server 2007 o Office Communications Server 2007 R2. Los usuarios que se mueven podrían necesitar instalar versiones anteriores del software cliente, y posiblemente deban reprogramar reuniones que se hayan creado cuando sus cuentas de usuario estaban alojadas en Lync Server.
Para mover usuarios de Communications Server 2007 o Communications Server 2007 R2 a Lync Server, use el cmdlet Move-CsLegacyUser. Move-CsUser está diseñado para mover usuarios de un Lync Server a otro grupo de Lync Server, o para mover un usuario de un grupo de Lync Server a un grupo de Office Communications Server. Move-CsLegacyUser mueve usuarios de Office Communications Server a Lync Server.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Move-CsUser localmente: RTCUniversalUserAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsUser"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
UserIdParameter |
Indica la identidad de la cuenta de usuario que se moverá. Las identidades de usuario pueden especificarse con cuatro formatos: 1) la dirección SIP del usuario; 2) el nombre principal del usuario (UPN); 3) el nombre del dominio y el nombre de inicio de sesión del usuario, con formato dominio\nombre (por ejemplo, litwareinc\kenmyer), y 4) el nombre para mostrar de Active Directory del usuario (por ejemplo, Ken Myer). También se puede hacer referencia a las identidades de usuario mediante el uso de un nombre distintivo de Active Directory del usuario. Puede usar el asterisco (*) como comodín al usar el Nombre para mostrar como identidad del usuario. Por ejemplo, la identidad "* Smith" devuelve todos los usuarios con un nombre para mostrar que termine con el valor de cadena de caracteres " Smith". |
Target |
Requerido |
FQDN |
El FQDN (por ejemplo, atl-cs-001.litwareinc.com) del grupo de registrador donde se moverá la cuenta de usuario. Además de un grupo de registrador, el destino también puede ser el FQDN de un Office Communications Server Servidor front-end heredado o un proveedor de hospedaje. Las cuentas movidas a un proveedor de alojamiento (por ejemplo, Microsoft Lync Online 2010) perderán todos sus datos de usuario asociados. Por ejemplo, las conferencias programadas del usuario se eliminarán y no estarán disponibles en Lync Online 2010. |
DomainController |
Opcional |
Cadena de caracteres |
Permite conectarse al controlador de dominio especificado para recuperar información de contactos. Para conectarse a un controlador de dominio específico, debe incluir el parámetro DomainController seguido del nombre del equipo (por ejemplo, atl-cs-001) o su FQDN (por ejemplo, atl-cs-001.litwareinc.com). |
ProxyPool |
Opcional |
Cadena de caracteres |
Este parámetro se usa solamente para Microsoft Lync Online 2010. No debe usarse en una instalación interna de Lync Server. |
Force |
Opcional |
Parámetro modificador |
Si se especifica, mueve la cuenta de usuario pero elimina los datos asociados (como conferencias que el usuario ha programado). Si no se especifica, se mueven la cuenta y los datos asociados. |
PassThru |
Opcional |
Parámetro modificador |
Le permite pasar un objeto de usuario por una canalización que representa la cuenta de usuario que se mueve. De manera predeterminada, el cmdlet Move-CsUser no pasa objetos por la canalización. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Permite desviar el aviso de confirmación que aparecería al intentar mover un usuario. Para desviar el aviso de confirmación, incluya el parámetro Confirm con esta sintaxis: -Confirm:$False Si prefiere tener un aviso de confirmación use esta sintaxis: -Confirm |
Tipos de entrada
Cadena u objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Move-CsUser acepta un valor de cadena canalizado que represente la identidad de una cuenta de usuario habilitada para Lync Server. El cmdlet también acepta entradas canalizadas del objeto de usuario de Active Directory.
Tipos de valores devueltos
Move-CsUser no devuelve un valor u objeto. En su lugar, el cmdlet modifica instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Move-CsUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com"
En el ejemplo anterior, Move-CsUser se usa para mover la cuenta de usuario con la identidad Pilar Ackerman al grupo de registrador atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 2 --------------------------
Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Move-CsUser -Target "atl-cs-001.litwareinc.com"
En el Ejemplo 2, todas las cuentas de usuario de la unidad organizativa Finance (OU) se mueven al grupo de registrador atl-cs-001.litwareinc.com. Para llevar a cabo esta tarea, primero el comando usa Get-CsUser y el parámetro de unidad organizativa (OU) para recuperar una recopilación de todas las cuentas de la OU Finance. Después de recuperar los datos, la información se canaliza a Move-CsUser, que mueve todas las cuentas de la recopilación al grupo de registrador atl-cs-001.litwareinc.com.
-------------------------- Ejemplo 3 --------------------------
Move-CsUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com" -Force
En el ejemplo anterior, Move-CsUser se usa para mover la cuenta de usuario con la identidad Pilar Ackerman al grupo de registrador atl-cs-001.litwareinc.com. Además, se usa el parámetro Force para garantizar que solo se mueve la cuenta; los datos de usuario asociados con la cuenta, como conferencias que Pilar ha programado, no se moverán, se descartará. El parámetro Force sólo debe usarse si se intentó llamar a Move-CsUser sin el parámetro y no se pudo realizar el movimiento.