Compartir a través de

  • Artículo

Move-CsExUmContact

 

Última modificación del tema: 2012-03-23

Mueve uno o más contactos de Mensajería unificada de Exchange (UM) a un nuevo grupo de registrador.

Sintaxis

Move-CsExUmContact -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Microsoft Lync Server 2010 funciona en combinación con Mensajería unificada de Exchange para ofrecer varias capacidades de voz, como operador automático y acceso de suscriptor. Move-CsExUmContact proporciona un modo de mover un objeto de contacto de Mensajería unificada de Exchange existente a un nuevo grupo de registrador. Los objetos de contacto se pueden mover de un grupo de Microsoft Office Communications Server 2007 o Microsoft Office Communications Server 2007 R2 a uno de Lync Server 2010, o bien de un grupo de Lync Server 2010 a otro. Con este cmdlet no se puede mover un objeto de contacto de Mensajería unificada de Exchange de un grupo de Lync Server 2010 a uno de Office Communications Server 2007 o de Office Communications Server 2007 R2.

Cuando un objeto de contacto de Mensajería unificada de Exchange se mueve, las propiedades AutoAttendant e IsSubscriberAccess se establecerán correctamente en función del valor de la propiedad OtherIpPhone de dicho objeto.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Move-CsExUmContact localmente: RTCUniversalUserAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

UserIdParameter

Identificador único del objeto de contacto que se quiere mover. Las identidades de contacto se pueden especificar con cuatro formatos: 1) La dirección SIP del contacto; 2) El nombre principal (UPN) del usuario del contacto; 3) el nombre de dominio y nombre de inicio de sesión del contacto con formato dominio\nombre (por ejemplo, litwareinc\exum1); y, 4) el nombre para mostrar de Active Directory del contacto (por ejemplo, Team Auto Attendant).

Target

Requerido

Fqdn

Nombre de dominio completo (FQDN) del grupo de registrador al que se va a mover el contacto.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

DomainController

Opcional

Fqdn

Permite conectarse al controlador de dominio especificado. Para conectarse a un controlador de dominio concreto, debe incluir el parámetro DomainController seguido del nombre del equipo (por ejemplo, atl-mcs-001) o su FQDN (por ejemplo, atl-mcs-001.litwareinc.com).

Force

Opcional

Parámetro modificador

Suprime los mensajes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios.

PassThru

Opcional

Parámetro modificador

Permite enviar un objeto de contacto a través de la canalización que representa la cuenta de contacto que se está moviendo. De manera predeterminada, el cmdlet Move-CsExUmContact no pasa objetos por la canalización.

ProxyPool

Opcional

Fqdn

Este parámetro se usa únicamente en relación con las instancias hospedadas de Lync Server. No debe usarse en una instalación interna de Lync Server.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Tipos de entrada

Cadena de caracteres. Acepta un valor de cadena transferida que representa la identidad de un objeto de Mensajería unificada de Exchange que se va a mover.

Tipos de valores devueltos

Cuando la llamada se realiza mediante el parámetro PassThru, se devuelve un objeto de tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

Move-CsExUmContact -Identity "sip:exum1@fabrikam.com" -Target atl-cs-001.litwareinc.com

En el ejemplo 1 se mueve el objeto de contacto de Mensajería unificada de Exchange con la dirección SIP exum1@fabrikam.com al grupo de registrador con el FQDN atl-cs-001.litwareinc.com. Tenga en cuenta que, cuando ejecute este comando, aparecerá un mensaje de confirmación, aun cuando no hayamos incluido el parámetro Confirm. Este mensaje se mostrará aunque incluya el parámetro Force.

-------------------------- Ejemplo 2 ------------------------

Get-CsExUmContact | Where-Object {$_.AutoAttendant -eq $True} | Move-CsExUmContact -Target atl-cs-001.litwareinc.com

En el ejemplo 2 se mueven todos los objetos de contacto de Mensajería unificada de Exchange que son operadores automáticos al grupo de registrador con el FQDN atl-cs-001.litwareinc.com. El ejemplo comienza con una llamada a Get-CsExUmContact, que recupera todos los contactos de Mensajería unificada de Exchange que se han definido. Esta colección de contactos se transfiere al cmdlet Where-Object, que busca todos los contactos de la colección que tengan el valor de la propiedad AutoAttendant establecido en True ($True), lo cual significa que el contacto es un operador automático.

Por último, la colección de contactos donde AutoAttendant es True se transfiere al cmdlet Move-CsExUmContact, que los mueve al grupo de registrador especificado en el parámetro Target.

Al igual que en el ejemplo 1, cuando ejecute este comando se le pedirá confirmación.