Condividi tramite

Set-IMAPSettings (RTM)

  • Articolo

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-11

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>] [-DomainController <Fqdn>] [-Instance <Imap4AdConfiguration>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat>] [-OwaServerUrl <String>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-ShowHiddenFoldersEnabled <$true | $false>] [-SSLBindings <MultiValuedProperty>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-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 che disponga della seguente delega:

  • Ruolo Exchange Server Administrator e 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 Server 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.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

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

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 è 40 byte. I valori consentiti sono compresi tra 40 e 1024 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

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 byte. 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:UUEncode

  • 5:UUEncodeBinHex

  • 6: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.

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 IPAddress per TLS sul server Accesso client denominato CAS01.

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