Set-IMAPSettings (RTM)

  • Artículo

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-11

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

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, la cuenta que utilice debe tener delegada la siguiente función:

  • Función de administrador de servidores de Exchange y grupo Administradores local para el 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 Server 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.

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.

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 40 bytes. Los valores admitidos van de 30 a 1024 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

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

  • 5:UUEncodeBinHex

  • 6: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 de 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 del nivel de transporte (TLS) o de la conexión que no está cifrada.

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 denominado CAS01.

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