Share via


New-AddressRewriteEntry

 

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

Ultima modifica dell'argomento: 2010-10-20

Il cmdlet New-AddressRewriteEntry consente di creare una nuova voce di riscrittura degli indirizzi che riscriva gli indirizzi di posta elettronica del mittente e del destinatario nei messaggi di posta elettronica inviati e ricevuti da un'organizzazione di posta elettronica.

Sintassi

new-AddressRewriteEntry -Name <String> -ExternalAddress <String> -InternalAddress <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-OutboundOnly <$true | $false>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

In Microsoft Exchange Server 2007, la riscrittura degli indirizzi consente di modificare gli indirizzi dei mittenti e dei destinatari nei messaggi in entrata e in uscita di un'organizzazione di Exchange 2007. È possibile configurare gli agenti di riscrittura degli indirizzi sul connettore di ricezione e sul connettore di invio in un computer in cui è installato il ruolo del server Edge Transport.

Per eseguire il cmdlet New-AddressRewriteEntry in 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.

Nota

È possibile utilizzare un solo indirizzo di posta elettronica e non si può mappare più indirizzi e-mail su uno solo.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

ExternalAddress

Obbligatorio

System.String

Questo parametro specifica l'indirizzo di posta elettronica esterno o il nome di dominio utilizzato per la riscrittura di un indirizzo di posta elettronica interno o di un nome di dominio. Se viene specificato un indirizzo di posta elettronica in InternalAddress, anche il valore specificato in ExternalAddress deve essere un indirizzo di posta elettronica. Se viene specificato un nome di dominio o un nome di dominio con un carattere jolly in InternalAddress, in ExternalAddress deve essere specificato un nome di dominio. Gli indirizzi o i nomi di dominio possono essere immessi nei due seguenti formati:

  • Indirizzo di posta elettronica   Riscrittura di un solo indirizzo di posta elettronica interno utilizzando l'indirizzo specificato. Ad esempio, david@northwindtraders.com.

  • Nome di dominio   Riscrittura di tutti gli indirizzi di posta elettronica interni inclusi in InternalAddress utilizzando il nome di dominio esterno specificato. Ad esempio, northwindtraders.com.

Nota

Il carattere di asterisco non può essere utilizzato con il parametro ExternalAddress.

InternalAddress

Obbligatorio

System.String

Questo parametro specifica l'indirizzo di posta elettronica interno o il nome di dominio da riscrivere. Gli indirizzi o i nomi di dominio possono essere immessi nei tre seguenti formati:

  • Indirizzo di posta elettronica singolo   Riscrittura solo dell'indirizzo specificato. Ad esempio, david@contoso.com.

  • Nome di dominio   Riscrittura di tutti gli indirizzi di posta elettronica associati al nome di dominio specificato. Ad esempio, contoso.com.

  • Nome di dominio con asterisco   Riscrittura di tutti gli indirizzi di posta elettronica associati al nome di dominio specificato e a tutti i sottodomini. Ad esempio, *.contoso.com.

Name

Obbligatorio

System.String

Questo parametro consente all'amministratore di modificare il nome univoco per questa voce di riscrittura degli indirizzi.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Confirm consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN, fully qualified domain name) del controller di dominio che scrive la modifica alla configurazione nel servizio directory di Active Directory, includere nel comando il parametro DomainController. Il parametro DomainController non è supportato sui server Edge Transport. Il ruolo del server Edge Transport consente di scrivere solo nell'istanza locale ADAM.

ExceptionList

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro specifica i nomi di dominio da non riscrivere quando il parametro InternalAddress contiene un valore che specifica più nomi di dominio. È possibile separare più nomi di dominio inclusi nel parametro ExceptionList con le virgole. Per ulteriori informazioni su come aggiungere o rimuovere valori dalle proprietà multivalore, vedere Modifica delle proprietà multivalore.

OutboundOnly

Facoltativo

System.Boolean

Questo parametro consente di specificare se gli indirizzi di posta elettronica devono essere riscritti solo quando i messaggi di posta elettronica vengono inviati dall'organizzazione di Exchange 2007 oppure se gli indirizzi devono essere riscritti quando i messaggi vengono inviati in entrambe le direzioni. I due possibili valori per questo parametro sono $true o $false. Il valore predefinito è $false.

Nota

Questo parametro non può essere impostato su $false se il valore specificato in InternalAddress contiene un carattere jolly.

TemplateInstance

Facoltativo

System.Management.Automation.PSObject

Quando per questo parametro viene specificato un oggetto esistente, il comando utilizza la configurazione dell'oggetto per creare un oggetto duplicato in un server locale o di destinazione. Per ulteriori informazioni, vedere Modelli.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

Eccezioni

Eccezioni Descrizione

 

Esempio

I seguenti esempi illustrano tre differenti scenari:

  • Riscrittura di un solo indirizzo di posta elettronica. I messaggi di posta elettronica in entrambe le direzioni vengono riscritti.

  • Riscrittura di tutti gli indirizzi di posta elettronica per il dominio contoso.com. I messaggi di posta elettronica in entrambe le direzioni vengono riscritti.

  • Riscrittura di tutti gli indirizzi di posta elettronica per il dominio contoso.com, e per tutti i sottodomini, eccetto research.contoso.com e corp.contoso.com. Solo i messaggi di posta elettronica in uscita vengono riscritti.

New-AddressRewriteEntry -Name "Address rewrite entry for david@contoso.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com e-mail addresses" -InternalAddress contoso.com -ExternalAddress northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com and subdomain e-mail addresses" -InternalAddress *.contoso.com -ExternalAddress northwindtraders.com -OutboundOnly:$true -ExceptionList research.contoso.com,corp.contoso.com