Condividi tramite


Set-AddressRewriteEntry

 

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

Ultima modifica dell'argomento: 2007-08-28

Il cmdlet Set-AddressRewriteEntry consente di modificare una voce di riscrittura degli indirizzi esistente 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

set-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-WhatIf [<SwitchParameter>]]

set-addressrewriteentry [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-Instance <AddressRewriteEntry>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>] [-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 Trasporto Edge.

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

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

Identity

Obbligatorio

Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter

Questo parametro consente di specificare la voce di riscrittura degli indirizzi da modificare. Il parametro Identity utilizza un GUID, oppure il nome di riscrittura degli indirizzi univoco.

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) del controller di dominio che consente di scrivere la modifica alla configurazione nel servizio directory di Active Directory, includere nel comando il parametro DomainController. Il parametro DomainController non è supportato sui server Trasporto Edge. Il ruolo del server Trasporto Edge prevede solo la scrittura 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.

ExternalAddress

Facoltativo

System.String

Questo parametro consente all'amministratore di modificare 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.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.AddressRewriteEntry

Il parametro Instance consente di trasmettere l'intero oggetto al comando per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare l'intero oggetto al comando.

InternalAddress

Facoltativo

System.String

Questo parametro consente all'amministratore di modificare 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

Facoltativo

System.String

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

OutboundOnly

Facoltativo

System.Boolean

Questo parametro consente all'amministratore di specificare se gli indirizzi di posta elettronica devono essere riscritti solo quando i messaggi di posta elettronica vengono inviati dall'organizzazione di Exchange Server 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.

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

Nei seguenti esempi viene mostrato come modificare una voce di riscrittura degli indirizzi esistente. Nel primo esempio viene impostato il nome del dominio interno da scrivere. Il nome descrittivo di questa voce viene anche modificato in modo da riportare il nuovo nome del dominio da riscrivere.

Nel secondo esempio viene impostato il parametro OutboundOnly su $true. Questa azione comunica all'agente di riscrittura degli indirizzi di riscrivere gli indirizzi solo nei messaggi di posta elettronica in uscita dall'organizzazione di Exchange 2007.

Importante

I mittenti interni interessati da una voce di riscrittura degli indirizzi il cui parametro OutboundOnly è impostato su $true devono disporre di un indirizzo proxy configurato che corrisponde all'indirizzo di posta elettronica riscritto.

Set-AddressRewriteEntry "Address rewrite entry for contoso.com" -Name "Address rewrite entry for northwindtraders.com" -InternalAddress northwindtraders.com 
Set-AddressRewriteEntry "Address rewrite entry for all contoso.com e-mail addresses" -OutboundOnly:$true