Set-GlobalAddressList
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-GlobalAddressList para modificar los atributos del servicio de directorio Active Directory para una lista global de direcciones (GAL).
Sintaxis
Set-GlobalAddressList -Identity <GlobalAddressListIdParameter> [-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>]] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Set-GlobalAddressList [-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>]] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <GlobalAddressList>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El cmdlet Set-GlobalAddressList modifica las propiedades de una GAL.
Para ejecutar el cmdlet Set-GlobalAddressList, debe utilizar una cuenta en la que se delegue lo siguiente:
- Función de 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.
Parámetros
| Parámetro | Necesario | Tipo | Descripción | ||
|---|---|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter |
Utilice el parámetro Identity para especificar el GUID, el nombre completo o el nombre de la lista global de direcciones (GAL) que representa una GAL específica. También puede incluir la ruta utilizando el formato Path\GlobalAddressListName. Puede omitir la etiqueta del parámetro Identity para que únicamente se facilite el nombre de la GAL o del GUID. |
||
ConditionalCompany |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalCompany se utiliza para especificar una compañía. Puede utilizar varios valores en forma de lista delimitada por comas. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute1 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute10 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute11 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute12 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute13 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute14 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute15 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute2 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute3 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute4 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute5 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute6 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute7 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute8 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalCustomAttribute9 |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
Este parámetro especifica los atributos personalizados. Puede utilizar estos atributos para almacenar información adicional. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalDepartment |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalDepartment se utiliza para especificar un departamento. Todas las GAL con un atributo de departamento que coincida con el valor que especifica para este parámetro estarán incluidas. Puede utilizar varios valores en forma de lista delimitada por comas. Debe utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. No puede utilizar este parámetro si utiliza el parámetro RecipientFilter. |
||
ConditionalStateOrProvince |
Opcional |
Microsoft.Exchange.Data.MultiValuedProperty |
El parámetro ConditionalStateOrProvince establece el estado o la provincia de la lista global de direcciones. Utiliza varios valores en forma de lista delimitada por comas. Es necesario utilizar el parámetro IncludedRecipients si utiliza un parámetro Conditional. 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. |
||
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. |
||
ForceUpgrade |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro ForceUpgrade suprime la siguiente confirmación: "Para guardar los cambios en el objeto, el objeto debe actualizarse a la versión actual de Exchange. Después de la actualización, el objeto no puede ser administrado mediante una versión anterior del Administrador del sistema de Exchange. ¿Desea continuar la actualización y guardar el objeto?" Esta confirmación se produce cuando actualiza una GAL creada en Microsoft Exchange Server 2003 o Exchange 2000 Server. No se puede administrar una GAL 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 destinatarios que se utilizan para crear la 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 varios valores del parámetro IncludedRecipients están separados por comas, se aplica el operador booleano OR. Es necesario utilizar este parámetro si está utilizando 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.GlobalAddressList |
El parámetro Instance le permite pasar un objeto completo al comando que se va a procesar. Se utiliza principalmente en scripts en los que se debe pasar un objeto completo al comando. |
||
Name |
Opcional |
System.String |
El parámetro Name especifica el nombre nuevo de la lista global de direcciones. |
||
RecipientFilter |
Opcional |
System.String |
El parámetro RecipientFilter especifica un filtro para los destinatarios que se incluirán en la GAL. No es posible utilizar este parámetro si utiliza alguno de los siguientes parámetros de filtro:
Debe utilizar este parámetro o uno de los parámetros de filtro anteriores. 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. |
.gif "note")
Nota:Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
Ejemplo
En este ejemplo, se utiliza el comando Set-GlobalAddressList para asignar un nombre nuevo, GALwithNewName, a la GAL con el GUID 96d0c505-eba8-4103-ad4f-577a1bf4ad7b.
Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName