Come importare le voci di riscrittura di indirizzi

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Ultima modifica dell'argomento: 2007-02-19

In questo argomento viene descritto come utilizzare Exchange Management Shell per importare le voci di riscrittura di indirizzi in un computer in cui è installato il ruolo del server Trasporto Edge di Microsoft Exchange Server 2007.

Exchange Management Shell consente di eseguire importazioni in gruppo di voci di riscrittura di indirizzi in un server Trasporto Edge. Di seguito vengono riportati alcuni degli scenari più comuni in cui è utile eseguire un'importazione in gruppo di voci di riscrittura di indirizzi:

• Migrazione  È possibile importare in gruppo le voci di riscrittura di indirizzi da una precedente soluzione che deve essere sostituita da una soluzione server Trasporto Edge.

• Collaborazioni esterne   È possibile importare in gruppo le voci di riscrittura di indirizzi quando si concludono accordi con fornitori di soluzioni di terze parti in base ai quali gli indirizzi di posta elettronica di tali fornitori devono essere riscritti.

• Acquisizioni   È possibile importare in gruppo le voci di riscrittura di indirizzi quando l'acquisizione di altre organizzazioni richiede la riscrittura provvisoria degli indirizzi di posta elettronica delle organizzazioni acquisite.

Se si dispone di più server Trasporto Edge, si consiglia di utilizzare le procedure riportate di seguito per importare le voci di riscrittura di indirizzi in un solo server Trasporto Edge, quindi clonare la configurazione di tale server Trasporto Edge in altri server Trasporto Edge dell'organizzazione.

Per ulteriori informazioni su come clonare un server Trasporto Edge, vedere Utilizzo della configurazione clonata del server Edge Transport.

Informazioni preliminari

Per eseguire le procedure riportate di seguito su un computer in cui è installato il ruolo del server Trasporto Edge, è necessario accedere al sistema utilizzando un account che sia membro del gruppo Administrators locale del computer.

Prima di provare ad utilizzare file con valori delimitati da virgole (CSV, Comma-Separated Value) per eseguire importazioni in gruppo di voci di riscrittura di indirizzi, è necessario essere in grado di creare una voce di riscrittura di indirizzi. Per informazioni su come creare una voce di riscrittura di indirizzi, vedere Come creare una nuova voce di riscrittura degli indirizzi.

Procedura

Nelle seguenti sezioni viene illustrata l'importazione delle voci di riscrittura di indirizzi tramite l'utilizzo di file CSV:

• Creazione di un file CSV   In questa sezione vengono descritti i campi obbligatori e facoltativi in un file CSV che può essere utilizzato per importare le voci di riscrittura di indirizzi. Inoltre, vengono descritti i requisiti specifici per l'utilizzo dei parametri ExceptionList e OutboundOnly nel file CSV.

• Informazioni sull'utilizzo dei file CSV con il cmdlet New-AddressRewriteEntry   In questa sezione viene illustrato come in Exchange Management Shell vengono formattati e quindi utilizzati i dati contenuti nel file CSV per importare le voci di riscrittura di indirizzi.

• Importazione di un file CSV per creare più voci di riscrittura di indirizzi   In questa sezione si aggiungono alle informazioni riportate nelle sezioni precedenti le istruzioni di utilizzo dei comandi di Exchange Management Shell necessari per importare un file CSV e utilizzarlo per creare più voci di riscrittura di indirizzi.

Creazione di un file CSV

Innanzitutto, è necessario creare un file CSV che contenga colonne di valori relative ai parametri richiesti dal cmdlet New-AddressRewriteEntry. I valori riportati di seguito sono obbligatori per il cmdlet New-AddressRewriteEntry e quindi devono esistere colonne corrispondenti nel file CSV:

• Name   Questo parametro deve essere una stringa che identifica in modo univoco la voce di riscrittura di indirizzi.

• InternalEmailAddress   Questo parametro consente di specificare l'indirizzo SMTP (Simple Mail Transfer Protocol) interno da riscrivere.

• ExternalEmailAddress   Questo parametro consente di specificare l'indirizzo SMTP esterno da riscrivere.

I parametri riportati di seguito sono facoltativi. Se si desidera utilizzarli, è possibile includere nel file CSV delle colonne per ognuno di essi:

• ExceptionList   Questo parametro consente di specificare l'elenco dei sottodomini da non riscrivere. Gli indirizzi SMTP contenuti nei sottodomini specificati non vengono riscritti.

• OutboundOnly   Questo parametro consente di specificare se la voce di riscrittura di indirizzi deve riscrivere gli indirizzi SMTP nei messaggi in entrata o in uscita nell'organizzazione di Exchange 2007 oppure se deve riscrivere solo i messaggi in uscita dall'organizzazione di Exchange 2007.

Se si specificano dei valori per le colonne ExceptionList e OutboundOnly nel file CSV, ciascuna riga deve includere un valore in quella colonna. Ad esempio, se si specifica un valore per la colonna ExceptionList in una riga del file CSV, anche tutte le altre righe devono contenere un valore in quella colonna. Questa necessità è dovuta al fatto che il parametro ExceptionList nella riga di comando prevede un valore dal file CSV.

Per ulteriori informazioni su ciascun parametro in questi elenchi, vedere New-AddressRewriteEntry.

Requisiti specifici quando si include il parametro ExceptionList in un file CSV

Se si desidera creare più voci di riscrittura di indirizzi e solo alcune di tali voci richiedono valori per il parametro ExceptionList, è necessario separare tali voci di riscrittura di indirizzi e creare file CSV separati, quindi importare singolarmente i file CSV. Inoltre, è necessario racchiudere i valori utilizzati con il parametro ExceptionList tra virgolette doppie ("). Se si desidera specificare più domini contenenti il parametro ExceptionList, è necessario separare ciascun valore utilizzando una virgola (,). Ad esempio, la stringa "domain1.com,domain2.com, domain3.com" contiene tre domini racchiusi tra virgolette doppie e separati da virgole.

Requisiti specifici quando si include il parametro OutboundOnly in un file CSV

Se si specificano valori nella colonna OutboundOnly in una riga del file CSV, è necessario specificare un valore nella colonna OutboundOnly in tutte le altre righe del file CSV, come con il parametro ExceptionList. Tuttavia, è possibile gestire facilmente questo requisito specificando se il parametro OutboundOnly deve essere True o False in ciascuna riga.

Diversamente dall'utilizzo booleano in altre operazioni con Exchange Management Shell, quando si specifica un valore per il parametro OutboundOnly in un file CSV, è necessario specificare il valore True o False, non $True o $False. Il valore contenuto nel file CSV viene infatti convertito manualmente in un valore booleano quando il file CSV viene interpretato nella riga di comando.

Per ulteriori informazioni sul momento in cui è necessario utilizzare il parametro OutboundOnly e su come utilizzare il parametro OutboundOnly, vedere la sezione "Considerazioni sull'utilizzo della riscrittura degli indirizzi solo in uscita" in Pianificazione per la riscrittura degli indirizzi.

Esempio di un file CSV con i parametri facoltativi popolati

Nel seguente esempio viene mostrato come popolare un file CSV con i parametri facoltativi ExceptionList e OutboundOnly inclusi:

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

Nel seguente esempio viene mostrato come popolare un file CSV con il parametro facoltativo OutboundOnly incluso:

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

Informazioni sull'utilizzo dei file CSV con il cmdlet New-AddressRewriteEntry

Per importare le voci di riscrittura di indirizzi utilizzando i file CSV, è necessario utilizzare il cmdlet Import-Csv. Il cmdlet Import-Csv consente di leggere il file CSV e restituisce ciascuna riga nel file CSV come un elemento di array e ciascuna colonna nella riga come una proprietà di quell'elemento di array. È possibile eseguire questa operazione utilizzando il file CSV come illustrato in "Esempio di un file CSV con i parametri facoltativi popolati" più indietro in questo argomento. Importare il file CSV di esempio utilizzando il comando riportato di seguito, dopo aver copiato il testo dell'esempio in un file denominato example.csv:

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

Quindi, digitare il seguente comando nella riga di comando:

$CsvContents

Vengono restituiti i seguenti dati:

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

Se si desidera visualizzare solo il valore contenuto nella colonna InternalAddress della terza riga, è possibile utilizzare il seguente comando:

$CsvContents[2].InternalAddress

Viene restituito il valore *.contoso.co.uk.

Una volta analizzato questo esempio, sarà più semplice comprendere come Exchange Management Shell elabora il file CSV e lo utilizza per passare i dati al cmdlet New-AddressRewriteEntry.

Come si può vedere in questo esempio, ciascuna riga nel file CSV diventa un elemento di array e ciascuna colonna diventa una proprietà di tale elemento. Utilizzando il cmdlet ForEach , Exchange Management Shell può spostarsi automaticamente nell'array dall'inizio alla fine ed eseguire azioni per ciascun elemento di array, in questo caso una riga del file CSV. Una volta passato un elemento di array al cmdlet ForEach nella pipeline, Exchange Management Shell può accedere alle proprietà memorizzate. In questo caso, le proprietà sono le colonne contenute in ciascuna riga.

Le proprietà possono essere utilizzate per creare il comando New-AddressRewiteEntry necessario per la creazione delle voci di riscrittura degli indirizzi. I nomi delle proprietà vengono assegnati in base alle intestazioni di colonna nel file CSV. Non è necessario che corrispondano al nome del parametro nel cmdlet. Il seguente comando è stato creato in base alle indicazioni riportate in questo esempio:

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

Questo comando esegue il loop di ciascuna riga nel file example.csv e utilizza il cmdlet New-AddressRewriteEntry per creare le voci di riscrittura di indirizzi utilizzando i valori del parametro ottenuti dalle colonne esistenti in ciascuna riga.

Probabilmente è stata notata la presenza in questo comando della variabile speciale $_. La variabile speciale $_ indica al comando di esaminare l'oggetto corrente nella pipeline. In questo caso, si tratta della riga corrente del file CSV.

Le proprietà OutboundOnly e ExceptionList contengono anche del testo aggiuntivo intorno alle rispettive proprietà. Il testo ([Bool]::Parse($_.OutboundOnly)) indica a Exchange Management Shell di interpretare la stringa contenuta nella proprietà OutboundOnly come un valore booleano. Il testo ($_.ExceptionList.Split(",")) indica a Exchange Management Shell di suddividere i valori multipli contenuti nella proprietà ExceptionList utilizzando le virgole. Senza il testo che circonda la proprietà ExceptionList, i valori contenuti nella proprietà ExceptionList vengono trattati come una singola stringa, anche se sono presenti virgole.

Per ulteriori informazioni sul pipelining, vedere Pipelining.

Importazione di un file CSV per creare più voci di riscrittura di indirizzi

Una volta appreso il funzionamento interno, è possibile creare un file CSV e utilizzarlo per creare più voci di riscrittura di indirizzi. Creare un file CSV contenente almeno le colonne Name, InternalAddress e ExternalAddress. Se si desidera specificare dei valori per i parametri ExternalAddress e OutboundOnly, aggiungere anche le relative colonne. È necessario che in ciascuna riga sia presente un valore in ciascuna colonna. Per un esempio di un file CSV correttamente formattato, vedere gli esempi in "Esempio di un file CSV con i parametri facoltativi popolati" più indietro in questo argomento.

Utilizzare la sintassi di comando riportata di seguito per creare più voci di riscrittura di indirizzo utilizzando un file 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(","))}

Per utilizzare un file CSV in Exchange Management Shell per creare più voci di riscrittura di indirizzo

1. Creare e popolare un file CSV denominato C:\ImportAddressRewriteEntries.csv

2. Eseguire il comando riportato di seguito:

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

Per ulteriori informazioni sulla sintassi e sui parametri, vedere New-AddressRewriteEntry.