Set-AddressRewriteEntry (RTM)

 

Se aplica a: Exchange Server 2007

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

Utilice el cmdlet Set-AddressRewriteEntry para modificar una entrada existente de reescritura de direcciones que escribe de nuevo direcciones de correo electrónico de remitente y destinatario en mensajes de correo electrónico que se envían a una organización de correo electrónico y proceden de ésta.

Sintaxis

set-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>]

set-addressrewriteentry [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-Instance <AddressRewriteEntry>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>]

Descripción detallada

En Microsoft Exchange Server 2007, la reescritura de direcciones permite modificar las direcciones de los remitentes y destinatarios en los mensajes que entran y salen de una organización de Exchange 2007. Los agentes de reescritura de direcciones se configuran en los conectores de recepción y de envío de un equipo que tiene instalada la función del servidor Transporte perimetral.

Para ejecutar el cmdlet Set-AddressRewriteEntry en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión mediante una cuenta que sea miembro del grupo de administradores local en dicho equipo.

Parámetros

Parámetro Necesario Tipo Descripción

Identity

Necesario

Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter

Este parámetro especifica la entrada de reescritura de direcciones que se va a modificar. El parámetro Identity aceptará un GUID o el nombre de reescritura de direcciones único.

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 en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el comando. El parámetro DomainController no es compatible con servidores de transporte de bordes. La función del servidor Transporte perimetral sólo escribe en la instancia de ADAM local.

ExceptionList

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parámetro especifica los nombres de dominio que no se deben reescribir cuando el parámetro InternalAddress contenga un valor que especifique varios nombre de dominio. Puede separar mediante comas varios nombres de dominio que se incluyen con el parámetro ExceptionList.

ExternalAddress

Opcional

System.String

Este parámetro permite al administrador modificar la dirección de correo electrónico o el nombre de domino externos que se utilizan al reescribir una dirección de correo electrónico o un nombre de dominio internos. Si se especifica una dirección de correo electrónico en InternalAddress, el valor especificado en ExternalAddress también debe ser una dirección de correo electrónico. Si se especifica un nombre de dominio o un nombre de dominio con un carácter comodín en InternalAddress, debe especificarse un nombre de dominio en ExternalAddress. Es posible introducir las direcciones o los nombres de dominio en los dos formatos siguientes:

  • Dirección de correo electrónico   Reescriba una sola dirección de correo electrónico interna utilizando la dirección especificada. Por ejemplo, david@northwindtraders.com.

  • Nombre de dominio   Reescriba todas las direcciones de correo electrónico internas incluidas en InternalAddress utilizando el nombre de dominio externo especificado. Por ejemplo, northwindtraders.com.

Nota

No puede utilizarse el carácter asterisco con el parámetro ExternalAddress.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AddressRewriteEntry

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.

InternalAddress

Opcional

System.String

Este parámetro permite al administrador modificar la dirección de correo electrónico o nombre de dominio internos que se va a reescribir. Es posible introducir las direcciones o los nombres de dominio en los tres formatos siguientes:

  • Dirección de correo electrónico única   Reescriba sólo la dirección especificada. Por ejemplo, david@contoso.com.

  • Nombre de dominio   Reescriba todas las direcciones de correo electrónico asociadas con el nombre de dominio especificado. Por ejemplo, contoso.com.

  • Nombre de dominio con asterisco   Reescriba todas las direcciones de correo electrónico asociadas con el nombre de dominio y con todos los subdominios. Por ejemplo, *.contoso.com.

Name

Opcional

System.String

Este parámetro permite al administrador modificar el nombre único para esta entrada de reescritura de direcciones.

OutboundOnly

Opcional

System.Boolean

Este parámetro permite al administrador modificar si las direcciones de correo electrónico deben reescribirse sólo cuando los mensajes de correo electrónico dejan la organización de Exchange Server 2007, o si las direcciones deben reescribirse cuando se envían mensajes en las dos direcciones. Los dos valores posibles para este parámetro son $true o $false. El valor predeterminado es $false.

Nota

Este parámetro no se puede definir en $false si el valor especificado en InternalAddress contiene una carácter comodín.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

Excepciones

Excepciones Descripción

 

Ejemplo

Los siguientes ejemplos muestran cómo modificar las entradas de reescritura de direcciones existentes. En el primer ejemplo se establece el nombre de dominio interno que se va a escribir. El nombre descriptivo de esta entrada también se cambia para reflejar el nuevo nombre de dominio que se va a reescribir.

En el segundo ejemplo se establece el parámetro OutboundOnly como $true. Esta acción indica al agente de reescritura de direcciones que reescriba sólo en mensajes de correo electrónico que salgan de la organización de Exchange 2007.

Importante

Los emisores internos a los que afecte una entrada de reescritura de direcciones que tenga el parámetro OutboundOnly con el valor $true, deben tener configurada una dirección proxy que coincida con la dirección de correo electrónico reescrita.

Set-AddressRewriteEntry "Address rewrite entry for contoso.com" -Name "Address rewrite entry for northwindtraders.com" -InternalAddress northwindtraders.com 
Set-AddressRewriteEntry "Address rewrite entry for all contoso.com e-mail addresses" -OutboundOnly:$true