Set-AddressList (RTM)
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:
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.