Set-ReceiveConnector (RTM)
Si applica a: Exchange Server 2007 SP1, Exchange Server 2007
Ultima modifica dell'argomento: 2007-07-23
Il cmdlet Set-ReceiveConnector consente di modificare il connettore di ricezione esistente su un computer in cui è installato il ruolo del server Trasporto Hub o Edge Transport.
Sintassi
Set-ReceiveConnector -Identity <ReceiveConnectorIdParameter> [-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>] [-Name <String>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>]
Set-ReceiveConnector [-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>] [-Instance <ReceiveConnector>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>]
Descrizione dettagliata
Il cmdlet Set-ReceiveConnector consente di modificare un connettore di ricezione esistente. Il parametro Identity è obbligatorio quando si esegue il cmdlet Set-ReceiveConnector.
Una volta completata questa attività, il connettore di ricezione viene modificato.
Per eseguire il cmdlet Set-ReceiveConnector, è necessario utilizzare un account che disponga della seguente delega:
- Ruolo Exchange Server Administrator e appartenenza al gruppo Administrators locale del server di destinazione
Per eseguire il cmdlet Set-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, sulla delega dei ruoli e sui diritti di amministrazione necessari per l'amministrazione di Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Obbligatorio |
Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter |
Questo parametro consente di specificare il GUID o il nome del connettore che rappresenta il connettore di ricezione. L'etichetta Identity può essere omessa. |
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 seguenti requisiti di univocità:
|
ChunkingEnabled |
Facoltativo |
System.Boolean |
Valori validi per questo parametro sono |
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 immissione 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 immissione 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 seguenti condizioni:
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. |
Instance |
Facoltativo |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector |
Questo parametro consente di passare un intero oggetto al comando per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare al comando un oggetto completo. |
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. L'intervallo di input valido per questo parametro è compreso 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 intestazioni "Ricevuto:" in un messaggio inoltrato. |
MaxInboundConnection |
Facoltativo |
Microsoft.Exchange.Data.Unlimited |
Il parametro MaxInboundConnection 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 singolo indirizzo IP. Il valore viene espresso come percentuale delle connessioni rimanenti disponibili in un connettore di ricezione. Immettere il valore come numero intero senza il carattere di percentuale (%). Il valore predefinito è 2%. L'intervallo di input valido per questo parametro è compreso tra |
MaxInboundConnectionPerSource |
Facoltativo |
Microsoft.Exchange.Data.Unlimited |
Questo parametro consente di specificare il numero massimo di connessioni in ingresso 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:" che gli indirizzi del server locale hanno 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. Per il parametro MaxMessageSize è possibile accettare un valore intero. Il valore predefinito è
I numeri interi 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 |
Il parametro MaxRecipientsPerMessage 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 è |
Nome |
Facoltativo |
System.String |
Questo parametro è il nome del connettore fornito dall'amministratore. Immettere il parametro Name sotto forma di stringa come segue, ad esempio: |
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 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 |
SizeEnabled |
Facoltativo |
Microsoft.Exchange.Data.SizeMode |
Valori validi per questo parametro sono |
TarpitInterval |
Facoltativo |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Il parametro TarpitInterval consente di specificare il ritardo di una risposta SMTP a un server remoto che, in base a quanto rilevato da Exchange, può stare 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: hh:mm:ss dove h = ore, m = minuti e s = secondi. L'intervallo di input valido per questo parametro è compreso tra |
Tipi di input
Tipi restituiti
Errori
Errore | Descrizione |
---|---|
|
|
Esempio
Nel seguente esempio di comando
Set-ReceiveConnector viene impostato il parametro Banner su "220 Banner Text here"
e il parametro ConnectionTimeOut su 00:15:00
.
Set-ReceiveConnector -Identity "Internet Receive Connector" -Banner "220 Banner Text here" -ConnectionTimeout 00:15:00