Compartilhar via

Set-IMAPSettings (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-11

O cmdlet Set-IMAPSettings permite que você defina configurações IMAP4 específicas para o servidor Microsoft Exchange Server 2007 que tenha a função de servidor de Acesso para Cliente instalada e que esteja executando o serviço IMAP4.

Sintaxe

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

Descrição detalhada

O cmdlet Set-IMAPSettings permite que você defina configurações IMAP4 específicas para o servidor de Acesso para Cliente do Exchange 2007 que esteja executando o serviço IMAP4. Você pode executar esse cmdlet para um servidor de Acesso para Cliente único que tenha o serviço IMAP4 instalado ou para todos os servidores de Acesso para Cliente do Exchange 2007 que têm o serviço IMAP4 instalado.

Para executar o cmdlet Set-IMAPSettings, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

AuthenticatedConnectionTimeout

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

Esse parâmetro especifica o período de tempo a ser aguardado antes de encerrar uma conexão autenticada ociosa. A configuração padrão é de 1800 segundos. Os valores possíveis são de 30 a 86.400 segundos.

Banner

Opcional

System.String

Este parâmetro especifica a cadeia de caracteres da faixa exibida depois que uma conexão com um servidor de Acesso para Cliente foi estabelecida.

CalendarItemRetrievalOption

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

Esse parâmetro especifica o tipo de item de calendário que é retornado quando o calendário é acessado usando IMAP4. Os seguintes valores estão disponíveis:

  • 0:Calendar

  • 1:IntranetUrl

  • 2:InternetUrl

  • 3:Custom

Se você estiver usando 3:Custom, deverá especificar a configuração OWAServerUrl.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.Imap4AdConfiguration

O parâmetro Instance especifica uma instância de um objeto do Active Directory que é canalizada e consumida por este comando.

LoginType

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

Esse parâmetro especifica a configuração de autenticação que é usada para o servidor de Acesso para Cliente que está executando o serviço IMAP4. Os valores possíveis são:

  • 1:PlainTextLogin

  • 2:PlainTextAuthentication

  • 3:SecureLogin

MaxCommandSize

Opcional

System.Int32

Este parâmetro especifica o tamanho máximo de um único comando. O tamanho padrão é 40 bytes. Os valores possíveis são de 40 a 1024 bytes.

MaxConnectionFromSingleIP

Opcional

System.Int32

Esse parâmetro especifica o número de conexões que o servidor especificado aceitará de um único endereço IP. O valor padrão é 20. Os valores possíveis são de 1 a 1000.

MaxConnections

Opcional

System.Int32

Especifica o número total de conexões que o servidor especificado aceitará. Isso inclui conexões autenticadas e não autenticadas. O tamanho padrão é 2.000 bytes. Os valores possíveis são de 1 a 25.000.

MaxConnectionsPerUser

Opcional

System.Int32

Este parâmetro especifica o número máximo de conexões que o servidor de Acesso para Cliente aceitará de um determinado usuário. O valor padrão é 10. Os valores possíveis são de 1 a 1000.

MessageRetrievalMimeFormat

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

Este parâmetro especifica o formato das mensagens recuperadas do servidor. Os valores possíveis são:

  • 0:Somente Texto

  • 1:Somente HTML

  • 2:HTML e Texto

  • 3:Somente Rich Text

  • 4:UUEncode

  • 5:UUEncodeBinHex

  • 6:Melhor Formato do Corpo

OwaServerUrl

Opcional

System.String

Este parâmetro especifica o servidor de Acesso para Cliente do qual recuperar informações de calendário para instâncias de itens de calendário do Outlook Web Access personalizados.

PreAuthenticatedConnectionTimeout

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

Esse parâmetro especifica o período de tempo a ser aguardado antes de encerrar uma conexão ociosa que não seja autenticada. A configuração padrão é de 60 segundos. Os valores possíveis são de 10 a 3600 segundos.

ProxyTargetPort

Opcional

System.Int32

Esse parâmetro especifica a porta no servidor back-end do Exchange Server 2003 para o qual o serviço IMAP4 em um servidor de Acesso para Cliente retransmitirá comandos.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Esse parâmetro especifica um servidor de Acesso para Cliente individual em sua organização para o qual você está especificando configurações de IMAP.

ShowHiddenFoldersEnabled

Opcional

System.Boolean

Se esse parâmetro for especificado, as pastas ocultas estarão visíveis. O valor padrão é $false.

SSLBindings

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Se esse parâmetro for especificado, o cmdlet retornará a porta IP a ser usada para comunicação de uma sessão SSL (Secure Sockets Layer).

UnencryptedOrTLSBindings

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica a porta IP para comunicação pela conexão criptografada TLS (Transport Layer Security) ou pela conexão que não é criptografada.

X509CertificateName

Opcional

System.String

Esse parâmetro especifica o nome do host no certificado SSL no campo Assunto Associado.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O exemplo de código a seguir define IPAdress para TLS no servidor de Acesso para Cliente chamado CAS01.

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