Set-AddressList (RTM)

Artículo
06/26/2014

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-10-23

Utilice el cmdlet Set-AddressList para modificar una lista de direcciones específica.

Sintaxis

Set-AddressList -Identity <AddressListIdParameter> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>]

Set-AddressList [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>]

Descripción detallada

Para ejecutar el cmdlet Set-AddressList, se 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 Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Si desea utilizar la Consola de administración de Exchange para administrar listas de direcciones creadas en Exchange Server 2003 o Exchange 2000 Server, debe hacer lo siguiente:

Actualizar el atributo de versión de la lista de direcciones mediante el parámetro ForceUpgrade.
Cambiar el filtro de destinatarios mediante el parámetro RecipientFilter o mediante uno de los siguientes parámetros de filtro:
- ConditionalCompany
- ConditionalDepartment
- ConditionalStateOrProvince
- IncludedRecipients

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 la lista de direcciones que representa una lista de direcciones específica. También puede incluir la ruta con el formato Ruta\NombreListaDirecciones. Puede omitir la etiqueta del parámetro Identity para que únicamente se facilite el nombre de la lista de direcciones o el GUID.
ConditionalCompany	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	El parámetro ConditionalCompany es un filtro para especificar una compañía. Todos los destinatarios con un atributo de compañía que coincida con el valor que escriba para este parámetro estarán incluidos en la lista de direcciones que está modificando. Puede utilizar varios valores en forma de lista delimitada por comas. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute1	Opcional	System.String	El parámetro ConditionalCustomAttribute1 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute10	Opcional	System.String	El parámetro ConditionalCustomAttribute10 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute11	Opcional	System.String	El parámetro ConditionalCustomAttribute11 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute12	Opcional	System.String	El parámetro ConditionalCustomAttribute12 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute13	Opcional	System.String	El parámetro ConditionalCustomAttribute13 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute14	Opcional	System.String	El parámetro ConditionalCustomAttribute14 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute15	Opcional	System.String	El parámetro ConditionalCustomAttribute15 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute2	Opcional	System.String	El parámetro ConditionalCustomAttribute2 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute3	Opcional	System.String	El parámetro ConditionalCustomAttribute3 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute4	Opcional	System.String	El parámetro ConditionalCustomAttribute4 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute5	Opcional	System.String	El parámetro ConditionalCustomAttribute5 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute6	Opcional	System.String	El parámetro ConditionalCustomAttribute6 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute7	Opcional	System.String	El parámetro ConditionalCustomAttribute7 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute8	Opcional	System.String	El parámetro ConditionalCustomAttribute8 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute9	Opcional	System.String	El parámetro ConditionalCustomAttribute9 especifica atributos personalizados. Los atributos personalizados le permiten agregar información adicional a la lista de direcciones, que se puede usar para ordenar o agrupar las listas de direcciones. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalDepartment	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	El parámetro ConditionalDepartment es un filtro para especificar un departamento. Todos los destinatarios con un atributo de departamento que coincida con el valor que escriba para este parámetro estarán incluidos en la lista de direcciones. Puede utilizar varios valores en forma de lista delimitada por comas. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalStateOrProvince	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	El parámetro ConditionalStateOrProvince es un filtro para especificar un estado o provincia. Todos los destinatarios con un atributo ConditionalStateOrProvince que coincida con el valor que especifica para este parámetro estarán incluidos en la lista de direcciones. Puede utilizar varios valores en forma de lista delimitada por comas. Si utiliza un parámetro Conditional, debe usar el parámetro IncludedRecipients. No puede usar este parámetro si usa el parámetro RecipientFilter.
DisplayName	Opcional	System.String	El parámetro DisplayName especifica el nombre para mostrar deseado de la lista de direcciones.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar el nombre de dominio completo del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el comando.
ForceUpgrade	Opcional	System.Management.Automation.SwitchParameter	El parámetro ForceUpgrade suprime la siguiente petición de información: "Para guardar los cambios en un objeto, éste debe estar actualizado a la versión actual de Exchange. Una vez actualizado, este objeto no podrá ser administrado por una versión anterior del Administrador del sistema de Exchange. ¿Desea continuar con la actualización y guardar el objeto?" Esta confirmación se produce cuando se actualiza una lista de direcciones creada en Microsoft Exchange Server 2003 o Exchange 2000 Server. No se puede administrar una lista de direcciones de Exchange 2003 o de Exchange 2000 mediante la Consola de administración de Exchange hasta que se actualice la versión y se cambie el filtro de destinatarios mediante el parámetro RecipientFilter o el parámetro IncludedRecipients.
IncludedRecipients	Opcional	System.Nullable	El parámetro IncludedRecipients filtra los tipos de destinatario que se usan para crear la lista de direcciones global (GAL). Los valores disponibles para el parámetro IncludedRecipients son AllRecipients, MailboxUsers, Resources, Contacts y MailGroups. El valor AllRecipients únicamente puede usarse solo. Cuando varios valores del parámetro IncludedRecipients están separados por comas, se aplica el operador booleano OR. Debe usar este parámetro con cualquiera de los parámetros Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
Instance	Opcional	Microsoft.Exchange.Data.Directory.Management.AddressList	El parámetro Instance es raramente utilizado por los administradores que usan la línea de comandos. Está incluido en la tabla de parámetros como referencia del desarrollador.
Name	Opcional	System.String	El parámetro Name especifica un nombre nuevo de la lista de direcciones. El nombre no puede superar los 64 caracteres y no puede incluir retornos de carro ni barras diagonales inversas (\).
RecipientFilter	Opcional	System.String	El parámetro RecipientFilter especifica un filtro de destinatarios para incluirlo en la lista de direcciones. No puede utilizar este parámetro si utiliza cualquiera de los siguientes parámetros de filtro: ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients RecipientContainer Para obtener más información acerca de propiedades filtrables, consulte Propiedades filtrables para el parámetro: RecipientFilter.

Tipos de entrada

Tipos de valores devueltos

Errores

Error	Descripción

Excepciones

Excepciones	Descripción

Ejemplo

El primer ejemplo muestra cómo modificar el nombre de una lista de direcciones existente.

El segundo ejemplo muestra cómo modificar el tipo de destinatarios y el departamento de los destinatarios que estarán incluidos en la lista de direcciones existente llamada MyAddressList2. MyAddressList2 es una lista de direcciones de Exchange 2003, de modo que este comando también actualiza esta lista de direcciones.

Set-AddressList -Identity "All Users\Sales\building4" -Name building9
Set-Addresslist -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients UserMailbox -ConditionalDepartment Sales -ForceUpgrade:$true

Use el comando Get-AddressList, canalizado a Format-List, para obtener el GUID, nombre distintivo o ruta y nombre de una lista de direcciones existente. También puede utilizar Get-AddressList para obtener una lista de direcciones existentes específica y, a continuación, canalizar el resultado directamente a Set-AddressList.