Set-ReceiveConnector
Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Ultima modifica dell'argomento: 2009-08-19
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 Trasporto Edge.
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>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-EnableAuthGSSAPI <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-LongAddressesEnabled <$true | $false>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-OrarEnabled <$true | $false>] [-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>] [-WhatIf [<SwitchParameter>]]
Set-ReceiveConnector [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-EnableAuthGSSAPI <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-Instance <ReceiveConnector>] [-LongAddressesEnabled <$true | $false>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-OrarEnabled <$true | $false>] [-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>] [-WhatIf [<SwitchParameter>]]
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 consente di specificare l'indirizzo IP locale e i numeri di porta TCP utilizzati dal connettore di ricezione per ascoltare i messaggi in ingresso. La sintassi valida per questo parametro è <Indirizzo IP>:<Porta TCP>, ad esempio Nota È necessario specificare un indirizzo IP locale valido per il server Trasporto Hub o per il server Trasporto Edge in cui si trova il connettore di ricezione. Se si specifica un indirizzo IP locale non valido, potrebbe essere impossibile avviare il servizio trasporto di Microsoft Exchange quando viene riavviato il servizio. Per specificare tutti gli indirizzi IP configurati in tutte le schede di rete, è possibile utilizzare l'indirizzo IP I valori specificati utilizzando 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: |
Confirm |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'utente, prima che l'elaborazione continui, confermi l'operazione che verrà eseguita dal comando. Non è necessario specificare alcun valore con il parametro Confirm. |
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 periodo di tempo: gg.hh:mm:ss dove g = 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 periodo di tempo: gg.hh:mm:ss dove g = 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 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 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 |
EnableAuthGSSAPI |
Facoltativo |
System.Boolean |
Questo parametro consente di controllare l'annuncio del metodo autenticazione GSSAPI (Generic Security Services application programming interface) quando l'autenticazione Windows integrata è abilitata su questo connettore. Se il parametro AuthMechanism contiene Se i server di messaggistica Microsoft Internet Information Services (IIS) eseguono l'autenticazione con il connettore di ricezione, impostare il valore del parametro EnableAuthGSSAPI su L'intervallo di input valido per questo parametro è compresa tra |
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 consente di specificare il nome di dominio completo (FQDN) utilizzato come server di destinazione per i server di messaggistica connessi che utilizzano il connettore di ricezione per l'invio dei messaggi in arrivo. Il valore del parametro è visualizzato nei server di messaggistica connessi ogni volta che viene richiesto il nome del server di destinazione, come illustrato negli esempi seguenti:
Il valore predefinito del parametro Fqdn è il nome di dominio completo (FQDN) del server Trasporto Hub o del server Trasporto Edge che contiene il connettore di ricezione. Nota Non modificare il valore del nome di dominio completo nel connettore di ricezione predefinito denominato "<Nome del server> predefinito" che viene creato automaticamente nei server Trasporto Hub. Se si dispone di più server Trasporto Hub nell'organizzazione di Exchange e si modifica il valore del nome di dominio completo nel connettore di ricezione del "<Nome del server >predefinito", il flusso di posta interna tra i server Trasporto Hub verrà compromesso. |
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 l'intero oggetto al comando. |
LongAddressesEnabled |
Facoltativo |
System.Boolean |
Questo parametro consente al connettore di ricezione di accettare indirizzi di posta elettronica X.400 lunghi. Gli indirizzi di posta elettronica X.400 vengono incapsulati negli indirizzi di posta elettronica SMTP utilizzando il metodo di incapsulamento IMCEA (Internet Mail Connector Encapsulated Address). Quando il valore di questo parametro è Quando il valore di questo parametro è
Pertanto, gli indirizzi di posta elettronica X.400 possono contenere fino a 1860 caratteri dopo l'incapsulamento IMCEA. L'intervallo di input valido per questo parametro è compresa tra |
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 numero massimo di hop è determinato dal numero di intestazioni |
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 numero massimo di hop locali è determinato dal numero di intestazioni Nota Quando il server Trasporto Hub o il server Trasporto Edge vengono aggiornati a Exchange 2007 Service Pack 1 (SP1), il valore del parametro MaxLocalHopCount è |
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 numeri interi non qualificati vengono considerati byte. L'intervallo di input valido per questo parametro è compresa tra 65536 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 è |
Name |
Facoltativo |
System.String |
Questo parametro è il nome del connettore fornito dall'amministratore. Immettere il parametro Name sotto forma di stringa come segue, ad esempio: |
OrarEnabled |
Facoltativo |
System.Boolean |
Questo parametro consente di abilitare ORAR (Originator Requested Alternate Recipient). Se il valore di questo parametro è L'intervallo di input valido per questo parametro è compresa tra |
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 consente di specificare gli indirizzi IP dai quali il connettore accetta i 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 di indirizzi IP è completamente sovrapposto a un altro indirizzo IP. 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 periodo di tempo: hh:mm:ss dove h = ore, m = minuti e s = secondi. L'intervallo di input valido per questo parametro è compreso tra |
WhatIf |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Per il parametro WhatIf non è necessario specificare un valore. |
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