Compartir a través de

Set-AddressRewriteEntry

  • Artículo

 

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

Última modificación del tema: 2007-08-28

Use 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> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]

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

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 el conector de recepción y en el conector 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.

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange 2007, consulte Consideraciones sobre permisos.

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.

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.

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 Transporte perimetral. 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. Para obtener más información acerca de cómo agregar o quitar valores de propiedades con varios valores, consulte Modificar propiedades con varios valores.

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 usan 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 indicar 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 usando la dirección especificada. Por ejemplo, david@northwindtraders.com.

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

Nota

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

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AddressRewriteEntry

El parámetro Instance permite pasar un objeto completo al comando para su procesamiento. Se usa 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 indicar 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.

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

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