New-SendConnector
Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Ultima modifica dell'argomento: 2007-09-05
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>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-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>] [-WhatIf [<SwitchParameter>]]
New-SendConnector -Name <String> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-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>] [-WhatIf [<SwitchParameter>]]
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 attività, viene creato un nuovo connettore di invio.
Per eseguire il cmdlet New-SendConnector, l'account utilizzato deve disporre della delega per 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 sia collegato a un connettore di ricezione. Se si specifica un connettore di ricezione collegato utilizzando il parametro LinkedReceiveConnector, il valore del parametro AddressSpaces deve essere
Se si specifica il tipo di spazio indirizzo o il costo dello spazio indirizzo, è necessario includere lo spazio indirizzo tra virgolette doppie (
È possibile specificare più spazi indirizzo separandoli con una virgola nel modo indicato di seguito: 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:
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 di 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: |
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 |
Comment |
Facoltativo |
System.String |
È necessario racchiudere il parametro Comment tra virgolette doppie, come nel seguente esempio: |
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 di apertura di una connessione inattiva. Il valore predefinito è 10 minuti. Per specificare un valore, immettere un periodo 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 |
Custom |
Facoltativo |
System.Management.Automation.SwitchParameter |
Questo parametro specifica il tipo di utilizzo
Per ulteriori informazioni sui tipi di utilizzo dei connettori di invio, sulle autorizzazioni e i metodi di autenticazione, vedere Connettori di invio. |
DNSRoutingEnabled |
Facoltativo |
System.Boolean |
I valori validi per il parametro DnsRoutingEnabled sono |
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 in computer su cui è in esecuzione 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 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 è
Il valore predefinito per il parametro DomainSecureEnabled è
|
Enabled |
Facoltativo |
System.Boolean |
Valori validi per questo parametro sono |
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 |
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:
Il valore predefinito per il parametro Fqdn è 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. Viene invece sempre utilizzato il nome di dominio completo visualizzato utilizzando il cmdlet Get-ExchangeServer. |
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 |
Internal |
Facoltativo |
System.Management.Automation.SwitchParameter |
Questo parametro specifica il tipo di utilizzo
Per ulteriori informazioni sui tipi di utilizzo dei connettori di invio, sulle autorizzazioni e i metodi di autenticazione, vedere Connettori di invio. |
Internet |
Facoltativo |
System.Management.Automation.SwitchParameter |
Questo parametro specifica il tipo di utilizzo
Per ulteriori informazioni sui tipi di utilizzo dei connettori di invio, sulle autorizzazioni e i metodi di autenticazione, vedere Connettori di invio. |
IsScopedConnector |
Facoltativo |
System.Boolean |
Questo parametro consente di controllare la disponibilità del connettore per altri server Trasporto Hub. Quando il valore del parametro è |
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:
Quando si utilizza il parametro LinkReceiveConnector con il cmdlet New-SendConnector, è necessario utilizzare anche i seguenti parametri con i valori specificati:
Quando si utilizza il parametro LinkedReceiveConnector, non si può utilizzare anche il parametro AddressSpace. |
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 è
I valori non qualificati vengono considerati byte. I valori inseriti in byte vengono arrotondati al kilobyte più vicino. Ad esempio, |
Partner |
Facoltativo |
System.Management.Automation.SwitchParameter |
Questo parametro specifica il tipo di utilizzo
Per ulteriori informazioni sui tipi di utilizzo dei connettori di invio, sulle autorizzazioni e i metodi di autenticazione, vedere Connettori di invio. |
Port |
Facoltativo |
System.Int32 |
La gamma di immissione valida per questo parametro è un numero intero compreso tra |
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 |
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 è |
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 |
SmartHosts |
Facoltativo |
Microsoft.Exchange.Data.MultiValuedProperty |
Questo parametro è necessario se il parametro DnsRoutingEnabled viene impostato su |
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 è |
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 |
È possibile utilizzare questo parametro per specificare le autorizzazioni predefinite e i metodi di autenticazione assegnati al connettore di invio. Di seguito sono riportati i valori validi per il parametro: Se si utilizza il parametro Usage, non è possibile utilizzare nessuno dei seguenti parametri:
Per ulteriori informazioni sui tipi di utilizzo dei connettori di invio, sulle autorizzazioni e i metodi di autenticazione, 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 è |
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 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