Cómo importar entradas de reescritura de direcciones

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

Última modificación del tema: 2007-02-19

En este tema se explica cómo utilizar el Shell de administración de Exchange para importar entradas de reescritura de direcciones en un equipo que tenga instalada la función de transporte perimetral de Microsoft Exchange Server 2007.

Puede utilizar el Shell de administración de Exchange para realizar importaciones masivas de entradas de reescritura de direcciones en un servidor de transporte perimetral. A continuación tiene algunas de las situaciones más habituales en las que puede que desee realizar una importación masiva de entradas de reescritura de direcciones:

• Migración   Puede que desee importar masivamente entradas de reescritura de direcciones de una solución anterior que se sustituirá por una solución del servidor de transporte perimetral.

• Externalización   Puede que tenga que importar masivamente entradas de reescritura de direcciones al entrar en acuerdos con proveedores de soluciones de otros fabricantes cuyas direcciones de correo electrónico se deban reescribir.

• Adquisición   Puede que tenga que importar masivamente entradas de reescritura cuando la adquisición de otras organizaciones requiera la reescritura interna de las direcciones de correo electrónico de organizaciones adquiridas.

Si dispone de más de un servidor de transporte perimetral, es recomendable que utilice los siguientes procedimientos para importar entradas de reescritura de direcciones en un sólo servidor de transporte perimetral y, a continuación, clone la configuración de dicho servidor de transporte perimetral en los otros servidores de transporte perimetral de su organización.

Para obtener más información acerca de cómo clonar un servidor de transporte perimetral, consulte Utilización de la configuración clonada del servidor de.

Antes de empezar

Para ejecutar los siguientes procedimientos en un equipo que tiene instalada la función de servidor de transporte perimetral, debe iniciar sesión mediante una cuenta que sea miembro del grupo local de administradores en dicho equipo.

Debe estar familiarizado acerca de cómo crear una entrada de reescritura de direcciones antes de intentar utilizar archivos de valores separados por comas (CSV) para realizar importaciones masivas de entradas de reescritura de direcciones. Para obtener más información acerca de cómo crear una entrada de reescritura de direcciones, consulte Cómo crear una nueva entrada de reescritura de direcciones.

Procedimiento

Las secciones siguientes le ayudarán a entender cómo importar direcciones de reescritura de direcciones con archivos CSV:

• Creación de un archivo CSV   En esta sección se describen los campos obligatorios y opcionales en un archivo CSV que se pueden utilizar para importar entradas de reescritura de direcciones. La sección también describe los requisitos específicos cuando utilice los parámetros ExceptionList y OutboundOnly en el archivo CSV.

• Descripción de los archivos CSV con el cmdlet New-AddressRewriteEntry   En esta sección se explica cómo el Shell de administración de Exchange da forma y, a continuación, utiliza los datos del archivo CSV para importar entradas de reescritura de direcciones.

• Importación de un archivo CSV para crear varias entradas de reescritura de direcciones   Esta sección se basa en la información de las secciones anteriores con instrucciones acerca de cómo utilizar los comandos del Shell de administración de Exchange necesarios para importar un archivo CSV y utilizarlos para crear varias entradas de reescritura de direcciones.

Creación de un archivo CSV

Primero, debe crear un archivo CSV que contenga columnas de valores correlativas con los parámetros que necesita el cmdlet New-AddressRewriteEntry. El cmdlet New-AddressRewriteEntry necesita los valores siguientes y, por lo tanto, debe tener las columnas correspondientes en el archivo CSV:

• Name   Este parámetro debe ser una cadena que identifique exclusivamente la entrada de reescritura de direcciones.

• InternalEmailAddress   Este parámetro especifica la dirección de protocolo simple de transferencia de correo (SMTP) interna que se debe reescribir.

• ExternalEmailAddress   Este parámetro especifica la dirección SMTP externa que se debe reescribir.

Los siguientes parámetros son opcionales. Puede incluir columnas para ellos en el archivo CSV si los necesita:

• ExceptionList   Este parámetro especifica la lista de subdominios que no se deberían reescribir. No se reescribirá ninguna dirección SMTP que aparezca en los subdominios especificados.

• OutboundOnly   Este parámetro especifica si la entrada de reescritura debería reescribir las direcciones SMTP en los mensajes que son entrantes y salientes en la organización de Exchange 2007, o reescribir sólo los mensajes que son salientes de la organización de Exchange 2007.

Si especifica valores para las columnas ExceptionList y OutboundOnly en el archivo CSV, todas las filas deben indicar un valor en dichas columnas. Por ejemplo, si especifica un valor para la columna ExceptionList en cualquier fila del archivo CSV, el resto de filas del archivo CSV también debe contener un archivo en dicha columna. Esto se debe a que el parámetro ExceptionList en la línea de comandos espera un valor del archivo CSV.

Para obtener más información acerca de cada parámetro en estas listas, consulte New-AddressRewriteEntry.

Requisitos específicos cuando se incluye el parámetro ExceptionList en un archivo CSV

Si desea crear varias entradas de reescritura de direcciones donde algunas entradas requieren valores para el parámetro ExceptionList y otras no, debe separar estas entradas de reescritura de direcciones y crear archivos CSV independientes y, a continuación, importar cada uno de esos archivos CSV. Además, debe indicar los valores que se utilizan con el parámetroExceptionList entre comillas dobles ("). Si desea especificar varios dominios que tengan el parámetro ExceptionList, debe separar cada valor con comas (,). Por ejemplo, la cadena "domain1.com,domain2.com, domain3.com" contiene tres dominios indicados entre comillas dobles y separados con comas.

Requisitos específicos cuando se incluye el parámetro OutboundOnly en un archivo CSV

Si especifica valores en la columna OutboundOnly en una fila del archivo CSV, debe especificar un valor en la columna OutboundOnly en el resto de filas en el archivo CSV, como se hizo con el parámetro ExceptionList. Sin embargo, puede administrar este requisito fácilmente especificando si el parámetro OutboundOnly debería ser True o False en cada fila.

A diferencia del uso de booleanos en el resto del Shell de administración de Exchange, cuando especifica un valor para el parámetro OutboundOnly en un archivo CSV, debe especificar un valor para True o False, no para $True o $False. Esto se debe a que el valor en el archivo CSV se convierte manualmente a un valor booleano cuando del archivo CSV se interpreta en la línea de comando.

Para obtener más información acerca de cuando debe utilizar el parámetro OutboundOnly y cómo utilizar el parámetro OutboundOnly, consulte la sección "Consideraciones sobre el uso de la reescritura de direcciones sólo salientes" en Diseño de reescritura de direcciones.

Ejemplo de un archivo CSV con parámetros opcionales rellenados

En el siguiente ejemplo se muestra cómo un archivo CSV se puede rellenar con los parámetros opcionales ExceptionList y OutboundOnly incluidos:

Name,InternalAddress,ExternalAddress,ExceptionList,OutboundOnly
"Wingtip UK", *.wingtiptoys.co.uk, tailspintoys.com,"legal.wingtiptoys.co.uk,finance.wingtiptoys.co.uk,support.wingtiptoys.co.uk",True
"Wingtip USA", *.wingtiptoys.com, tailspintoys.com,"legal.wingtiptoys.com,finance.wingtiptoys.com,support.wingtiptoys.com,corp.wingtiptoys.com",True
"Wingtip Canada", *.wingtiptoys.ca, tailspintoys.com,"legal.wingtiptoys.ca,finance.wingtiptoys.ca,support.wingtiptoys.ca",True

En el siguiente ejemplo se muestra cómo un archivo CSV se puede rellenar con el parámetro opcional OutboundOnly incluido:

Name,InternalAddress,ExternalAddress,OutboundOnly
"Contoso Sales",*.sales.contoso.com,contoso.com,True
"Contoso Research",*.research.contoso.com,contoso.com,True
"Contoso UK",*.contoso.co.uk,contoso.com,True
"Contoso Japan",*.contoso.co.jp,contoso.com,True
"Contoso Support",support@adatum.com,support@contoso.com,False
"Contoso Financial External",contosofinancial@woodgrovebank.com,financialinqueries@contoso.com,False

Descripción de los archivos CSV con el cmdlet New-AddressRewriteEntry

Para importar entradas de reescritura de direcciones con archivos CSV, debe utilizar el cmdlet Import-Csv. El cmdlet Import-Csv lee el archivo CSV y da como resultado cada fila en el archivo CSV como un elemento de matriz y cada columna en la fila como una propiedad del elemento de matriz. Puede ver cómo funciona con el archivo CSV en "Ejemplo de un archivo CSV con parámetros opcionales rellenados", que se trata anteriormente en este tema. Importe el archivo CSV ejemplo con el siguiente comando, después de copiar el texto del ejemplo en un archivo denominado example.csv:

$CsvContents = Import-Csv c:\example.csv

A continuación, escriba el siguiente comando en la línea de comandos:

$CsvContents

Se devuelven los siguientes datos:

Name                InternalAddress     ExternalAddress     OutboundOnly
----                ---------------     ---------------     ------------
Contoso Sales       *.sales.contoso.com contoso.com         True
Contoso Research    *.research.conto... contoso.com         True
Contoso UK          *.contoso.co.uk     contoso.com         True
Contoso Japan       *.contoso.co.jp     contoso.com         True
Contoso Support     support@adatum.com  support@contoso.com False
Contoso Financia... contosofinancial... financialinqueri... False

Si desea ver sólo el valor contenido en la columna InternalAddress de la tercera fila, puede utilizar el comando siguiente:

$CsvContents[2].InternalAddress

Devolverá el valor *.contoso.co.uk.

Si entiende este ejemplo, le será más fácil entender cómo el Shell de administración de Exchange procesa el archivo CSV y lo utiliza para pasar datos al cmdlet New-AddressRewriteEntry.

Como puede ver en este ejemplo, cada fila en el archivo CSV se convierte en un elemento de matriz y cada columna se convierte en una propiedad de dicho elemento de matriz. Si utiliza el cmdlet ForEach , el Shell de administración de Exchange se puede mover por la matriz automáticamente desde el principio al fin y realizar acciones en cada elemento de la matriz, en este caso, se encuentra una fila del archivo CSV. Después de que un elemento de matriz se haya pasado al cmdlet ForEach en la canalización, el Shell de administración de Exchange puede acceder a las propiedades que se almacenen dentro. En este caso, las propiedades son las columnas que se encuentran en cada fila.

Después puede utilizar estas propiedades para construir el comando New-AddressRewiteEntry necesario para crear entradas de reescritura de direcciones. Las propiedades se denominan mediante los encabezamientos de columna en el archivo CSV. No es necesario que coincidan con el nombre del parámetro en el cmdlet. El siguiente comando se construye desde la explicación de este ejemplo:

Import-Csv c:\example.csv | ForEach { New-AddressRewriteEntry -Name $_.Name -InternalAddress $_.InternalAddress -ExternalAddress $_.ExternalAddress -OutboundOnly ([Bool]::Parse($_.OutboundOnly)) -ExceptionList ($_.ExceptionList.Split(","))}

Este comando hace un bucle a través de cada fila en el archivo example.csv y, después utiliza el cmdlet New-AddressRewriteEntry para crear entradas de reescritura de direcciones con los valores del parámetro obtenido de las columnas que existen en cada fila.

Probablemente observará la variable especial $_ en este comando. La variable especial $_ indica al comando que examine el objeto actual en el canal. En este caso, esta es la fila actual del archivo CSV.

Las propiedades OutboundOnly y ExceptionList también tienen texto adicional alrededor de sus propiedades respectivas. El texto ([Bool]::Parse($_.OutboundOnly)) indica al Shell de administración de Exchange que interprete la cadena que se encuentra dentro de la propiedad OutboundOnly como un valor booleano. El texto ($_.ExceptionList.Split(",")) indica al Shell de administración Exchange que divida varios valores que se encuentran dentro de la propiedad ExceptionList con comas. Sin el texto de alrededor de la propiedad ExceptionList, los valores que se encuentran en la propiedad ExceptionList se tratan como una sola cadena, aunque haya comas.

Para obtener más información acerca de la canalización, consulte Canalización (en inglés).

Importación de un archivo CSV para crear varias entradas de reescritura de direcciones

Ahora que ya entiende lo que pasa detrás de los escenarios, puede crear un archivo CSV y utilizarlo para crear varias entradas de reescritura de direcciones. Cree el archivo CSV que tenga al menos las columnas Name, InternalAddress, y ExternalAddress. Si desea especificar valores para los parámetros ExternalAddress y OutboundOnly, añada también estas columnas. Recuerde que cada fila debe tener un valor en cada columna. Para un ejemplo de un archivo CSV con un formato adecuado, consulte los ejemplos en "Ejemplo de un archivo CSV con parámetros opcionales rellenados" anteriormente en este tema.

Utilice la siguiente sintaxis de comando para crear varias entradas de reescritura de direcciones con un archivo CSV:

Import-Csv <CSV file path> | ForEach { New-AddressRewriteEntry -Name $_.<Name CSV column heading> -InternalAddress $_.<InternalAddress CSV column heading> -ExternalAddress $_.<ExternalAddress CSV column heading> -OutboundOnly ([Bool]::Parse($_.<OutboundOnly CSV column heading>)) -ExceptionList ($_.<ExceptionList CSV column heading>.Split(","))}

Uso de un archivo CSV en el Shell de administración de Exchange para crear entradas de reescritura de direcciones

1. Cree y rellene un archivo CSV denominado C:\ImportAddressRewriteEntries.csv

2. Ejecute el siguiente comando:

   Import-Csv c:\ImportAddressRewriteEntries.csv | ForEach { New-AddressRewriteEntry -Name $_.Name -InternalAddress $_.InternalAddress -ExternalAddress $_.ExternalAddress -OutboundOnly ([Bool]::Parse($_.OutboundOnly)) -ExceptionList ($_.ExceptionList.Split(","))}
   

Para obtener información detallada acerca de la sintaxis y los parámetros, consulte New-AddressRewriteEntry (en inglés).