New-ReceiveConnector (RTM)
Si applica a: Exchange Server 2007 SP1, Exchange Server 2007
Ultima modifica dell'argomento: 2007-07-23
Il cmdlet New-ReceiveConnector consente di creare un nuovo connettore di ricezione su un computer in cui è installato il ruolo del server Trasporto Hub o Edge Transport.
Sintassi
New-ReceiveConnector -Name <String> [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-Server <ServerIdParameter>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internet | Internal | Client | Partner>]
Descrizione dettagliata
Il cmdlet New-ReceiveConnector consente di creare un nuovo connettore di ricezione. Per visualizzare la richiesta dei parametri obbligatori per un nuovo connettore di ricezione, digitare New-ReceiveConnector. I parametri obbligatori di un nuovo connettore di ricezione sono Name, Bindings e RemoteIPRanges.
Una volta completata questa attività, viene creato un connettore di ricezione.
Per eseguire il cmdlet New-ReceiveConnector, è necessario utilizzare un account che disponga della seguente delega:
- Ruolo Exchange Server Administrator e gruppo Administrators locale del server di destinazione
Per eseguire il cmdlet New-ReceiveConnector 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, sui ruoli con delega e sui diritti necessari per l'amministrazione di Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Name |
Obbligatorio |
System.String |
Questo parametro è il nome del connettore fornito dall'amministratore. Immettere il parametro Name sotto forma di stringa come segue, ad esempio: " |
AuthMechanism |
Facoltativo |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector+AuthMechanisms |
Questo parametro consente di specificare i meccanismi di autenticazione annunciati e accettati. Le opzioni di autenticazione sono |
Banner |
Facoltativo |
System.String |
Questo parametro consente di sovrascrivere il banner predefinito Simple Mail Transfer Protocol (SMTP) 220. Quando il valore del parametro Banner è vuoto, il banner SMTP predefinito è il seguente:
Nello specificare un valore per il parametro Banner, è necessario utilizzare la seguente sintassi:
220 è il codice di risposta SMTP "Service ready" predefinito, come definito nell'RFC 2821. |
BinaryMimeEnabled |
Facoltativo |
System.Boolean |
Valori validi per questo parametro sono |
Bindings |
Facoltativo |
Microsoft.Exchange.Data.MultiValuedProperty |
Questo parametro specifica l'indirizzo IP locale e i numeri di porta TCP utilizzati dal connettore di ricezione per l'ascolto di messaggi in entrata. La sintassi valida per questo parametro è <Indirizzo IP>:<Porta TCP>, ad esempio Nota È necessario specificare l'indirizzo IP locale valido per il server Trasporto Hub o il server Trasporto Edge sul quale è presente il connettore di ricezione. Se si specifica un indirizzo IP locale non valido, è possibile che il servizio Trasporto Microsoft Exchange non riesca ad avviarsi quando il servizio viene riavviato. Per specificare tutti gli indirizzi IP configurati su tutte le schede di rete, è possibile utilizzare l'indirizzo IP I valori specificati mediante il parametro Bindings devono soddisfare uno dei sequenti requisiti di univocità:
È necessario specificare una valore per il parametro Bindings quando vengono specificati i seguenti valori per il parametro Usage:
|
ChunkingEnabled |
Facoltativo |
System.Boolean |
Questo parametro può assumere il valore |
Comment |
Facoltativo |
System.String |
È necessario racchiudere il parametro Comment tra virgolette doppie, come nel seguente esempio: |
ConnectionInactivityTimeout |
Facoltativo |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Questo parametro consente di specificare la durata massima di inattività prima che una connessione a un connettore di ricezione venga chiusa. Il valore predefinito per un connettore di ricezione configurato su un server Trasporto Hub è 5 minuti. Il valore predefinito per un connettore di ricezione configurato su un server Trasporto Edge è 1 minuto. Per specificare un valore, immettere un intervallo di tempo: dd.hh:mm:ss, dove d = giorni, h = ore, m = minuti e s = secondi. Il valore specificato dal parametro ConnectionTimeout deve essere superiore al valore specificato dal parametro ConnectionInactivityTimeout. La gamma di immisssione valida per questi parametri è compresa tra |
ConnectionTimeOut |
Facoltativo |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Questo parametro consente di specificare il tempo massimo durante il quale una connessione può restare aperta, anche se la connessione sta trasmettendo dati attivamente. Il valore predefinito per un connettore di ricezione configurato su un server Trasporto Hub è 10 minuti. Il valore predefinito per un connettore di ricezione configurato su un server Trasporto Edge è 5 minuti. Per specificare un valore, immettere un intervallo di tempo: dd.hh:mm:ss, dove d = giorni, h = ore, m = minuti e s = secondi. Il valore specificato dal parametro ConnectionTimeout deve essere superiore al valore specificato dal parametro ConnectionInactivityTimeout. La gamma di immisssione valida per questi parametri è compresa tra |
DefaultDomain |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.AcceptedDomainIdParameter |
Questo parametro consente di specificare il nome di dominio da aggiungere ai valori inoltrati a |
DeliveryStatusNotificationEnabled |
Facoltativo |
System.Boolean |
Valori validi per questo parametro 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 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 rappresenta la prima parte del processo per abilitare l'autenticazione TLS reciproca per i domini serviti dal connettore di ricezione. L'autenticazione TLS reciproca funziona correttamente solo se si verificano le condizioni indicate di seguito:
Il valore predefinito per DomainSecureEnabled è
Il valore predefinito per DomainSecureEnabled è |
EightBitMimeEnabled |
Facoltativo |
System.Boolean |
Valori validi per questo parametro sono |
Enabled |
Facoltativo |
System.Boolean |
Valori validi per questo parametro sono |
EnhancedStatusCodesEnabled |
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 destinazione per i server di messaggistica collegati che si servono di un connettore di ricezione per inviare messaggi in entrata. Il valore di questo parametro viene visualizzato su server di messaggistica connessi ogni volta che è necessario un nome server di destinazione, come ad esempio:
Il valore predefinito del parametro Fqdn è il FQDN del server di Trasporto Edge o del server di Trasporto Hub che contiene il connettore di ricezione. Nota Non modificare il valore FQDN sul connettore di ricezione predefinito denominato “<Nome server> predefinito” che viene creato automaticamente sui server Trasporto Hub. Se si hanno server Trasporto Hub multipli nella propria organizzazione Exchange e si modifica il valore FQDN del connettore di ricezione “<Nome server>predefinito”, il flusso di posta interno tra i server Trasporto Hub non andrà a buon fine. |
MaxHeaderSize |
Facoltativo |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Questo parametro consente di specificare in byte la dimensione massima dell'intestazione di un messaggio SMTP che il connettore di ricezione accetta prima di chiudere la connessione. Il valore predefinito è
I valori non qualificati vengono considerati byte. La gamma di immisssione valida per questo parametro è compresa tra |
MaxHopCount |
Facoltativo |
System.Int32 |
Questo parametro consente di specificare il numero massimo di hop che un messaggio accetta prima di essere rifiutato dal connettore di ricezione. Il valore predefinito è Nota Il numero massimo di hop è determinato dal numero di campi di intestazione |
MaxInboundConnection |
Facoltativo |
Microsoft.Exchange.Data.Unlimited |
Questo parametro consente di specificare il numero massimo di connessioni in entrata servite contemporaneamente dal connettore di ricezione. Il valore predefinito è |
MaxInboundConnectionPercentagePerSource |
Facoltativo |
System.Int32 |
Questo parametro consente di specificare il numero massimo di connessioni servite contemporaneamente dal connettore di ricezione da un solo indirizzo IP, espresso come percentuale di connessioni disponibili rimanenti in un connettore di ricezione. Immettere il valore come numero intero senza il carattere di percentuale (%). Il valore predefinito è |
MaxInboundConnectionPerSource |
Facoltativo |
Microsoft.Exchange.Data.Unlimited |
Questo parametro consente di specificare il numero massimo di connessioni servite contemporaneamente dal connettore di ricezione da un singolo indirizzo IP. Il valore predefinito è |
MaxLocalHopCount |
Facoltativo |
System.Int32 |
Questo parametro consente di specificare il numero massimo di hop locali che un messaggio accetta prima di essere rifiutato dal connettore di ricezione. Il valore predefinito è Nota Il numero massimo di hop locali è determinato dal numero di intestazioni "Ricevuto:" con gli indirizzi del server locali in un messaggio inoltrato. |
MaxLogonFailures |
Facoltativo |
System.Int32 |
Questo parametro consente di specificare il numero di tentativi di accesso non riusciti eseguiti dal connettore di ricezione prima di chiudere la connessione. Il valore predefinito è |
MaxMessageSize |
Facoltativo |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Questo parametro consente di specificare la dimensione massima di un messaggio. Il valore predefinito è
I valori non qualificati vengono considerati byte. L'intervallo di input valido per questo parametro è compreso tra 1 e 2147483647 byte. |
MaxProtocolErrors |
Facoltativo |
Microsoft.Exchange.Data.Unlimited |
Questo parametro consente di specificare il numero massimo di errori del protocollo SMTP che il connettore di ricezione accetta prima di chiudere la connessione. Il valore predefinito è |
MaxRecipientsPerMessage |
Facoltativo |
System.Int32 |
Questo parametro consente di specificare il numero massimo di destinatari per messaggio che il connettore di ricezione accetta prima di chiudere la connessione. Il valore predefinito è |
MessageRateLimit |
Facoltativo |
Microsoft.Exchange.Data.Unlimited |
Questo parametro consente di specificare il numero massimo di messaggi che possono essere inviati da un singolo indirizzo IP client al minuto. Il valore predefinito per un connettore di ricezione configurato su un server Trasporto Hub è |
PermissionGroups |
Facoltativo |
Microsoft.Exchange.Data.PermissionGroups |
Questo parametro consente di definire i gruppi o i ruoli ai quali è consentito inoltrare messaggi al connettore di ricezione nonché le autorizzazioni assegnate a tali gruppi. Un gruppo di autorizzazioni è un insieme predefinito di autorizzazioni concesse a entità di protezione conosciute. Di seguito sono riportati i valori validi per il parametro: |
PipeliningEnabled |
Facoltativo |
System.Boolean |
Valori validi per questo parametro sono |
ProtocolLoggingLevel |
Facoltativo |
Microsoft.Exchange.Data.ProtocolLoggingLevel |
Questo parametro abilita o disabilita la registrazione protocollo per il connettore di ricezione specificato. Un valore di |
RemoteIPRanges |
Facoltativo |
Microsoft.Exchange.Data.MultiValuedProperty |
Questo parametro specifica gli indirizzi IP remoti dai quali questo connettore accetta messaggi. La sintassi valida per questo parametro è <Indirizzo IP iniziale>:<Indirizzo IP finale>, ad esempio È necessario specificare una valore per il parametro RemoteIPRanges quando vengono specificati i seguenti valori per il parametro Usage:
Più connettori di ricezione sullo stesso server possono avere intervalli di indirizzi IP remoti che si sovrappongono se un intervallo è completamente sovrapposto da un altro. Quando gli intervalli di indirizzi IP remoti si sovrappongono, viene utilizzato l'intervallo di indirizzi IP con la corrispondenza più completa all'indirizzo IP del server connesso. |
RequireEHLODomain |
Facoltativo |
System.Boolean |
Valori validi per questo parametro sono |
RequireTLS |
Facoltativo |
System.Boolean |
Valori validi per questo parametro sono |
Server |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Questo parametro consente di specificare il server sul quale creare il nuovo connettore di ricezione. |
SizeEnabled |
Facoltativo |
Microsoft.Exchange.Data.SizeMode |
Valori validi per questo parametro sono |
TarpitInterval |
Facoltativo |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Questo parametro consente di specificare il ritardo di una risposta SMTP a un server remoto che, in base a quanto rilevato da Exchange, starebbe abusando della connessione. Le connessioni autenticate non vengono mai ritardate in questo modo. Il valore predefinito è 5 secondi. Per specificare un valore, immettere un intervallo di tempo: dd.hh:mm:ss, dove d = giorni, h = ore, m = minuti e s = secondi. La gamma di immisssione valida per questo parametro è compresa tra |
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.NewReceiveConnector+UsageType |
Questo parametro consente di specificare i gruppi di autorizzazioni predefiniti e i metodi di autenticazione assegnati al connettore di ricezione. Di seguito sono riportati i valori validi per il parametro Usage: È necessario un valore per il parametro Bindings se si specifica uno dei seguenti valori per il parametro Usage:
È necessario un valore per il parametro RemoteIPRanges se si specifica uno dei seguenti valori per il parametro Usage:
Se non si specifica un valore per un parametro necessario, il comando non andrà a buon fine. Il cmdlet New-ReceiveConnector non avvertirà dei parametri obbligatori mancanti. Per ulteriori informazioni sui tipi di utilizzo dei connettori di ricezione, sui gruppi di autorizzazione e i metodi di autenticazione, vedere Connettori di ricezione. |
Tipi di input
Tipi restituiti
Errori
Errore | Descrizione |
---|---|
|
|
Esempio
Il comando New-ReceiveConnector consente di creare un nuovo connettore di ricezione. Nell'esempio vengono illustrati i parametri minimi necessari per creare un connettore di ricezione.
Nota
Non è possibile creare più connettori di ricezione che condividano parametri Bindings e parametri RemoteIPRanges identici.
New-ReceiveConnector -Name Test -Bindings 10.10.1.1:25 -RemoteIPRanges 192.168.0.1-192.168.0.24