Set-EmailAddressPolicy (RTM)

Artículo
06/26/2014

Se aplica a: Exchange Server 2007

Última modificación del tema: 2008-05-07

Use el cmdlet Set-EmailAddressPolicy para establecer los atributos del servicio de directorio Active Directory para una directiva de dirección de correo electrónico.

Sintaxis

Set-EmailAddressPolicy -Identity <EmailAddressPolicyIdParameter> [-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>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>]

Set-EmailAddressPolicy [-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>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <EmailAddressPolicy>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>]

Descripción detallada

El cmdlet Set-EmailAddressPolicy permite a los administradores establecer los atributos de Active Directory para una directiva de direcciones de correo electrónico específica. No obstante, el cmdlet Set-EmailAddressPolicy no aplica los cambios en esta directiva. Use el cmdlet Update-EmailAddressPolicy después del cmdlet Set-EmailAddressPolicy para aplicar los cambios.

Para ejecutar el cmdlet Set-EmailAddressPolicy, 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 sobre los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Para obtener más información acerca del cmdlet Update-EmailAddressPolicy, consulte Update-EmailAddressPolicy (RTM).

Parámetros

Parámetro	Necesario	Tipo	Descripción
Identity	Necesario	Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter	Use el parámetro Identity para especificar el GUID, el nombre distintivo o el nombre de directiva de correo electrónico que representa una directiva de dirección de correo electrónico específica. También puede incluir una ruta usando el formato Ruta\Directiva de direcciones de correo electrónico. Puede omitir la etiqueta del parámetro Identity para que únicamente se facilite el nombre de la directiva de dirección de correo electrónico o el GUID.
ConditionalCompany	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	El parámetro ConditionalCompany establece la compañía de la directiva de direcciones de correo electrónico. Usa 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	El parámetro ConditionalCustomAttribute1 especifica 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	El parámetro ConditionalCustomAttribute10 especifica 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	El parámetro ConditionalCustomAttribute11 especifica 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	El parámetro ConditionalCustomAttribute12 especifica 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	El parámetro ConditionalCustomAttribute13 especifica 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	El parámetro ConditionalCustomAttribute14 especifica 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	El parámetro ConditionalCustomAttribute15 especifica 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	El parámetro ConditionalCustomAttribute2 especifica 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.
ConditionalCustomAttribute3	Opcional	System.String	El parámetro ConditionalCustomAttribute3 especifica 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	El parámetro ConditionalCustomAttribute4 especifica 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	El parámetro ConditionalCustomAttribute5 especifica 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	El parámetro ConditionalCustomAttribute6 especifica 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	El parámetro ConditionalCustomAttribute7 especifica 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	El parámetro ConditionalCustomAttribute8 especifica 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	El parámetro ConditionalCustomAttribute9 especifica 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 establece el departamento de la directiva de direcciones de correo electrónico. Usa 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.
ConditionalStateOrProvince	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	El parámetro ConditionalStateOrProvince establece el estado o la provincia de la directiva de direcciones de correo electrónico. Usa 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.
DisabledEmailAddressTemplates	Opcional	Microsoft.Exchange.Data.ProxyAddressTemplateCollection	El parámetro DisabledEmailAddressTemplates define las direcciones proxy que se incluyen en una directiva de direcciones de correo electrónico y que están deshabilitadas. Usa varios valores en forma de lista delimitada por comas.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que recupera los datos de Active Directory, incluya el parámetro DomainController en el comando.
EnabledEmailAddressTemplates	Opcional	Microsoft.Exchange.Data.ProxyAddressTemplateCollection	El parámetro EnabledEmailAddressTemplates define las direcciones proxy que se incluyen en una directiva de direcciones de correo electrónico y que están habilitadas. Usa varios valores en forma de lista delimitada por comas.
EnabledPrimarySMTPAddressTemplate	Opcional	System.String	El parámetro EnabledPrimarySMTPAddressTemplate especifica las direcciones proxy que se incluyen en una directiva de direcciones de correo electrónico y que están habilitadas. Usa varios valores en forma de lista delimitada por comas.
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 actualiza una directiva de dirección de correo electrónico creada en Microsoft Exchange Server 2003 o en Exchange 2000 Server. No se puede administrar una directiva de direcciones de correo electrónico deExchange 2003 ni de Exchange 2000 con la Consola de administración de Exchange hasta que se actualice la versión y se cambie el filtro de destinatarios con los parámetros RecipientFilter, o 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 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.SystemConfiguration.EmailAddressPolicy	El parámetro Instance permite pasar todo un objeto al comando para su procesamiento. Se utiliza principalmente en scripts donde hay que pasar un objeto completo al comando.
Name	Opcional	System.String	El parámetro Name especifica el nombre nuevo de la directiva de direcciones de correo electrónico.
Priority	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority	El parámetro Priority hace que la prioridad actual sea más alta que la prioridad especificada como argumento para este parámetro.
RecipientFilter	Opcional	System.String	El parámetro RecipientFilter filtra los destinatarios incluidos en una directiva de direcciones de correo electrónico concreta. El parámetro RecipientFilter no puede usarse si se especifica cualquiera de los siguientes parámetros: ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients 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 siguiente código es un ejemplo del comando Set-EmailAddressPolicy en que se cambia el nombre de la directiva de direcciones de correo electrónico de EMAIL_ADDRESS_POLICY01 a EMAILADDRESSPOLICY02.

Set-EmailAddressPolicy -Identity EMAIL_ADDRESS_POLICY01 -Name EMAIL_ADDRESS_POLICY02