Set-IMAPSettings

  • Artigo

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2009-05-15

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

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 delegada a função Administrador do Exchange Server e a associação ao grupo Administradores local do 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 2007, consulte Considerações sobre permissão. 

Parâmetros

Parâmetro Necessário(s) 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.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

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

EnableExactRFC822Size

Opcional

System.Boolean

O parâmetro EnableExactRFC822Size é usado para retornar o valor correto de RFC822.SIZE de cada mensagem de email em uma caixa de correio.

Por padrão, o Exchange 2007 estima o valor de RFC822.SIZE, pois o Exchange 2007 deve recompilar o MIME para determinar o tamanho exato. A recompilação do MIME poderá ter um impacto de desempenho se a caixa de correio incluir mensagens grandes ou mensagens que contenham anexos profundamente aninhados. No entanto, alguns clientes de email podem exigir que o valor de RFC822.SIZE seja exato e não estimado.

Para habilitar o tamanho exato para todos os usuários, use o seguinte comando:

Set-ImapSettings -EnableExactRFC822Size:$true

Para habilitar o tamanho exato para um usuário específico apenas, use o seguinte comando:

Set-CASMailbox <Nome_de_Usuário_IMAP> -ImapUseProtocolDefaults:$false -ImapEnableExactRFC822Size:$true

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 é 10240 bytes. Os valores possíveis vão de 1024 a 16384 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

Esse parâmetro 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 conexões. 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: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.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar nenhum valor com o parâmetro WhatIf.

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 o Endereço IP do TLS no servidor de Acesso para Cliente chamado CAS01.

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