Move-CsApplicationEndpoint
Última modificación del tema: 2012-03-23
Mueve un extremo a un grupo de registrador diferente.
Sintaxis
Move-CsApplicationEndpoint -Identity <UserIdParameter> -TargetApplicationPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Este cmdlet mueve un objeto de contacto de extremo existente en Active Directory Domain Services (AD DS) de un grupo de aplicaciones de Microsoft Office Communications Server 2007 R2 hacia un grupo de aplicaciones de Microsoft Lync Server 2010, o desde un grupo de aplicaciones de Lync Server 2010 hacia otro. La aplicación asociada con el extremo determinado debe existir en el grupo de servidores de destino. Para determinar qué aplicación está asociada con el extremo, ejecute el cmdlet Get-CsTrustedApplicationEndpoint o el cmdlet Get-CsDialInConferencingAccessNumber.
Este cmdlet además se usa para actualizar las propiedades del objeto de contacto de Active Directory cuando una aplicación implementada de Office Communications Server 2007 R2 se redestina en Lync Server 2010. Tenga en cuenta que, en este caso, el grupo de aplicaciones de origen y de destino será el mismo. Además, si una aplicación diseñada originalmente para trabajar con Office Communications Server 2007 R2 es implementada directamente con Lync Server 2010, entonces se deberá usar este cmdlet con la marca Force para actualizar las propiedades del objeto de contacto de Active Directory.
Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Move-CsApplicationEndpoint en forma local: 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-CsApplicationEndpoint"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Parámetro PrimaryUri |
La dirección SIP o el nombre distintivo (DN) del contacto de extremo que desea mover. |
TargetApplicationPool |
Requerido |
Fqdn |
El nombre de dominio completo (FQDN) del grupo de servidores al que se moverá el extremo. El grupo de servidores de destino debe tener una dependencia de servicio registrador. |
DomainController |
Opcional |
Fqdn |
Le permite especificar un controlador de dominio. Si no se especifica ningún controlador de dominio, se usará el primero que esté disponible. |
Force |
Opcional |
Parámetro modificador |
Es necesario contar con esta marca si mueve un objeto de contacto de Microsoft Unified Communications Managed API (UCMA) 2,0 hasta el mismo grupo, pero en una implementación de Lync Server 2010. De este modo, forzará el enrutamiento para que ocurra mediante el registrador de Lync Server 2010. |
PassThru |
Opcional |
Parámetro modificador |
Si se especifica este parámetro, se devolverá el objeto de extremo de aplicación una vez que se haya movido. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Cadena de caracteres. Acepta un valor de cadena canalizado que representa la identidad de un extremo de la aplicación.
Tipos de valores devueltos
Cuando se usa con el parámetro PassThru, devuelve un objeto de tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint1@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com
En este ejemplo, el objeto de contacto del extremo de la aplicación con la dirección SIP endpoint1@litwareinc.com se transfiere hacia el grupo de registrador de confianza TrustPoolA.litwareinc.com. Use este comando para actualizar una aplicación UCMA 2,0 a una aplicación Microsoft Unified Communications Managed API (UCMA) 3.0 después de coexistir.
-------------------------- Ejemplo 2 ------------------------
Move-CsApplicationEndpoint -Identity sip:endpoint2@litwareinc.com -TargetApplicationPool TrustPoolA.litwareinc.com -Force
En este ejemplo, el objeto de contacto del extremo de la aplicación con la dirección SIP endpoint2@litwareinc.com se transfiere hacia el grupo del registrador de confianza TrustPoolA.litwareinc.com. La diferencia de este ejemplo con el ejemplo 1 es que este comando contiene el parámetro Force. Use este comando para realizar una migración en contexto de una aplicación de UCMA 2,0 o para realizar una implementación directa de una aplicación de UCMA 2,0 contra una implementación pura de Lync Server 2010. De este modo, se actualizará el objeto existente en Active Directory con los atributos necesarios de manera que se pueda realizar en enrutamiento mediante el registrador de Lync Server 2010.