Set-IMAPSettings

  • Articolo

 

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

Ultima modifica dell'argomento: 2009-05-15

Il cmdlet Set-IMAPSettings consente di impostare specifiche impostazioni di IMAP4 (Internet Message Access Protocol versione 4rev1) per un server Microsoft Exchange Server 2007 nel quale è installato il ruolo del server Accesso client e su cui viene eseguito il servizio IMAP4.

Sintassi

Set-ImapSettings [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-Banner <String>] [-CalendarItemRetrievalOption <iCalendar | intranetUrl | InternetUrl | Custom>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EnableExactRFC822Size <$true | $false>] [-Instance <Imap4AdConfiguration>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>] [-OwaServerUrl <String>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-ShowHiddenFoldersEnabled <$true | $false>] [-SSLBindings <MultiValuedProperty>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-X509CertificateName <String>]

Descrizione dettagliata

Il cmdlet Set-IMAPSettings consente di definire specifiche impostazioni IMAP4 per il server Accesso client di Exchange 2007 in cui viene eseguito il servizio IMAP4. È possibile utilizzare questo cmdlet per un singolo server Accesso client nel quale è installato il servizio IMAP4 o per tutti i server Accesso client di Exchange 2007 nei quali è installato il servizio IMAP4.

Per eseguire il cmdlet Set-IMAPSettings, è necessario utilizzare un account a cui sia stato delegato il ruolo Exchange Server Administrator e l'appartenenza al gruppo Administrators locale del server di destinazione.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

AuthenticatedConnectionTimeout

Facoltativo

Microsoft.Exchange.Data.EnhancedTimeSpan

Questo parametro specifica l'intervallo di tempo di attesa prima della chiusura di una connessione autenticata inattiva. L'impostazione predefinita è 1800. I valori consentiti sono compresi tra 30 e 86.400 secondi.

Banner

Facoltativo

System.String

Questo parametro specifica la stringa banner visualizzata dopo la connessione a un server Accesso client.

CalendarItemRetrievalOption

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

Questo parametro specifica il tipo di elemento di calendario restituito quando si accede a un calendario utilizzando il protocollo IMPA4. Sono disponibili i seguenti valori:

  • 0:Calendar

  • 1:IntranetUrl

  • 2:InternetUrl

  • 3:Custom

Se si sta utilizzando 3:Custom, è necessario specificare l'impostazione OWAServerUrl.

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.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di recuperare i dati dal servizio directory di Active Directory, includere nel comando il parametro DomainController.

EnableExactRFC822Size

Facoltativo

System.Boolean

Il parametro EnableExactRFC822Size è utilizzato per restituire il valore RFC822.SIZE corretto di ciascun messaggio di posta elettronica presente in una cassetta postale.

Per impostazione predefinita, il valore RFC822.SIZE viene valutato da Exchange 2007 poiché è necessario che il MIME venga ricostruito da Exchange 2007 per determinare la dimensione corretta. La ricostruzione del MIME potrebbe influire sulle prestazioni se nella cassetta postale sono inclusi messaggi di grandi dimensioni o messaggi con allegati eccessivamente nidificati. Tuttavia, alcuni client di posta elettronica possono richiedere che il valore RFC822.SIZE corrisponda al valore esatto e non a un valore previsto.

Per abilitare la dimensione corretta per tutti, utilizzare il seguente comando:

Set-ImapSettings -EnableExactRFC822Size:$true

Per abilitare la dimensione corretta solo per un utente specifico, utilizzare il seguente comando:

Set-CASMailbox <IMAP_User_Name> -ImapUseProtocolDefaults:$false -ImapEnableExactRFC822Size:$true

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.Imap4AdConfiguration

Il parametro Instance consente di specificare l'istanza di un oggetto Active Directory di cui è stato eseguito il piping a questo comando ed è utilizzato da quest'ultimo.

LoginType

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

Questo parametro specifica le impostazioni di autenticazione utilizzate per il server Accesso client in cui è in esecuzione il servizio IMAP4. I valori possibili sono:

  • 1:PlainTextLogin

  • 2:PlainTextAuthentication

  • 3:SecureLogin

MaxCommandSize

Facoltativo

System.Int32

Questo parametro consente di specificare la dimensione massima di un singolo comando. La dimensione predefinita è 10240 byte. I valori consentiti sono compresi tra 1024 e 16384 byte.

MaxConnectionFromSingleIP

Facoltativo

System.Int32

Questo parametro consente di specificare il numero di connessioni da parte di un singolo indirizzo IP accettate dal server specificato. Il valore predefinito è 20. I valori consentiti sono compresi tra 1 e 1000.

MaxConnections

Facoltativo

System.Int32

Questo parametro consente di specificare il numero totale di connessioni accettate dal server specificato. Tra queste sono incluse le connessioni autenticate e non autenticate. La dimensione predefinita è 2.000 connessioni. I valori consentiti sono compresi tra 1 e 25.000.

MaxConnectionsPerUser

Facoltativo

System.Int32

Questo parametro consente di specificare il numero massimo di connessioni da parte di un determinato utente accettate dal server Accesso client. Il valore predefinito è 10. I valori consentiti sono compresi tra 1 e 1000.

MessageRetrievalMimeFormat

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

Questo parametro consente di specificare il formato dei messaggi recuperati dal server. I valori possibili sono:

  • 0:Text Only

  • 1:HTML Only

  • 2:HTML and Text

  • 3:Rich Text Only

  • 4:Best Body Format

OwaServerUrl

Facoltativo

System.String

Questo parametro consente di specificare il server Accesso client dal quale recuperare le informazioni di calendario relative a istanze di elementi di calendario di Outlook Web Access personalizzati.

PreAuthenticatedConnectionTimeout

Facoltativo

Microsoft.Exchange.Data.EnhancedTimeSpan

Questo parametro specifica l'intervallo di tempo di attesa prima della chiusura di una connessione inattiva non autenticata. L'impostazione predefinita è 60. I valori consentiti sono compresi tra 10 e 3600 secondi.

ProxyTargetPort

Facoltativo

System.Int32

Questo parametro consente di specificare la porta del server back-end di Exchange Server 2003 al quale verranno inoltrati i comandi del servizio IMAP4 in un server Accesso client.

Server

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Questo parametro consente di specificare un singolo server Accesso client nell'organizzazione per il quale si specificano le impostazioni IMAP4.

ShowHiddenFoldersEnabled

Facoltativo

System.Boolean

Se si specifica questo parametro, le cartelle nascoste saranno visibili. Il valore predefinito è $false.

SSLBindings

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Se si specifica questo parametro, il cmdlet restituisce la porta IP da utilizzare per le comunicazioni relative a una sessione SSL (Secure Sockets Layer).

UnencryptedOrTLSBindings

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare la porta IP per le comunicazioni che avvengono tramite la connessione crittografata TLS (Transport Layer Security) o la connessione non crittografata.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

X509CertificateName

Facoltativo

System.String

Questo parametro consente di specificare il nome host nel certificato SSL ricavato dal campo Oggetto associato.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Eccezioni

Eccezioni Descrizione

 

 

Esempio

Nel seguente codice di esempio viene impostato l'indirizzo IP per TLS sul server Accesso client denominato CAS01.

Set-ImapSettings -Server "CAS01" -UnencryptedOrTLSBindings IPaddress:953