New-AddressRewriteEntry
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2010-10-20
Utilice el cmdlet New‑AddressRewriteEntry para ver una entrada existente de reescritura de direcciones que vuelve a escribir 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
new-AddressRewriteEntry -Name <String> -ExternalAddress <String> -InternalAddress <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-OutboundOnly <$true | $false>] [-TemplateInstance <PSObject>] [-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 de servidor de transporte de bordes.
Para ejecutar el cmdlet New-AddressRewriteEntry en un equipo que tiene instalada la función de servidor de transporte de bordes, debe iniciar sesión mediante una cuenta que sea miembro del grupo local de administradores en dicho equipo.
Nota
Solo se puede usar una dirección de correo electrónico. No se pueden asignar varias direcciones a una dirección de correo electrónico.
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 |
|---|---|---|---|
ExternalAddress |
Necesario |
System.String |
Este parámetro especifica 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:
Nota No puede utilizarse el carácter asterisco con el parámetro ExternalAddress. |
InternalAddress |
Necesario |
System.String |
Este parámetro especifica la dirección de correo electrónico interna o nombre de dominio que va a reescribirse. Es posible introducir las direcciones o los nombres de dominio en los tres formatos siguientes:
|
Name |
Necesario |
System.String |
Este parámetro permite al administrador modificar el nombre único para esta entrada de reescritura de direcciones. |
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 de transporte de bordes. La función de servidor de transporte de bordes 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 nombres 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 de varios valores, consulte Modificar propiedades con varios valores. |
OutboundOnly |
Opcional |
System.Boolean |
Este parámetro especifica qué direcciones de correo electrónico deben volver a escribirse sólo cuando los mensajes de correo electrónico dejan la organización de Exchange 2007, o si las direcciones deben volver a escribirse cuando se envían mensajes en las dos direcciones. Los dos valores posibles para este parámetro son Nota Este parámetro no se puede definir en |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Cuando un objeto existente se suministra a este parámetro, el comando utiliza la configuración de ese objeto para crear una copia idéntica del objeto en un servidor local o de destino. Para obtener más información, vea Plantillas (en inglés). |
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 tres escenarios diferentes:
Reescriba una dirección de correo electrónico única. Se reescriben los mensajes de correo electrónico en ambas direcciones.
Reescriba todas las direcciones de correo electrónico para el dominio contoso.com. Se reescriben los mensajes de correo electrónico en ambas direcciones.
Reescriba todas las direcciones de correo electrónico para el dominio contoso.com y todos los subdominios, excepto research.contoso.com y corp.contoso.com. Sólo se reescriben los mensajes de correo electrónico salientes.
New-AddressRewriteEntry -Name "Address rewrite entry for david@contoso.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com e-mail addresses" -InternalAddress contoso.com -ExternalAddress northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com and subdomain e-mail addresses" -InternalAddress *.contoso.com -ExternalAddress northwindtraders.com -OutboundOnly:$true -ExceptionList research.contoso.com,corp.contoso.com