Set-EmailAddressPolicy (RTM)
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:
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