Set-AddressRewriteEntry
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:
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:
|
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 Nota Este parámetro no se puede definir en |
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