Condividi tramite

New-SendConnector (RTM)

  • Articolo

 

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

Ultima modifica dell'argomento: 2007-08-27

Utilizzare il cmdlet New-SendConnector per creare un nuovo connettore di invio su un computer su cui è installato il ruolo del server Trasporto Hub o il ruolo del server Trasporto Edge.

Sintassi

New-SendConnector -Name <String> -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>] [-MaxMessageSize <Unlimited>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>]

New-SendConnector -Name <String> [-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>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>]

Descrizione dettagliata

Questo cmdlet crea un nuovo connettore di invio. Per visualizzare la richiesta dei parametri obbligatori per un nuovo connettore di invio, inserire New-SendConnector. Dopo aver completato questa operazione, viene creato un nuovo connettore di invio.

Per eseguire il cmdlet New-SendConnector, all'account utilizzato deve essere delegato il ruolo Exchange Server Administrator e il gruppo Administrators locale per il server di destinazione.

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

AddressSpaces

Obbligatorio

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro è obbligatorio a meno che questo connettore non sarà collegato a un connettore di ricezione utilizzando il parametro LinkedReceiveConnector. Il parametro AddressSpaces consente di specificare 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'inserimento di ciascuno 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 Exchange 2007.

  • AddressSpaceType   Su un server Trasporto Edge, il tipo di spazio indirizzo deve essere SMTP. Su un server di Trasporto Hub, il tipo di spazio indirizzo può essere SMTP, X400, o qualunque altra stringa di testo. Se il tipo di spazio indirizzo viene tralasciato, verrà utilizzato un tipo di spazio indirizzo SMTP.

  • AddressSpace   Per tipi di spazio indirizzo SMTP, lo spazio indirizzo inserito deve essere conforme all'RFC 1035. Ad esempio, *, *.com, e *.contoso.com sono permessi, ma *contoso.com non è permesso. Per tipi di spazio indirizzo X.400, la spazio indirizzo inserito deve essere conforme al RFC 1685, ad esempio o=MySite;p=MyOrg;a=adatum;c=us. Per quanto riguarda tutti gli atri valori di tipo indirizzo, è possibile inserire qualunque testo per lo spazio indirizzo.

  • AddressSpaceCost   La gamma di immissione valida per i costi del connettore è tra 1 e 100. Un costo inferiore indica una route migliore. Si tratta di un parametro facoltativo. Se il costo di spazio indirizzo viene tralasciato, verrà utilizzato il costo 1. Se si inserisce uno spazio indirizzo non SMTP che contiene il carattere punto e virgola ( ; ), è necessario specificare il costo di spazio indirizzo.

È necessario utilizzare la sintassi completa per il parametro AddressSpaces solo nel caso delle condizioni indicate di seguito:

  • Connettori con ambito con qualificatore Local

  • Spazi indirizzo non SMTP

  • Spazi indirizzo SMTP con un costo diverso da 1

È possibile specificare più spazi indirizzo separandoli con una virgola. Ad esempio: contoso.com,fabrikam.com. Se si specifica l'ambito del connettore, il tipo di spazio indirizzo o il costo di spazio indirizzo, è necessario racchiudere lo spazio indirizzo tra virgolette doppie ( " ), ad esempio: "contoso.com;2","fabrikam.com;3".

Se si specifica un tipo di spazio indirizzo non SMTP su un connettore di invio configurato su un server di Trasporto Hub, sono necessarie le seguenti impostazioni sul connettore di invio:

  • È necessario utilizzare uno smart host per indirizzare e-mail mediante un valore per il parametro SmartHosts.

  • È necessario impostare il parametro DNSRoutingEnabled su $False.

Nota

Anche se è possibile configurare spazi indirizzo non SMTP su un connettore di invio su un server Trasporto Hub, il connettore di invio utilizzerà SMTP come meccanismo di trasporto per inviare messaggi agli altri server di messaggistica. I connettori esterni sui server Trasporto Hub vengono utilizzati per inviare messaggi ai server di messaggistica locali, come ad esempio server gateway fax di terze parti che non utilizzano SMTP come meccanismo di trasporto principale. Per ulteriori informazioni, vedere Connettori esterni.

Name

Obbligatorio

System.String

Questo parametro è 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".

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, come nel seguente 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: dd.hh:mm:ss, dove d = 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

I valori validi per il parametro DnsRoutingEnabled sono $True o $False. Il valore predefinito è $True. Se si specifica un parametro SmartHosts, è necessario che il parametro DnsRoutingEnabled sia $False nella stessa riga di comando.

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 condizioni indicate di seguito:

  • 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 (*) non è supportato in domini configurati per l'autenticazione TLS reciproca. Inoltre, è necessario definire lo stesso dominio sul corrispondente connettore di ricezione 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 connettori definiti su un server Trasporto Hub;

  • i connettori di invio creati da un utente definiti su un server Trasporto Edge.

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

  • i connettori di invio predefiniti definiti su un server Trasporto Edge.

Enabled

Facoltativo

System.Boolean

Valori validi per questo parametro sono $True oppure $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

Valori validi per questo parametro sono $True oppure $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 nome di dominio completo (FQDN) utilizzato come server di origine per i server di messaggistica che si servono di un connettore di invio per ricevere messaggi in uscita. Il valore di questo parametro viene visualizzato su server di messaggistica connessi ogni volta che è necessario un nome server di origine, come ad esempio:

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

  • Nel campo di intestazione del messaggio Received: più recente aggiunto al messaggio mediante il server di messaggistica dell'hop successivo, dopo che il messaggio ha lasciato il server di Trasporto Edge o il server di Trasporto Hub

  • Nel corso dell'autenticazione TLS

Il valore predefinito per il parametro Fqdn è $Null. Ciò significa che il reale valore del nome di dominio completo (FQDN) predefinito è il FQDN del server di Trasporto Edge o del server di Trasporto Hub che contiene il connettore di invio.

Nota

Se il connettore di invio è configurato su un server di Trasporto Hub che ha installato anche il ruolo del server Cassette postali, qualunque valore specificato per il parametro Fqdn non verrà utilizzato. Invece il FQDN del server visualizzato mediante il cmdlet Get-ExchangeServer viene sempre utilizzato.
Per server che hanno installati sia il ruolo del server Cassette postali sia il ruolo del server Trasporto Hub, l'unico modo di rimuovere il nome del server dalle intestazioni Received: del messaggio in uscita è l'utilizzo del cmdlet Remove-ADPermission per togliere l'autorizzazione Ms-Exch-Send-Headers-Routing dalle identità di protezione che utilizzano il connettore. Questa operazione rimuoverà tutte le intestazioni Received: dal messaggio quando questo lascia il server di Trasporto Hub. È consigliabile non rimuovere le intestazioni Received: per messaggi interni, dato che le intestazioni Received: vengono utilizzate per il calcolo del numero di hop massimo. Per ulteriori informazioni sul cmdlet Remove-ADPermission e il cmdlet Get-ExchangeServer, vedere i seguenti argomenti:
• Remove-ADPermission (RTM)
• Get-ExchangeServer (RTM)

IgnoreSTARTTLS

Facoltativo

System.Boolean

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. Il parametro deve essere impostato su $False se il parametro RequireTLS è impostato su $True. I valori validi per questo parametro sono $True e $False.

LinkedReceiveConnector

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

Questo parametro consente di eliminare 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 New-SendConnector, è necessario utilizzare anche i seguenti parametri con i valori specificati:

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <SmarthostID>

  • SmarthostAuthMechanism <AuthMechanism>

Quando si utilizza il parametro LinkedReceiveConnector, non si può utilizzare anche il parametro AddressSpace.

MaxMessageSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il valore MaxMessageSize consente di specificare la dimensione massima di un messaggio che viene trasmesso tramite un connettore. È possibile sovraccaricare il parametro immettendo unlimited, se non si desidera imporre dei limiti ai messaggi trasmessi attraverso il connettore. Il valore predefinito è 10MB. Se viene immesso un numero intero, qualificare il valore con una delle seguenti unità:

  • B (byte)

  • KB (kilobyte)

  • MB (megabyte)

  • GB (gigabyte)

I valori non qualificati vengono considerati byte. I valori inseriti in byte vengono arrotondati al kilobyte più vicino. Ad esempio, 1048575B viene arrotondato a 1MB, e 1048577 a 1025KB. L'intervallo di input valido per questo parametro è compreso tra 0 e 2147483647 byte.

Port

Facoltativo

System.Int32

La gamma di immissione valida 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 di protocollo per il connettore di invio specificato. Un valore di Verbose abilita la registrazione di protocollo per il connettore. Un valore di None disabilita la registrazione di protocollo per il connettore. La posizione dei registri di protocollo del connettore di invio relativa a tutti i connettori di invio configurati su un server Trasporto Hub oppure su un server Trasporto Edge viene specificata utilizzando il parametro SendProtocolLogPath del cmdlet 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 validi 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 è necessario se il parametro DnsRoutingEnabled viene impostato su $False ed è necessario specificarlo nella stessa riga di comando. Il parametro SmartHosts utilizza uno o più nomi di dominio completi (FQDN), ad esempio server.contoso.com, oppure uno o più indirizzi IP o una combinazione di nomi di dominio completi e indirizzi IP. Separare ciascun valore utilizzando una virgola. 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 scambio della posta (MX) o un record di indirizzo (A). 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 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.

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.

Usage

Facoltativo

Microsoft.Exchange.Management.SystemConfigurationTasks.NewSendConnector+UsageType

Questo parametro consente di configurare i valori predefiniti del connettore in base all'utilizzo del connettore. Di seguito sono riportati i valori validi per il parametro: Custom, Internal, Internet o Partner. Per ulteriori informazioni sulle opzioni di utilizzo del connettore di invio, vedere Connettori di invio.

UseExternalDNSServersEnabled

Facoltativo

System.Boolean

Questo parametro consente di specificare se il connettore di invio deve utilizzare l'elenco DNS (Domain Name System) esterno che è specificato tramite 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 esempio viene descritto il comando che consente di creare un nuovo connettore di invio per l'invio di messaggi di posta elettronica su Internet. Nell'esempio vengono descritti i parametri minimi necessari per creare un connettore di invio. Lo spazio indirizzi è limitato e consente di inviare messaggi solo al dominio Contoso.com e al dominio Microsoft.com.

Nel secondo esempio vengono descritti i comandi che consentono di creare un nuovo connettore di invio per l'invio di messaggi di posta elettronica a Contoso.com. Il server di posta elettronica Contoso.com richiede che il server Exchange 2007 locale venga autenticato per inoltrare i messaggi di posta elettronica. Per configurare il connettore di invio all'utilizzo dell'autenticazione, è necessario eseguire prima il comando Get-Credential e assegnare tale comando a una variabile. Quando si esegue il comando Get-Credential, vengono richiesti il nome utente e la password dell'account utilizzato durante l'autenticazione del server di posta elettronica Contoso.com.

Nel secondo esempio, il cmdlet Get-Credential è assegnato alla variabile $CredentialObject. Una volta assegnate le credenziali dell'autenticazione alla variabile $CredentialObject, è possibile creare il nuovo connettore di invio utilizzando il cmdlet New-SendConnector. La variabile $CredentialObject viene trasmessa al parametro AuthenticationCredential. Oltre all'impostazione delle credenziali, è 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.

New-SendConnector -Name Test -AddressSpaces contoso.com,microsoft.com
$CredentialObject = Get-Credential
New-SendConnector -Name "Secure E-Mail to Contoso.com" -AddressSpaces contoso.com -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth