Condividi tramite

Set-SendConnector

  • Articolo

 

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

Ultima modifica dell'argomento: 2007-08-27

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

Sintassi

Set-SendConnector -Identity <SendConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-IsScopedConnector <$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>] [-WhatIf [<SwitchParameter>]]

Set-SendConnector [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-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>] [-IsScopedConnector <$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>] [-WhatIf [<SwitchParameter>]]

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 che disponga della delega del ruolo Exchange Server Administrator e del 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. La sintassi completa per l'inserimento di ciascuno spazio indirizzo è indicata di seguito: <AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   In un server Trasporto edge il tipo di spazio indirizzo deve essere SMTP. In un server Trasporto Hub il tipo di spazio indirizzo può essere SMTP, X400 o qualsiasi altra stringa di testo. Se si omette il tipo di spazio indirizzo, viene considerato implicitamente un tipo di spazio indirizzo SMTP.

  • AddressSpace   Per i tipi di spazio indirizzo SMTP, lo spazio indirizzo immesso deve essere conforme a RFC 1035. Ad esempio, *, *.com e *.contoso.com sono consentiti, ma *contoso.com non è consentito. Per i tipi di spazio indirizzo X.400, lo spazio indirizzo immesso deve essere conforme a RFC 1685, ad esempio o=MySite;p=MyOrg;a=adatum;c=us. Per tutti gli altri valori del tipo di indirizzo, è possibile immettere qualsiasi testo per lo spazio indirizzo.

  • 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 costo di uno spazio indirizzo, viene considerato implicitamente un costo di 1. Se si immette uno spazio indirizzo non SMTP contenente un punto e virgola ( ; ), è necessario specificare il costo dello spazio indirizzo.

Se si specifica il tipo di spazio indirizzo o il costo dello spazio indirizzo, è necessario includere lo spazio indirizzo tra virgolette doppie ( " ). Ad esempio, le seguenti voci di spazio indirizzo sono equivalenti:

  • "SMTP:contoso.com;1"

  • "contoso.com;1"

  • "SMTP:contoso.com"

  • contoso.com

È possibile specificare più spazi indirizzo separandoli con una virgola nel modo indicato di seguito: contoso.com,fabrikam.com. Se si specifica il tipo di spazio indirizzo o il costo dello spazio indirizzo, è necessario includere lo spazio indirizzo tra virgolette doppie ( " ). "contoso.com;2","fabrikam.com;3".

Se si specifica un tipo di spazio indirizzo non SMTP su un connettore di invio configurato in un server Trasporto Hub, è necessario impostare le seguenti impostazioni sul connettore di invio:

  • È necessario utilizzare uno smart host per eseguire il routing dei messaggi di posta elettronica specificando un valore per il parametro SmartHosts.

  • È necessario impostare il parametro DNSRoutingEnabled su $False.

Nota

Sebbene sia possibile configurare spazi indirizzi non SMTP su un connettore di invio in un server Trasporto Hub, il connettore di invio utilizza SMTP come meccanismo di trasporto per l'invio dei messaggi ad altri server di messaggistica. I connettori esterni su server Trasporto Hub vengono utilizzati per l'invio di messaggi a server di messaggistica locali, ad esempio i server gateway fax di terze parti, che non utilizzano SMTP come meccanismo di trasporto primario. Per ulteriori informazioni, vedere Connettori esterni.

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".

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.

ConnectionInactivityTimeOut

Facoltativo

Microsoft.Exchange.Data.EnhancedTimeSpan

Questo parametro consente di specificare il tempo massimo per cui una connessione inattiva può rimanere aperta. 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 parametroSmartHosts. 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 le modifiche alla configurazione nel servizio directory di Active Directory, includere nel comando il parametro DomainController. Il parametro DomainController non è supportato in computer su cui è in esecuzione il ruolo del server Trasporto Edge. Il ruolo del server Trasporto Edge prevede solo la scrittura e la lettura nell'istanza locale ADAM.

DomainSecureEnabled

Facoltativo

System.Boolean

La specifica di questo parametro fa parte del processo di attivazione dell'autenticazione TLS (Transport Layer Security) reciproca per i domini serviti dal connettore di invio corrente. 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.

Nei domini configurati per l'autenticazione TLS reciproca non è possibile utilizzare caratteri jolly (*). Lo stesso dominio deve inoltre essere definito in base al connettore di ricezione e al valore del parametro TLSReceiveDomainSecureList del cmdlet Get-TransportConfig.

Per i tipi di connettori di invio elencati di seguito il valore predefinito di DomainSecureEnabled è $False:

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

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

Per i tipi di connettori di invio elencati di seguito il valore predefinito di DomainSecureEnabled è $True:

  • 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 alla configurazione.

ForceHELO

Facoltativo

System.Boolean

I valori validi per questo parametro sono $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 consente di specificare il nome di dominio completo (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 nell'esempio seguente:

  • 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 TLS

Il valore predefinito per il parametro Fqdn è $Null. Ciò significa che il valore del nome di dominio completo attuale predefinito è il nome di dominio completo del server Trasporto Hub o Trasporto Edge contenente 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 del 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
• Get-ExchangeServer

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. Se il parametro RequireTLS è impostato su $True, questo parametro deve essere impostato su $False. Per impostazione predefinita, quando il parametro DNSRoutingEnabled di un connettore predefinito è impostato su $True, il parametro IgnoreStartTLS del connettore viene impostato su $False. Pertanto, il connettore di invio negozierà sempre il protocollo TLS eventualmente proposto dal server ricevente. Se il valore del parametro IgnoreStartTLS è impostato su $True, il connettore di invio non tenterà alcuna negoziazione del protocollo TLS con il server ricevente.

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.

IsScopedConnector

Facoltativo

System.Boolean

Questo parametro consente di controllare la disponibilità del connettore per altri server Trasporto Hub. Quando il valore del parametro è $False, tutti i server Trasporto Hub nell'organizzazione di Exchange possono utilizzare il connettore. Quando il valore del parametro è $True, solo i server Trasporto Hub nello stesso sito di Active Directory possono utilizzare il connettore. Il valore predefinito è $False.

LinkedReceiveConnector

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

Questo parametro impone il passaggio attraverso tale connettore di invio a tutti i messaggi che vengono ricevuti dal connettore di ricezione specificato. Per il valore di LinkedReceivedConnector è possibile utilizzare uno dei seguenti identificatori per specificare il connettore di ricezione:

  • GUID

  • Nome distinto (DN)

  • NomeServer\NomeConnettore

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 <IDSmartHost>

  • 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 si immette un altro valore, qualificarlo con una delle seguenti unità:

  • B (byte)

  • KB (kilobyte)

  • MB (megabyte)

  • GB (gigabyte)

I valori non qualificati vengono considerati byte. I valori immessi in byte vengono arrotondati per eccesso al kilobyte successivo. Ad esempio, 1048575B viene arrotondato a 1MB e 1048577 viene arrotondato a 1025KB. L'intervallo di input valido per questo parametro è compreso tra 0 e 2147483647 byte. Per rimuovere il limite impostato sulle dimensioni 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 degli spazi, è necessario racchiudere il parametro Name tra virgolette doppie, come nel seguente esempio: "New Send Connector".

Port

Facoltativo

System.Int32

La gamma di immissione valida per questo parametro è costituita da valori interi compresi tra 0 e 65535 byte. 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

Questo parametro consente di attivare o disattivare la registrazione del protocollo per il connettore di invio selezionato. Se il valore del parametro è Verbose, la registrazione del protocollo per il connettore viene attivata. Se il valore del parametro è None, la registrazione del protocollo per il connettore viene disattivata. Il valore predefinito è None. Per tutti i connettori di invio configurati in un server Trasporto Hub o Edge Transport, la posizione dei registri dei protocolli 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 (Transport Layer Security). 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 e 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 seguente: 10.10.1.1. L'identità dello 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 indirizzi (A). Se si configura un nome di dominio completo 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 indica 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.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente di indicare al comando di simulare le azioni da eseguire 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

 

 

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 Exchange Server 2007 locale venga autenticato per inoltrare i messaggi di posta elettronica. Per configurare il connettore di invio all'utilizzo dell'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 cmdletSet-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 ordinare 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