Update-AddressList

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2009-05-12

Utilice el cmdlet Update-AddressList para actualizar los destinatarios que se incluyen en la lista de direcciones que ha especificado.

Sintaxis

update-AddressList -Identity <AddressListIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Para ejecutar el cmdlet Update-AddressList, debe utilizar una cuenta en la que se delegue lo siguiente:

  • Función Administrador de la organización de Exchange

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.

Este comando puede tardar varias horas en completar, dependiendo del tamaño o de la organización de Exchange.

Parámetros

Parámetro Necesario Tipo Descripción

Identity

Necesario

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Utilice el parámetro Identity para especificar el GUID, el nombre distintivo o el nombre de lista de direcciones que represente una lista de direcciones concreta. También puede incluir la ruta con el formato Ruta\NombreListaDirecciones.

Puede omitir la etiqueta del parámetro Identity para que se facilite sólo el nombre de la lista de direcciones o el GUID.

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.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Este parámetro especifica el controlador de dominio a utilizar para realizar modificaciones a los destinatarios incluidos en esta lista de direcciones en Active Directory.

UseRusServer

Opcional

System.String

noteNota:
Este parámetro sólo está disponible en Exchange 2007 SP2.

El parámetro UseRusServer indica al comando que use el servidor de buzones especificado en el que se esté ejecutando el servicio Lista de direcciones para obtener y establecer los atributos del buzón y del usuario de Active Directory.

El servicio Lista de direcciones es un componente del servicio Operador de sistema de Exchange. El servicio Lista de direcciones crea y mantiene valores de atributo específicos de Exchange en Active Directory. El servicio Lista de direcciones se puede usar para actualizar objetos de destinatario de un dominio mediante el uso de información específica, como la pertenencia a una lista de direcciones y direcciones de correo electrónico. 

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

 

 

Excepciones

Excepciones Descripción

 

 

Ejemplo

El siguiente ejemplo muestra cómo actualizar los destinatarios de la lista de direcciones llamada "building4" y en el contenedor Todos los usuarios\Ventas.

Update-AddressList -Identity "All Users\Sales\building4"

Utilice el cmdlet Get-AddressList, canalizado a Lista de formato, para obtener el GUID, nombre completo o ruta y nombre de una lista de direcciones existente. O utilice Get-AddressList para obtener una lista de direcciones existentes específica y, a continuación, canalice el resultado directamente a Update-AddressList.