Set-GlobalAddressList (RTM)

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-05

Use 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 <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>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>]

Set-GlobalAddressList [-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>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <GlobalAddressList>] [-Name <String>] [-RecipientFilter <String>]

Descripción detallada

El cmdlet Set-GlobalAddressList modifica las propiedades de una GAL.

Para ejecutar el cmdlet Set-GlobalAddressList, debe usar 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.

Parámetros

Parámetro	Necesario	Tipo	Descripción
Identity	Necesario	Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter	Use 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 usando 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 usa para especificar una compañía. Puede usar varios valores en forma de lista delimitada por comas. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute1	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute10	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute11	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute12	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute13	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute14	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute15	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute2	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional.
ConditionalCustomAttribute3	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute4	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute5	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute6	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute7	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute8	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalCustomAttribute9	Opcional	System.String	Este parámetro especifica los atributos personalizados. Puede usar estos atributos para almacenar información adicional. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
ConditionalDepartment	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	El parámetro ConditionalDepartment se usa 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 usar varios valores en forma de lista delimitada por comas. Debe usar el parámetro IncludedRecipients si usa un parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
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 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 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 usan para crear la 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 si usa algún parámetro Conditional. No puede usar este parámetro si usa el parámetro RecipientFilter.
Instance	Opcional	Microsoft.Exchange.Data.Directory.Management.GlobalAddressList	El parámetro Instance permite pasar todo un objeto al comando para su procesamiento. Se usa principalmente en scripts donde hay que pasar un objeto completo al comando.
Name	Opcional	System.String	None.
RecipientFilter	Opcional	System.String	El parámetro RecipientFilter especifica un filtro para los destinatarios que se incluirán en la GAL. No es posible usar este parámetro si usa alguno de los siguientes parámetros de filtro: ConditionalCompany ConditionalDepartment IncludedRecipients ConditionalStateorProvince Debe usar este parámetro o uno de los parámetros de filtro anteriores. Para obtener más información acerca de propiedades filtrables, consulte Propiedades filtrables para el parámetro: RecipientFilter.
ConditionalStateOrProvince	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	None.

Tipos de entrada

Tipos de valores devueltos

Errores

Error	Descripción

Excepciones

Excepciones	Descripción

Ejemplo

En este ejemplo, se usa 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