Set-IMAPSettings

  • Artículo

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2009-05-15

El cmdlet Set-IMAPSettings permite especificar opciones específicas del Protocolo de acceso a mensajes de Internet versión 4 rev1 (IMAP4) para el servidor de Microsoft Exchange Server 2007 con la función del servidor de acceso de cliente instalada y en el que se ejecuta el servicio IMAP4.

Sintaxis

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>]

Descripción detallada

El cmdlet Set-IMAPSettings permite establecer opciones específicas de IMAP4 para el servidor de acceso de cliente de Exchange 2007 en el que se ejecuta el servicio IMAP4. Puede ejecutar este cmdlet para un único servidor de acceso de cliente que tenga instalado el servicio IMAP4, o para todos los servidores de acceso de cliente de Exchange 2007 que lo tengan instalado.

Para ejecutar el cmdlet Set-IMAPSettings, debe usar una cuenta que tenga delegada la función Administrador de Exchange Server y pertenezca al grupo local Administradores del servidor de destino.

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

AuthenticatedConnectionTimeout

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

Este parámetro especifica el período de tiempo que debe transcurrir antes de cerrar una conexión autenticada inactiva. El valor predeterminado es 1800 segundos. Los valores admitidos van de 30 a 86400 segundos.

Banner

Opcional

System.String

Este parámetro especifica la cadena de la pancarta que se muestra una vez que se ha establecido una conexión con el servidor de acceso de cliente.

CalendarItemRetrievalOption

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

Este parámetro especifica el tipo de elemento de calendario que se devuelve cuando se tiene acceso al calendario mediante IMAP4. Están disponibles los siguientes valores:

  • 0:Calendario

  • 1:IntranetUrl

  • 2:InternetUrl

  • 3:Personalizado

Si utiliza 3:Personalizado, debe especificar la opción OWAServerUrl.

Confirm

Opcional

System.Management.Automation.SwitchParameter

El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que recupera los datos del servicio de directorio Active Directory, incluya el parámetro DomainController en el comando.

EnableExactRFC822Size

Opcional

System.Boolean

El parámetro EnableExactRFC822Size se usa para devolver el valor de RFC822.SIZE correcto de cada mensaje de correo electrónico de un buzón.

De forma predeterminada, Exchange 2007 calcula aproximadamente el valor de RFC822.SIZE porque Exchange 2007 debe volver a construir el MIME para determinar el tamaño exacto. La reconstrucción del MIME puede afectar al rendimiento si el buzón incluye mensajes grandes o mensajes que contengan datos adjuntos demasiado anidados. Sin embargo, algunos clientes de correo electrónico pueden requerir un valor de RFC822.SIZE exacto y no una estimación.

Para habilitar el valor exacto para todos, use el comando siguiente:

Set-ImapSettings -EnableExactRFC822Size:$true

Para habilitar el tamaño exacto para un usuario específico, use el comando siguiente:

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

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.Imap4AdConfiguration

El parámetro Instance indica una instancia de un objeto de Active Directory que se canaliza a este comando y es consumida por él.

LoginType

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

Este parámetro especifica la opción de autenticación que se usa para el servidor de acceso de cliente en que se ejecuta el servicio IMAP4. Los valores posibles son:

  • 1:PlainTextLogin

  • 2:PlainTextAuthentication

  • 3:SecureLogin

MaxCommandSize

Opcional

System.Int32

Este parámetro especifica el tamaño máximo de un único comando. El tamaño predeterminado es de 10240 bytes. Los valores admitidos van de 1024 a 16384 bytes.

MaxConnectionFromSingleIP

Opcional

System.Int32

Este parámetro especifica el número de conexiones de una sola dirección IP que aceptará el servidor especificado. El valor predeterminado es 20. Se admiten los valores de 1 a 1000.

MaxConnections

Opcional

System.Int32

Este parámetro especifica el número total de conexiones que aceptará el servidor especificado. Se incluyen en este número tanto las conexiones autenticadas como las que no lo están. El tamaño predeterminado es de 2.000 conexiones. Los valores admitidos van de 1 a 25.000.

MaxConnectionsPerUser

Opcional

System.Int32

Este parámetro especifica el número máximo de conexiones de un usuario particular que aceptará el servidor de acceso de cliente. El valor predeterminado es 10. Se admiten los valores de 1 a 1000.

MessageRetrievalMimeFormat

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

Este parámetro especifica el formato de los mensajes que se recuperan del servidor. Los valores posibles son:

  • 0:Sólo texto

  • 1:Sólo HTML

  • 2:HTML y texto

  • 3:Sólo texto enriquecido

  • 4:Best Body Format

OwaServerUrl

Opcional

System.String

Este parámetro especifica el servidor de acceso de cliente desde el que se debe recuperar la información de calendario para instancias de elementos de calendario de Outlook Web Access personalizados.

PreAuthenticatedConnectionTimeout

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

Este parámetro especifica el período de tiempo que debe transcurrir antes de cerrar una conexión inactiva que no está autenticada. El valor predeterminado es 60 segundos. Los valores admitidos van de 10 a 3600 segundos.

ProxyTargetPort

Opcional

System.Int32

Este parámetro especifica el puerto del servidor back-end de Exchange Server 2003 al que retransmitirá comandos el servicio IMAP4 en un servidor de acceso de cliente.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Este parámetro especifica un único servidor de acceso de cliente de la organización para el que se van a especificar opciones de IMAP.

ShowHiddenFoldersEnabled

Opcional

System.Boolean

Si se especifica este parámetro, las carpetas ocultas estarán visibles. El valor predeterminado es $false.

SSLBindings

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Si se especifica este parámetro, el cmdlet devuelve el puerto IP que se debe usar para la comunicación de una sesión del nivel de sockets seguros (SSL).

UnencryptedOrTLSBindings

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parámetro especifica el puerto IP para la comunicación a través de la conexión cifrada de Seguridad de la capa de transporte (TLS) o de la conexión que no está cifrada.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

X509CertificateName

Opcional

System.String

Este parámetro especifica el nombre de host del certificado SSL del campo Asunto asociado.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

 

Excepciones

Excepciones Descripción

 

 

Ejemplo

El siguiente código de ejemplo configura la dirección IP para TLS en el servidor de acceso de cliente llamado CAS01.

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