Set-AddressRewriteEntry
Questo cmdlet è disponibile o efficace solo nei server Trasporto Edge in Exchange locale.
Utilizzare il cmdlet Set-AddressRewriteEntry per modificare una voce di riscrittura degli indirizzi esistente che riscrive gli indirizzi di posta elettronica del mittente e del destinatario nei messaggi inviati o ricevuti dall'organizzazione tramite un server trasporto Edge.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-AddressRewriteEntry
[-Identity] <AddressRewriteEntryIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-ExceptionList <MultiValuedProperty>]
[-ExternalAddress <String>]
[-InternalAddress <String>]
[-Name <String>]
[-OutboundOnly <Boolean>]
[-WhatIf]
[<CommonParameters>] Descrizione
Sui server Trasporto Edge, è necessario essere membri del gruppo di amministratori locale per eseguire questo cmdlet.
Esempio
Esempio 1
Set-AddressRewriteEntry "Address rewrite entry for contoso.com" -Name "Address rewrite entry for northwindtraders.com" -InternalAddress northwindtraders.comQuesto esempio consente di modificare la voce esistente di riscrittura dell'indirizzo denominata "Voce di riscrittura dell'indirizzo per contoso.com", utilizzando le seguenti impostazioni:
Modifica gli indirizzi di posta elettronica originali, interessati dalla voce di riscrittura dell'indirizzo, in tutti gli indirizzi presenti nel dominio northwindtraders.com.
Modifica il valore Nome in "Voce di riscrittura dell'indirizzo per northwindtraders.com".
Esempio 2
Set-AddressRewriteEntry "Address rewrite entry for all contoso.com email addresses" -OutboundOnly $trueQuesto esempio consente di modificare la voce di riscrittura degli indirizzi esistente denominata "Voce di indirizzo per tutti gli indirizzi di posta elettronica contoso.com" da in ingresso e in uscita a soltanto in uscita. È necessario configurare un indirizzo proxy che corrisponda all'indirizzo di posta elettronica riscritto per tutti i destinatari interessati.
Parametri
-Confirm
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
Il parametro DomainController non è supportato sui server Trasporto Edge. Un server Trasporto Edge usa l'istanza locale di Active Directory Lightweight Directory Services (AD LDS) per leggere e scrivere i dati.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExceptionList
Il parametro ExceptionList consente di specificare i nomi di dominio da escludere dalla riscrittura dell'indirizzo, ne caso in cui il parametro InternalAddress contenga un valore che specifica più nomi di dominio. È possibile separare più nomi di dominio inclusi nel parametro ExceptionList con le virgole. Per altre informazioni su come aggiungere o rimuovere valori da proprietà multivalore, vedere Modifica di proprietà multivalore.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalAddress
Il parametro ExternalAddress specifica gli indirizzi di posta elettronica finali desiderati. Se il parametro InternalAddress specifica un singolo indirizzo di posta elettronica (chris@contoso.com), il parametro ExternalAddress deve specificare anche un singolo indirizzo di posta elettronica (support@contoso.com). Se il parametro InternalAddress specifica un solo dominio (contoso.com) o un dominio e tutti i sottodomini (*.contoso.com), il parametro ExternalAddress deve specificare un solo dominio (fabrikam.com).
Non è possibile utilizzare il carattere jolly (*) con il parametro ExternalAddress.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Il parametro Identity consente di specificare la voce di riscrittura degli indirizzi che si desidera modificare. È possibile specificare il nome o il GUID della voce di riscrittura dell'indirizzo.
| Type: | AddressRewriteEntryIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalAddress
Il parametro InternalAddress specifica gli indirizzi di posta elettronica originali da modificare. È possibile utilizzare i seguenti valori:
- Indirizzo di posta elettronica singolo: david@contoso.com
- Dominio singolo: contoso.com o sales.contoso.com
- Dominio e tutti i sottodomini: *.contoso.com
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
Il parametro Name consente di specificare un nome univoco per questa voce di riscrittura su tutti gli indirizzi.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-OutboundOnly
Il parametro OutboundOnly abilita o disabilita la riscrittura degli indirizzi solo in uscita. L'input valido per questo parametro è $true o $false. Il valore $true significa che la riscrittura degli indirizzi si verifica solo nella posta in uscita. Il valore $false significa che la riscrittura degli indirizzi si verifica nella posta in uscita e anche in quella in arrivo (gli indirizzi di posta elettronica riscritti vengono rimodificati con quelli originali nella posta in entrata). Il valore predefinito è $false.
È necessario impostare questo parametro su $true se il parametro InternalAddress contiene il carattere jolly per riscrivere gli indirizzi in un dominio e in tutti i sottodomini (*.contoso.com).
Inoltre, quando si configura la riscrittura degli indirizzi solo in uscita, è necessario configurare l'indirizzo di posta elettronica riscritto come un indirizzo proxy nei destinatari interessati. Ad esempio, se laura@sales.contoso.com viene riscritto in laura@contoso.com, l'indirizzo laura@contoso.com proxy deve essere configurato nella cassetta postale di Laura. In questo modo le risposte e i messaggi in arrivo vengono recapitati correttamente.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.