Como importar entradas de reconfiguração de endereço

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Tópico modificado em: 2007-02-19

Este tópico explica como usar o Shell de Gerenciamento do Exchange para importar entradas de reconfiguração de endereço em um computador em que a função de servidor Transporte de Borda do Microsoft Exchange Server 2007 esteja instalada.

Você pode usar o Shell de Gerenciamento do Exchange para executar importações em massa de entradas de reconfiguração de endereço em um servidor de Transporte de Borda. A seguir, alguns cenários comuns nos quais você pode desejar executar uma importação em massa de entradas de reconfiguração de endereço:

• Migração   Convém executar uma importação em massa das entradas de reconfiguração de endereço de uma solução anterior que esteja sendo substituída por uma solução de servidor de Transporte de Borda.

• Terceirização   Você pode precisar executar uma importação em massa das entradas de reconfiguração de endereço ao fazer acordos com fornecedores de soluções de terceiros cujos endereços de email devam ser reconfigurados.

• Aquisição   Pode ser necessário executar uma importação em massa das entradas de reconfiguração de endereço quando a aquisição de outras organizações exige a reconfiguração provisória dos endereços de email das organizações adquiridas.

Se tiver mais de um servidor de Transporte de Borda, recomendamos que use os seguintes procedimentos para importar entradas de reconfiguração de endereço em um único servidor de Transporte de Borda e, em seguida, clone a configuração desse servidor de Transporte de Borda em outros servidores de Transporte de Borda de sua organização.

Para obter mais informações sobre como clonar um servidor de Transporte de Borda, consulte Usando a configuração clonada do servidor de Transporte de Borda.

Antes de começar

Para executar os procedimentos a seguir em um computador em que a função de servidor Transporte de Borda esteja instalada, faça logon com uma conta que seja membro do grupo Administradores local no computador.

Você deve estar familiarizado com o modo de criação de uma entrada de reconfiguração de endereço antes de tentar usar arquivos CSV (valor separado por vírgula) para executar importações em massa de entradas de reconfiguração de endereço. Para obter informações sobre como criar uma entrada de reconfiguração de endereço, consulte Como criar uma nova entrada de reconfiguração de endereço.

Procedimento

As seções a seguir ajudam a entender como importar entradas de reconfiguração de endereço usando arquivos CSV:

• Criando um arquivo CSV   Essa seção descreve os campos necessários e opcionais em um arquivo CSV que podem ser usados para importar entradas de reconfiguração de endereço. A seção descreve também os requisitos específicos ao usar os parâmetros ExceptionList e OutboundOnly no arquivo CSV.

• Compreendendo como os arquivos CSV são usados com o cmdlet New-AddressRewriteEntry   Essa seção explica como o Shell de Gerenciamento do Exchange formata e depois usa os dados contidos no arquivo CSV para importar entradas de reconfiguração de endereço.

• Importando um arquivo CSV para criar várias entradas de reconfiguração de endereço   Essa seção baseia-se nas informações das seções anteriores, com instruções sobre como usar os comandos do Shell de Gerenciamento do Exchange que são necessários para importar um arquivo CSV e usá-lo para criar várias entradas de reconfiguração de endereço.

Criando um arquivo CSV

Primeiramente, crie um arquivo CSV que contenha colunas de valores correlacionados com os parâmetros exigidos pelo cmdlet New-AddressRewriteEntry. Os valores a seguir são exigidos pelo cmdlet New-AddressRewriteEntry e por isso devem ter colunas correspondentes no arquivo CSV:

• Name   Esse parâmetro deve ser uma cadeia de caracteres que identifique exclusivamente a entrada de reconfiguração de endereço.

• InternalEmailAddress   Esse parâmetro especifica o endereço SMTP interno a ser reconfigurado.

• ExternalEmailAddress   Esse parâmetro especifica o endereço SMTP externo a ser reconfigurado.

Os parâmetros a seguir são opcionais. Se eles forem necessários, você poderá incluir colunas para eles no arquivo CSV:

• ExceptionList   Esse parâmetro especifica a lista de subdomínios que não devem ser reconfigurados. Nenhum endereço SMTP contido nos subdomínios especificados é reconfigurado.

• OutboundOnly   Esse parâmetro especifica se a entrada de reconfiguração de endereço deve reconfigurar endereços SMTP em mensagens de entrada e saída da organização do Exchange 2007, ou reconfigurar apenas as mensagens de saída da organização do Exchange 2007.

Se você especificar valores para as colunas ExceptionList e OutboundOnly no arquivo CSV, cada linha deverá incluir um valor nessa coluna. Por exemplo, se for especificado um valor para a coluna ExceptionList em qualquer linha do arquivo CSV, todas as demais linhas do arquivo CSV deverão também conter um valor nessa coluna. Isso se deve ao fato de que o parâmetro ExceptionList na linha de comando espera um valor do arquivo CSV.

Para obter mais informações sobre cada parâmetro dessas listas, consulte New-AddressRewriteEntry.

Requisitos específicos ao incluir o parâmetro ExceptionList em um arquivo CSV

Para criar várias entradas de reconfiguração de endereço quando algumas entradas exigirem valores para o parâmetro ExceptionList e outras não, separe essas entradas de reconfiguração de endereço e crie arquivos CSV separados e, em seguida, importe cada arquivo CSV. Além disso, coloque os valores usados com o parâmetro ExceptionList entre aspas ("). Para especificar vários domínios que tenham o parâmetro ExceptionList, separe cada valor com vírgulas (,). Por exemplo, a cadeia de caracteres "domain1.com,domain2.com, domain3.com" contém três domínios entre aspas e separados por vírgulas.

Requisitos específicos ao incluir o parâmetro OutboundOnly em um arquivo CSV

Se você especificar valores na coluna OutboundOnly em uma linha do arquivo CSV, você deverá especificar um valor na coluna OutboundOnly em linhas alternadas no arquivo CSV, da mesma forma que no parâmetro ExceptionList. No entanto, é fácil gerenciar esse requisito especificando se o parâmetro OutboundOnly deve ser True ou False em cada linha.

Ao contrário do uso de valor booleano em outros locais do Shell de Gerenciamento do Exchange, ao especificar um valor para o parâmetro OutboundOnly em um arquivo CSV, você deve especificar um valor True ou False, não $True ou $False. Isso se deve ao fato de que o valor no arquivo CSV é convertido manualmente em um valor booleano quando o arquivo CSV é interpretado na linha de comando.

Para obter mais informações sobre quando é necessário usar o parâmetro OutboundOnly, e como usar o parâmetro OutboundOnly, consulte a seção "Considerações sobre o uso da reconfiguração de endereço Outbound-Only", em Planejando reconfiguração de endereço.

Exemplo de um arquivo CSV com parâmetros opcionais preenchidos

O exemplo a seguir mostra como um arquivo CSV pode ser preenchido com os parâmetros opcionais ExceptionList e OutboundOnly incluídos:

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

O exemplo a seguir mostra como um arquivo CSV pode ser preenchido com o parâmetro opcional OutboundOnly incluído:

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

Compreendendo como os arquivos CSV são usados com o cmdlet New-AddressRewriteEntry

Para importar entradas de reconfiguração de endereço usando arquivos CSV, use o cmdlet Import-Csv. O cmdlet Import-Csv lê o arquivo CSV e gera cada linha do arquivo CSV como elemento da matriz e cada coluna da linha como propriedade desse elemento da matriz. Veja como isso funciona usando o arquivo CSV em "Exemplo de um arquivo CSV com parâmetros opcionais preenchidos" anteriormente neste tópico. Importe o arquivo CSV do exemplo com o seguinte comando, depois de copiar o texto do exemplo em um arquivo com o nome example.csv:

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

Em seguida, digite o seguinte comando na linha de comando:

$CsvContents

Os seguintes dados são retornados:

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

Para exibir somente o valor contido na coluna InternalAddress da terceira linha, use o seguinte comando:

$CsvContents[2].InternalAddress

Isso retorna o valor *.contoso.co.uk.

Compreender esse exemplo facilitará a compreensão de como o Shell de Gerenciamento do Exchange processa o arquivo CSV e o utiliza para transmitir dados ao cmdlet New-AddressRewriteEntry.

Como pode ser visto nesse exemplo, cada linha do arquivo CSV se torna um elemento da matriz; e cada coluna, uma propriedade desse elemento da matriz. Com o uso do cmdlet ForEach, o Shell de Gerenciamento do Exchange pode percorrer a matriz automaticamente do início ao fim e executar ações à medida que cada elemento da matriz, nesse caso, uma linha do arquivo CSV, é encontrado. Depois que um elemento da matriz tiver sido transmitido ao cmdlet ForEach no pipeline, o Shell de Gerenciamento do Exchange poderá acessar as propriedades armazenadas nele. Nesse caso, as propriedades são as colunas contidas em cada linha.

Você pode usar essas propriedades para construir o comando New-AddressRewiteEntry que é necessário para criar entradas de reconfiguração de endereço. As propriedades são nomeadas com o uso dos títulos das colunas do arquivo CSV. Elas não precisam corresponder ao nome do parâmetro no cmdlet. O comando a seguir é construído usando a explicação desse exemplo:

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

Esse comando forma um loop em cada linha do arquivo example.csv e, em seguida, usa o cmdlet New-AddressRewriteEntry para criar entradas de reconfiguração de endereço usando os valores de parâmetro obtidos nas colunas existentes em cada linha.

Você provavelmente notou a variável especial $_ nesse comando. A variável especial $_ instrui o comando a examinar o objeto atual no pipeline. Nesse caso, essa é a linha atual do arquivo CSV.

As propriedades OutboundOnly e ExceptionList também têm texto adicional adjacente a suas respectivas propriedades. O texto ([Bool]::Parse($_.OutboundOnly)) instrui o Shell de Gerenciamento do Exchange a interpretar como valor booleano a cadeia de caracteres contida na propriedade OutboundOnly. O texto ($_.ExceptionList.Split(",")) instrui o Shell de Gerenciamento do Exchange a separar por vírgula os vários valores contidos na propriedade ExceptionList. Sem o texto adjacente à propriedade ExceptionList, os valores contidos na propriedade ExceptionList são tratados como uma cadeia de caracteres única, mesmo com a presença de vírgulas.

Para obter mais informações sobre pipeline, consulte Pipelining.

Importando um arquivo CSV para criar várias entradas de reconfiguração de endereço

Agora que você compreende o que acontece nos bastidores, você pode criar um arquivo CSV e usá-lo para criar várias entradas de reconfiguração de endereço. Crie o arquivo CSV que tenha no mínimo as colunas Name, InternalAddress e ExternalAddress. Para especificar os valores dos parâmetros ExternalAddress e OutboundOnly, adicione essas colunas também. Lembre-se de que cada linha deve ter um valor em cada coluna. Para ver um exemplo de um arquivo CSV formatado corretamente, consulte os exemplos em "Exemplo de um arquivo CSV com parâmetros opcionais preenchidos" anteriormente descrito neste tópico.

Use a seguinte sintaxe de comando para criar várias entradas de reconfiguração de endereço usando um arquivo 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(","))}

Para usar um arquivo CSV no Shell de Gerenciamento do Exchange a fim de criar várias entradas de reconfiguração de endereço

1. Crie e preencha um arquivo CSV com o nome C:\ImportAddressRewriteEntries.csv

2. Execute o seguinte comando:

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

Para obter informações detalhadas sobre sintaxe e parâmetro, consulte New-AddressRewriteEntry.