Update-Recipient
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-07-18
Use el cmdlet Update-Recipient para agregar atributos de Microsoft Exchange Server 2007 a objetos de destinatario creados por el agente de administración de sincronización de listas globales de direcciones (GAL) en Identity Lifecycle Manager (ILM) 2007. Los objetos de destinatario que modifique con este cmdlet deben residir en un servidor de Exchange 2007.
Sintaxis
Update-Recipient -Identity <RecipientIdParameter> [-Confirm [<SwitchParameter>]] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Debido a fusiones o adquisiciones o a requisitos legales, los clientes puede que tengan necesidad de implementar Exchange en una topología de bosque de Exchange múltiple. Estas implementaciones requieren la sincronización de objetos de destinatario entre bosques dispares de servicios de directorio de Active Directory. Para obtener más información acerca de tipologías de bosques de Exchange múltiples, consulte Planear organizaciones de Exchange complejas.
Microsoft proporciona el agente de administración de sincronización GAL para sincronizar objetos de destinatario. La versión del agente de administración de sincronización GAL incluida en el Microsoft Identity Integration Server (MIIS) 2003 se diseñó para trabajar con Exchange Server 2003 y se basaba en el Servicio de actualización de destinatarios (RUS). Como RUS es una característica obsoleta y ha dejado de ser necesaria para Exchange 2007, el nuevo agente de sincronización GAL que se incluye en ILM 2007 está diseñado para funcionar sin RUS.
Como parte del proceso de sincronización, el ILM 2007 del agente de sincronización GAL crea objetos de destinatarios en ambos bosques Active Directory. Una vez creados los destinatarios, el agente de administración usa el cmdlet Update-Recipient para agregar los atributos que Exchange 2007 necesita para completar el aprovisionamiento de estos destinatarios.
Nota
Si usa MIIS 2003, debe ejecutar varios cmdlets para completar el proceso de aprovisionamiento de los contactos de correo creados por el agente de administración de sincronización GAL. Para obtener más información acerca de los contactos de correo de aprovisionamiento creados por MIIS 2003, consulte Cómo implementar Exchange 2007 en una topología entre bosques. El cmdlet Update-Recipient ofrece un método alternativo más eficiente para conseguirlo. Simplemente puede ejecutar el cmdlet Update-Recipient en los objetos de destinatario creados por el MIIS 2003 del agente de administración de sincronización GAL para completar su proceso de aprovisionamiento.
Para ejecutar el cmdlet Update-Recipient, debe usar una cuenta en la que se delegue lo siguiente:
- Función Administrador de destinatarios de Exchange
Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter |
El parámetro Identity identifica al destinatario. Puede usar uno de los siguientes valores:
|
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm. |
Credential |
Opcional |
System.Management.Automation.PSCredential |
El parámetro Credential especifica el nombre de usuario y la contraseña que se van a usar para obtener acceso a Active Directory. Si se usa el parámetro Credential, el comando le solicita la contraseña de la cuenta antes de continuar. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración Active Directory, incluya el parámetro DomainController del comando. |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
El parámetro Server especifica el servidor en el que realizar las operaciones seleccionadas. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
Ejemplo
El primer ejemplo muestra cómo usar el cmdlet Update-Recipient para agregar atributos Exchange 2007 al contacto de correo que representa el buzón para John Smith.
El segundo ejemplo muestra cómo actualizar todos los contactos en una unidad organizativa (OU) concreta. Este ejemplo supone que los destinatarios están sincronizados entre dos bosques, contoso.com y fabrikam.com, y que todos los destinatarios sincronizados del dominio fabrikam.com se almacenan en una OU específica denominada fabrikam.com Users en el dominio contoso.com.
Update-Recipient -Identity "John Smith"
Get-MailContact -OrganizationalUnit "contoso.com/fabrikam.com Users" | Update-Recipient