Set-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 Set-AddressList para modificar una lista de direcciones específica.
Sintaxis
Set-AddressList -Identity <AddressListIdParameter> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Set-AddressList [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
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 sobre los permisos, funciones de delegación 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 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. |
||
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 introduce 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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute1 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute10 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute11 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute12 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute13 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute14 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute15 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute2 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute3 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute4 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute5 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute6 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute7 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute8 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute9 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
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 utilizar este parámetro si utiliza 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 introduce 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 utilizar este parámetro si utiliza 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 utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
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. |
||
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 confirmación: "Para guardar los cambios en el objeto, éste debe actualizarse a la versión actual de Exchange. Después de la actualización, este objeto no se puede administrar con ninguna versión anterior del Administrador del sistema de Exchange. ¿Desea continuar 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 es posible administrar una lista de direcciones de Exchange 2003 o Exchange 2000 mediante la Consola de administración de Exchange hasta que actualice la versión del objeto y cambie el filtro de destinatarios mediante los parámetros RecipientFilter o IncludedRecipients. |
||
IncludedRecipients |
Opcional |
System.Nullable |
El parámetro IncludedRecipients filtra los tipos de destinatario que se utilizan para crear la lista global de direcciones (GAL). Los valores disponibles para el parámetro IncludedRecipients son AllRecipients, MailboxUsers, Resources, Contacts y MailGroups. El valor AllRecipients únicamente se puede utilizar solo. Cuando hay varios valores del parámetro IncludedRecipients separados por comas, se aplica el operador booleano OR. Debe usar este parámetro con cualquiera de los parámetros Conditional. No puede utilizar este parámetro si utiliza 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 a las que se puede aplicar un filtro, consulte Propiedades filtrables para el parámetro: RecipientFilter. |
||
UseRusServer |
Opcional |
System.String |
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 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
Utilice el comando Get-AddressList, canalizado a Format-List, para obtener el GUID, nombre completo 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.