Set-EmailAddressPolicy

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2009-05-12

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

Sintaxis

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

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

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 de 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.

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

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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute1 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute10 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute11 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute12 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute13 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute14 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute15 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute2 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.

ConditionalCustomAttribute3

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute3 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute4 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute5 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute6 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute7 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute8 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

Microsoft.Exchange.Data.MultiValuedProperty

El parámetro ConditionalCustomAttribute9 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 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.

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.

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 un objeto completo al comando que se va a procesar. Se usa 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 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.

UseRusServer

Opcional

System.String

noteNota:
Este parámetro sólo está disponible en Exchange 2007 SP2.

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 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