New-AddressRewriteEntry
Este cmdlet está disponible o es efectivo solo en los servidores de transporte perimetral en Exchange local.
Use el cmdlet New-AddressRewriteEntry para crear una entrada de reescritura de direcciones que vuelva a escribir las direcciones de correo electrónico de remitente y de destinatario en los mensajes enviados a la organización o desde ella mediante un servidor Transporte perimetral.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Syntax
New-AddressRewriteEntry
[-Name] <String>
-ExternalAddress <String>
-InternalAddress <String>
[-Confirm]
[-DomainController <Fqdn>]
[-ExceptionList <MultiValuedProperty>]
[-OutboundOnly <Boolean>]
[-WhatIf]
[<CommonParameters>] Description
En los servidores de transporte perimetral, deberá ser miembro del grupo de administradores locales para ejecutar este cmdlet.
Ejemplos
Ejemplo 1
New-AddressRewriteEntry -Name "Address rewrite entry for david@contoso.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.comEn este ejemplo se crea una entrada de reescritura de direcciones que vuelve a escribir la dirección de correo electrónico david@contoso.com como david@northwindtraders.com en el correo saliente. Puesto que el parámetro OutboundOnly no se establece en $true, el correo entrante enviado a david@northwindtraders.com se vuelve a escribir como david@contoso.com.
Ejemplo 2
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com email addresses" -InternalAddress contoso.com -ExternalAddress northwindtraders.comEn este ejemplo se crea una entrada de reescritura de direcciones que vuelve a escribir todas las direcciones de correo electrónico del dominio contoso.com como northwindtraders.com en el correo saliente. Puesto que el parámetro OutboundOnly no se establece en $true, el correo entrante que se envía a los destinatarios de northwindtraders.com se vuelve a escribir como contoso.com.
Ejemplo 3
New-AddressRewriteEntry -Name "Address rewrite entry for contoso.com and all subdomain email addresses" -InternalAddress *.contoso.com -ExternalAddress northwindtraders.com -ExceptionList research.contoso.com,corp.contoso.com -OutboundOnly $trueEn este ejemplo se crea una entrada de reescritura de direcciones que vuelve a escribir todas las direcciones de correo electrónico del dominio contoso.com y todos los subdominios como northwindtraders.com. Sin embargo, no se reescriben direcciones de correo electrónico de research.contoso.com y corp.contoso.com. Debido a que esta entrada de reescritura de direcciones afecta a un dominio y todos los subdominios ( * . contoso.com), la reconfiguración de direcciones se produce solo en el correo saliente.
Parámetros
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir la solicitud de confirmación con esta sintaxis exacta:
-Confirm:$false. - La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.
El parámetro DomainController no es compatible con los servidores de transporte perimetral. Un servidor de transporte perimetral usa la instancia local de Active Directory Lightweight Directory Services (AD LDS) para leer y escribir datos.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
El parámetro ExternalAddress especifica las direcciones de correo electrónico finales que desee. Si el parámetro InternalAddress especifica una única dirección de correo electrónico (chris@contoso.com), el parámetro ExternalAddress debe especificar también una sola dirección de correo electrónico (support@contoso.com). Si el parámetro InternalAddress especifica un solo dominio (contoso.com) o un dominio y todos los subdominios ( * . contoso.com), el parámetro ExternalAddress debe especificar un solo dominio (Fabrikam.com).
No puede usar el carácter comodín ( * ) con el parámetro ExternalAddress.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
El parámetro InternalAddress especifica las direcciones de correo electrónico originales que desee cambiar. Puede usar los siguientes valores:
- Sola dirección de correo electrónico: david@contoso.com
- Dominio único: contoso.com o sales.contoso.com
- Dominio y todos los subdominios: * . contoso.com
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
El parámetro de la muestra de excepciones especifica los dominios de direcciones de correo electrónico que no se deben volver a escribir cuando el parámetro InternalAddress contiene el carácter comodín para reconfigurar las direcciones de un dominio y todos los subdominios ( * . contoso.com). Puede especificar varios valores de dominio separados por comas en el parámetro ExceptionList.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
El parámetro Name especifica un nombre único para la entrada existente de reescritura de direcciones.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
El parámetro OutboundOnly habilita o deshabilita la reconfiguración de direcciones solo salientes. La entrada válida para este parámetro es $true o $false. El valor $true indica que la reconfiguración de direcciones solo se produce en el correo saliente. El valor $false indica que la reconfiguración de direcciones se produce en el correo saliente y también en el correo entrante (las direcciones de correo electrónico reconfiguradas vuelven a cambiar a las direcciones de correo electrónico originales en el correo entrante). El valor predeterminado es $false.
Debe establecer este parámetro en $true si el parámetro InternalAddress contiene el carácter comodín para reconfigurar las direcciones de un dominio y todos los subdominios ( * . contoso.com).
Además, al definir la reconfiguración de direcciones solo salientes, debe establecer la dirección de correo electrónico reconfigurada como dirección proxy de los destinatarios afectados. Por ejemplo, si laura@sales.contoso.com se reconfigura como laura@contoso.com, la dirección proxy de laura@contoso.com debe configurarse en el buzón de Laura. Esto permite que las respuestas y los mensajes entrantes se entreguen correctamente.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Entradas
Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.
Salidas
Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.