Condividi tramite

Set-SendConnector (RTM)

  • Articolo

 

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

Ultima modifica dell'argomento: 2007-08-27

Il cmdlet Set-SendConnector consente di modificare il connettore di invio su un computer in cui sia installato il ruolo del server Trasporto Hub o Trasporto Edge.

Sintassi

Set-SendConnector -Identity <SendConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

Set-SendConnector [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Instance <SmtpSendConnectorConfig>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

Descrizione dettagliata

Il cmdlet Set-SendConnector consente di modificare un connettore di invio esistente. Il parametro Identity è obbligatorio quando si esegue il cmdlet Set-SendConnector. Il parametro Identity è obbligatorio solo quando viene modificato il valore del parametro Name.

Una volta completata l'attività, il connettore di invio è stato modificato.

Per eseguire il cmdlet Set-SendConnector, è necessario utilizzare un account a cui sia stato delegato il ruolo Exchange Server Administrator e gruppo Administrators locale del server di destinazione.

Per eseguire il cmdlet Set-SendConnector 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 Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.SendConnectorIdParameter

Il parametro Identity consente di specificare il GUID o il nome del connettore che rappresenta il connettore di invio che si desidera modificare

AddressSpaces

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro è obbligatorio a meno che questo connettore non sia collegato a un connettore di ricezione. Se si specifica un connettore di ricezione collegato utilizzando il parametro LinkedReceiveConnector, il valore di AddressSpaces deve essere $null. In caso contrario, il parametro AddressSpaces specifica i nomi di dominio a cui il connettore di invio invia i messaggi. È possibile specificare più spazi indirizzo separandoli con una virgola. La sintassi completa per l'immissione di ciascun spazio indirizzo è indicata di seguito:

<ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • ConnectorScope   Se si specifica il valore Local, il connettore può essere utilizzato solo dagli altri server Trasporto Hub che si trovano nello stesso sito di Active Directory del server Trasporto Hub di origine sul quale viene eseguito il cmdlet New-SendConnector. Se si omette il qualificatore ConnectorScope, il connettore può essere utilizzato da tutti i server Trasporto Hub che si trovano nell'intera organizzazione di Exchange 2007.

  • AddressSpaceType   In caso di spazi indirizzo SMTP questo valore deve essere necessariamente SMTP. Mentre in caso di spazi indirizzo non SMTP può essere qualsiasi stringa di testo descrittiva, ad esempio "Lotus Notes".

  • AddressSpace   Per gli spazi indirizzo SMTP è possibile utilizzare il carattere jolly (*) nel DNS (Domain Name System) definito in RFC 1035. È ad esempio possibile specificare "*", "*.com." o *.contoso.com". Per gli spazi indirizzo non SMTP, è possibile utilizzare caratteri jolly (*) e altri caratteri, ad esempio "*contoso.com" o "@contoso".

  • AddressSpaceCost   L'intervallo di input valido è compreso tra 1 e 100. Un costo inferiore indica una route migliore. Si tratta di un parametro facoltativo. Se si omette il qualificatore AddressSpaceCost quando si inserisce uno spazio indirizzo utilizzando la sintassi completa, viene considerato un costo pari a 1.

Nei casi illustrati di seguito è necessario specificare il parametro AddressSpaces utilizzando la sintassi completa:

  • Connettori con ambito con qualificatore Local

  • Spazi indirizzo non SMTP

  • Spazi indirizzo SMTP con costo diverso da 1

Se come valore del parametro AddressSpaces si immette un nome di dominio o un elenco di nomi di dominio separato da virgole, verranno specificati automaticamente lo spazio dei nomi di tipo SMTP e un costo pari a 1 per ogni nome di dominio. Mentre i connettori di invio configurati nei server Trasporto Edge supportano solo gli spazi indirizzo di tipo SMTP, quelli configurati nei server Trasporto Hub supportano sia gli spazi indirizzo SMTP sia gli spazi indirizzo non SMTP.

AuthenticationCredential

Facoltativo

System.Management.Automation.PSCredential

Questo parametro richiede la creazione e il passaggio di un oggetto credenziale. L'oggetto credenziale viene creato utilizzando il cmdlet Get-Credential. Per ulteriori informazioni sul cmdlet Get-Credential, digitare Get-Help Get-Credential in Exchange Management Shell.

Comment

Facoltativo

System.String

È necessario racchiudere il parametro Comment tra virgolette doppie, ad esempio: "this is an admin note".

ConnectionInactivityTimeOut

Facoltativo

Microsoft.Exchange.Data.EnhancedTimeSpan

Questo parametro consente di specificare il tempo massimo di apertura di una connessione inattiva. Il valore predefinito è 10 minuti. Per specificare un valore, immettere un intervallo di tempo: gg.hh:mm:ss, dove g = giorni, h = ore, m = minuti e s = secondi. L'intervallo di input valido per questo parametro è compreso tra 00:00:01 e 1.00:00:00.

DNSRoutingEnabled

Facoltativo

System.Boolean

Questo parametro consente di specificare se il routing DNS (Domain Name System) deve essere utilizzato o se tutti i messaggi devono essere inviati tramite lo smart host configurato utilizzando il parametro SmartHosts. Il valore predefinito è $True. Per impostare il valore su $False, è necessario impostare prima un valore nel parametro SmartHosts.

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 nei computer che eseguono il ruolo del server Trasporto Edge. Il ruolo del server Trasporto Edge legge e scrive solo nell'istanza locale ADAM.

DomainSecureEnabled

Facoltativo

System.Boolean

Questo parametro fa parte del processo per abilitare l'autenticazione TLS (Transport Layer Security) reciproca relativa ai domini serviti da questo connettore di invio. L'autenticazione TLS reciproca funziona correttamente solo se si verificano le seguenti condizioni:

  • Il valore del parametro DomainSecureEnabled è impostato su $True.

  • Il valore del parametro DNSRoutingEnabled è impostato su $True.

  • Il valore del parametro IgnoreStartTLS è impostato su $False.

Il carattere jolly asterisco (*) non è supportato in domini configurati per l'autenticazione TLS reciproca. Inoltre, è necessario definire lo stesso dominio sul connettore di ricezione corrispondente e nel valore del parametro TLSReceiveDomainSecureList nel cmdlet Get-TransportConfig.

Il valore predefinito per il parametro DomainSecureEnabled è $False per i tipi di connettori di invio indicati di seguito:

  • Tutti i connettori di invio definiti in un server Trasporto Hub.

  • I connettori di invio creati dall'utente definiti in un server Trasporto Edge.

Il valore predefinito per il parametro DomainSecureEnabled è $True per i tipi di connettori di invio indicati di seguito:

  • Connettori di invio predefiniti configurati in un server Trasporto Edge.

Enabled

Facoltativo

System.Boolean

Questo parametro può assumere il valore $True o $False. Il valore predefinito è $True. Il parametro Enabled consente di abilitare o disabilitare la possibilità per il connettore di elaborare i messaggi di posta elettronica.

Force

Facoltativo

System.Management.Automation.SwitchParameter

Questo parametro consente di eliminare i messaggi di avviso o di conferma che vengono visualizzati durante modifiche specifiche della configurazione.

ForceHELO

Facoltativo

System.Boolean

Questo parametro può assumere il valore $True o $False. Il valore predefinito è $False. Per impostazione predefinita, viene utilizzato EHLO. Se questo parametro è impostato su $True, viene inviato HELO anzichè EHLO.

Fqdn

Facoltativo

Microsoft.Exchange.Data.Fqdn

Questo parametro specifica il FQDN utilizzato come server di origine per i server di messaggistica connessi che si servono del connettore di invio per ricevere i messaggi in uscita. Il valore di questo parametro viene visualizzato sui server di messaggistica connessi ogni volta che è richiesto un nome server di origine, come illustrato negli esempi seguenti:

  • Nel comando EHLO/HELO quando il connettore di invio comunica con il server di messaggistica dell'hop successivo.

  • Nel campo intestazione Received: più recente, che viene aggiunto al messaggio dal server di messaggistica dell'hop successivo dopo che questo lascia il server Trasporto Hub o Trasporto Edge.

  • Durante l'autenticazione TSL

Il valore predefinito per il parametro Fqdn è $Null. Il valore FQDN predefinito effettivo corrisponde pertanto al FQDN del server Trasporto Hub o Trasporto Edge che contiene il connettore di invio.

Nota

Se il connettore di invio è configurato su un server Trasporto Hub in cui è installato anche il ruolo del server Cassette postali, non viene utilizzato alcun valore specificato per il parametro Fqdn. Viene invece sempre utilizzato il nome di dominio completo visualizzato utilizzando il cmdlet Get-ExchangeServer.
Per i server su cui sono installati sia il ruolo del server Trasporto Hub sia il ruolo del server Cassette postali, l'unico modo per eliminare il nome server dalle intestazioni Received: dei messaggi in uscita è utilizzare il cmdlet Remove-ADPermission per rimuovere l'autorizzazione Ms-Exch-Send-Headers-Routing dalle entità di protezione che utilizzano il connettore. Questa azione rimuoverà tutte le intestazioni Received: dal messaggio non appena lascia il server Trasporto Hub. Si consiglia di non rimuovere le intestazioni Received: dei messaggi interni, poiché le intestazioni Received: vengono utilizzate per i calcoli del numero massimo di hop. Per ulteriori informazioni sui cmdlet Remove-ADPermission e Get-ExchangeServer, vedere gli argomenti seguenti:
• Remove-ADPermission (RTM)
• Get-ExchangeServer (RTM)

IgnoreSTARTTLS

Facoltativo

System.Boolean

Questo parametro può assumere il valore $True o $False. Questo parametro consente di specificare se ignorare l'opzione StartTLS offerta da un server di invio remoto. Questo parametro viene utilizzato con i domini remoti. Questo parametro deve essere impostato su $False se il parametro RequireTLS è impostato su $True. Per impostazione predefinta, un connettore di invio con il valore del parametro DNSRoutingEnabled impostato su $True ha anche il valore del parametro IgnoreStartTLS impostato su $False. Pertanto, il connettore di invio negozierà sempre il protocollo TLS eventualmente proposto dal server destinatario. Se il valore del parametro IgnoreStartTLS è impostato su $True, il connettore di invio non tenterà alcuna negoziazione del protocollo TLS con il server destinatario.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig

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

LinkedReceiveConnector

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

Questo parametro consente di imporre tutti i messaggi ricevuti dal connettore di ricezione specificato tramite questo connettore di invio. Per specificare il connettore di ricezione, il valore di LinkedReceivedConnector può utilizzare uno dei seguenti identificatori:

  • GUID

  • Nome distinto (DN)

  • Servername\ConnectorName

Quando si utilizza il parametro LinkReceiveConnector con il cmdlet Set-SendConnector, è necessario utilizzare anche i seguenti parametri con i valori specificati:

  • AddressSpaces $null

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <SmarthostID>

  • SmarthostAuthMechanism <AuthMechanism>

MaxMessageSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Questo parametro consente di specificare la dimensione massima di un messaggio che può essere trasmesso tramite il connettore. Il valore predefinito è 10MB. Se viene immesso un valore, qualificarlo con una delle seguenti unità:

  • B (byte)

  • KB (kilobyte)

  • MB (megabyte)

  • GB (gigabyte)

I valori non qualificati vengono considerati byte. L'intervallo di input valido per questo parametro è compreso tra 0 e 2147483647 byte. Per rimuovere il limite impostato sulla dimensione dei messaggi in un connettore di invio, immettere il valore unlimited.

Name

Facoltativo

System.String

Il parametro Name è il nome del connettore fornito dall'amministratore. Se il nome contiene spazi, è necessario racchiudere il parametro Name tra virgolette doppie, come nel seguente esempio: "New Send Connector".

Port

Facoltativo

System.Int32

L'intervallo di input valido per questo parametro è un numero intero compreso tra 0 e 65535. Il valore predefinito è 25. Se si specifica un valore nel parametro SmartHosts, il valore Port consente di specificare il numero di porta utilizzato per l'inoltro a uno smart host. Nella maggior parte delle organizzazioni, il numero di porta è impostato su 25.

ProtocolLoggingLevel

Facoltativo

Microsoft.Exchange.Data.ProtocolLoggingLevel

Con questo parametro, è possibile abilitare o disabilitare la registrazione protocollo per il connettore di invio specificato. Un valore di Verbose abilita la registrazione protocollo per il connettore. Un valore di None disabilita la registrazione protocollo per il connettore. Il valore predefinito è None. Per tutti i connettori di invio configurati in un server Trasporto Hub o Trasporto Edge, il percorso dei registri di protocollo viene specificata utilizzando il parametro SendProtocolLogPath del comando Set-TransportServer.

RequireTLS

Facoltativo

System.Boolean

Questo parametro consente di specificare se tutti i messaggi inviati attraverso questo connettore devono essere trasmessi utilizzando TLS. Il valore predefinito è $False.

SmartHostAuthMechanism

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig+AuthMechanisms

Questo parametro viene utilizzato durante l'autenticazione di un server remoto. Il parametro viene utilizzato solo quando si configura uno smart host e il parametro DNSRoutingEnabled è impostato su $False. I valori possibili sono None, BasicAuth, BasicAuthRequireTLS, ExchangeServer o ExternalAuthoritative. Tutti i valori si escludono reciprocamente. Se si seleziona BasicAuth o BasicAuthRequireTLS, è necessario utilizzare il parametro AuthenticationCredential per specificare le credenziali di autenticazione.

SmartHosts

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro utilizza uno o più nomi di dominio completi, ad esempio server.contoso.com, o uno o più indirizzi IP, separati da virgole. Se si immette un indirizzo IP, è necessario immettere l'indirizzo IP alla lettera nel modo indicato di seguito: 10.10.1.1. Un'identità smart host può essere il nome di dominio completo (FQDN) di un server smart host, un record di Mail Exchanger (MX) o un record di indirizzo (A, Address). Se si configura un FQDN come identità dello smart host, è necessario che il server di origine per il connettore di invio sia in grado di utilizzare la risoluzione dei nomi DNS per individuare il server smart host.

SourceIPAddress

Facoltativo

System.Net.IPAddress

Questo parametro consente di specificare l'indirizzo IP locale da utilizzare come endpoint per una connessione SMTP a un server di messaggistica remoto. L'indirizzo IP predefinito è 0.0.0.0. Tale valore indica che nel server verrà utilizzato qualsiasi indirizzo IP locale disponibile. Questo parametro è valido solo per i connettori di invio configurati sui server Trasporto Edge.

SourceTransportServers

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro specifica i nomi dei server Trasporto Hub che possono utilizzare il connettore di invio corrente. È possibile specificare i nomi di diversi server Trasporto Hub, utilizzando la virgola come separatore. Questo parametro non è valido per i connettori di invio configurati sui server Trasporto Edge.

UseExternalDNSServersEnabled

Facoltativo

System.Boolean

Questo parametro consente di specificare se il connettore di invio deve utilizzare l'elenco DNS esterno specificato utilizzando il parametro ExternalDNSServers del cmdlet Set-TransportServer. Il valore predefinito è $False. I valori validi per questo parametro sono $True e $False.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Esempio

Nel primo codice di esempio viene mostrato un comando Set-SendConnector che consente di modificare un connettore di invio esistente. Il comando imposta il limite MaxMessageSize su 10 MB e il limite ConnectionInactivityTimeOut su 15 minuti.

Nel secondo codice di esempio vengono mostrati i comandi che consentono di modificare un connettore di invio esistente per l'utilizzo dell'autenticazione quando il connettore invia un messaggio di posta elettronica a Contoso.com. Il server di posta elettronica Contoso.com richiede che il server di Exchange Server 2007 locale venga autenticato per inoltrare i messaggi di posta elettronica. Per configurare il connettore di invio affinché utilizzi l'autenticazione, eseguire prima il comando Get-Credential e assegnare il comando a una variabile. Quando si esegue il comando Get-Credential, il comando richiede il nome utente e la password dell'account che verranno utilizzati per l'autenticazione del server di posta elettronica Contoso.com.

Nell'esempio, il comando Get-Credential è assegnato alla variabile $CredentialObject. Una volta assegnate le credenziali dell'autenticazione alla variabile $CredentialObject, il connettore di invio può essere modificato utilizzando il cmdlet Set-SendConnector. La variabile $CredentialObject viene trasmessa al parametro AuthenticationCredential. Oltre all'impostazione delle credenziali che verranno utilizzate, è necessario impostare il parametro SmartHostAuthMechanism su BasicAuth per indicare al connettore di invio di autenticare il server di posta elettronica Contoso.com utilizzando le credenziali fornite.

Set-SendConnector "Contoso.com Send Connector" -MaxMessageSize 10MB -ConnectionInactivityTimeOut 00:15:00 
$CredentialObject = Get-Credential
Set-SendConnector "E-Mail to Contoso.com" -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth