Exportar (0) Imprimir
Expandir Tudo
Expandir Minimizar

Set-ImapSettings

 

Aplicável a: Exchange Server 2013

Tópico modificado em: 2014-03-05

Este cmdlet está disponível somente no Exchange Server 2013 local.

Use o cmdlet Set-ImapSettings para definir configurações IMAP4 específicas para o servidor no qual o Microsoft Exchange Server 2013 esteja em execução, que tenha a função de servidor de Acesso para Cliente instalada e que esteja executando o serviço Microsoft Exchange IMAP4.

Para obter informações sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Sintaxe.

Set-ImapSettings [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-Banner <String>] [-CalendarItemRetrievalOption <iCalendar | intranetUrl | InternetUrl | Custom>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EnableExactRFC822Size <$true | $false>] [-EnableGSSAPIAndNTLMAuth <$true | $false>] [-EnforceCertificateErrors <$true | $false>] [-ExtendedProtectionPolicy <None | Allow | Require>] [-ExternalConnectionSettings <MultiValuedProperty>] [-InternalConnectionSettings <MultiValuedProperty>] [-LiveIdBasicAuthReplacement <$true | $false>] [-LogFileLocation <String>] [-LogFileRollOverSettings <Hourly | Daily | Weekly | Monthly>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-LogPerFileSizeQuota <Unlimited>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>] [-OwaServerUrl <Uri>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProtocolLogEnabled <$true | $false>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-ShowHiddenFoldersEnabled <$true | $false>] [-SSLBindings <MultiValuedProperty>] [-SuppressReadReceipt <$true | $false>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-X509CertificateName <String>]

Esse exemplo define o texto sem formatação ou conexão TLS com o servidor de Acesso para Cliente CAS01. Nesse exemplo, a conexão usa o endereço IP 10.0.0.0 e o número de porta 995.

Set-ImapSettings -Server "CAS01" -UnencryptedOrTLSBindings 10.0.0.0:995

Este exemplo ativa o registro em log do protocolo IMAP4. Além disso, altera o diretório do log do protocolo IMAP4 para C:\Imap4Logging.

Set-ImapSettings -ProtocolLogEnabled $true -LogFileLocation "C:\Imap4Logging"

Este exemplo altera o registro em log do protocolo IMAP4 para criar um novo arquivo de log quando o arquivo chegar a 2 megabytes (MB).

Set-ImapSettings -LogPerFileSizeQuota 2000000

Este exemplo altera o registro em log do protocolo IMAP4 para criar um novo arquivo de log por hora.

Set-ImapSettings -LogPerFileSizeQuota 0 -LogFileRollOverSettings Hourly

É possível executar o cmdlet Set-ImapSettings para um único servidor de Acesso para Cliente que tenha o serviço Microsoft Exchange IMAP4 instalado, ou para todos os servidores de Acesso para Cliente do Exchange que tenham o serviço Microsoft Exchange IMAP4 instalado.

Para executar esse cmdlet, você precisa ter permissões. Embora todos os parâmetros para este cmdlet estejam listados neste tópico, talvez você não tenha acesso a alguns parâmetros, caso eles não estejam incluídos nas permissões atribuídas a você. Para ver de que permissões você precisa, consulte o Entrada "Configurações IMAP4" no tópico Permissões dos Dispositivos Móveis e dos Clientes.

 

Parâmetro Obrigatório Tipo Descrição

AuthenticatedConnectionTimeout

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

O parâmetro AuthenticatedConnectionTimeout especifica o período para aguardar antes de encerrar uma conexão autenticada ociosa.

Para especificar um valor, digite-o como um período de tempo: dd.hh:mm:ss, em que d = dias, h = horas, m = minutos e s = segundos.

A entrada válida para este parâmetro é de 00:00:30 a 1:00:00. A configuração padrão é 00:30:00 ou 30 minutos.

Banner

Opcional

System.String

O parâmetro Banner especifica a cadeia de caracteres da faixa exibida depois de estabelecer uma conexão com um servidor de Acesso para Cliente.

CalendarItemRetrievalOption

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.CalendarItemRetrievalOptions

O parâmetro CalendarItemRetrievalOption especifica o tipo de item de calendário retornado quando o calendário é acessado usando IMAP4. O valor padrão é iCalendar. Você pode especificar o valor desse parâmetro, usando um valor número ou cadeia de caracteres de texto. Os seguintes valores estão disponíveis:

  • 0 ou iCalendar

  • 1 ou intranetUrl

  • 2 ou InternetUrl

  • 3 ou Custom

Se estiver usando 3 ou Custom, você deverá especificar a configuração do parâmetro OwaServerUrl.

Confirm

Opcional

System.Management.Automation.SwitchParameter

A opção Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Não é preciso especificar um valor com a opção Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

O parâmetro DomainController especifica o FQDN do controlador de domínio que grava essa alteração de configuração no Active Directory.

EnableExactRFC822Size

Opcional

System.Boolean

O parâmetro EnableExactRFC822Size calcula o tamanho exato de cada mensagem MIME que pode ser recuperada do servidor. Ao definir esse parâmetro como $true, o tamanho exato das mensagens MIME armazenadas no servidor do Exchange permanece disponível a programas cliente POP3 ou IMAP4 que dependem do conhecimento do tamanho exato de todas as mensagens MIME.

ObservaçãoObservação:
Por padrão, esse parâmetro é definido como $false. Se essa opção não for definida como $true, o tamanho de cada mensagem MIME retornada pelo servidor do Exchange para programas cliente POP3 e IMAP4 pode ser ligeiramente diferente do tamanho exato da mensagem. Como a configuração dessa opção como $true pode afetar o desempenho negativamente, essa opção só deve ser usada se muitos dos usuários estiverem usando um cliente que exija o conhecimento do tamanho exato das mensagens MIME.

EnableGSSAPIAndNTLMAuth

Opcional

System.Boolean

O parâmetro EnableGSSAPIAndNTLMAuth especifica se as conexões podem usar a autenticação integrada do Windows (NTLM), usando a interface de programação de aplicativos dos Serviços de Segurança Genéricos (GSSAPI). Esta configuração se aplica a conexões em que o protocolo TLS está desabilitado. Por padrão, esse parâmetro é definido como $true. É possível desabilitar o NTLM para conexões IMAP4, configurando o valor do parâmetro para $false. A autenticação NTLM não é suportada por conexões IMAP4 na versão para fabricação do Microsoft Exchange Server 2010 (RTM). O suporte para a autenticação NTLM para conexões IMAP4 foi retomado no Exchange 2010 Service Pack 1 (SP1).

EnforceCertificateErrors

Opcional

System.Boolean

O parâmetro EnforceCertificateErrors especifica se é necessário impor certificados SSL válidos. Para usar esse parâmetro, especifique o servidor de Acesso para Cliente de destino, onde você deseja impor certificados SSL válidos. Se o parâmetro EnforceCertificateErrors estiver definido como $true e o certificado de destino do proxy não for válido, haverá falha na tentativa de logon do proxy.

A configuração padrão é $false.

ExtendedProtectionPolicy

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ExtendedProtectionTokenCheckingMode

O parâmetro ExtendedProtectionPolicy especifica se deve usar a Proteção Estendida para Autenticação para conexões IMAP4. Por padrão, este parâmetro é definido como None. Os valores possíveis são:

  • None   A Proteção Estendida para Autenticação não será utilizada.

  • Allow   Proteção Estendida para Autenticação será usada somente se a conexão IMAP4 usada oferecer suporte para ela. Caso contrário, as conexões serão estabelecidas sem a Proteção Estendida para Autenticação.

  • Require Proteção Estendida para Autenticação será necessária para todas as conexões IMAP4. Se o host de conexão não oferecer suporte à Proteção Estendida para Autenticação, a conexão será rejeitada.

A Proteção Estendida para Autenticação aprimora a proteção e o tratamento de credenciais ao autenticar conexões de rede usando a autenticação Integrada do Windows. A autenticação Integrada do Windows é também conhecida como NTLM. É altamente recomendado usar a Proteção Estendida para Autenticação se você estiver usando a autenticação Integrada do Windows. Para usar a Proteção Estendida para Autenticação, os computadores cliente e servidor devem atender aos requisitos específicos. Estes incluem requisitos de sistema operacional e os requisitos de atualização de segurança. Além disso, o programa cliente IMAP4 deve suportar o uso da Proteção Estendida para Autenticação.

ExternalConnectionSettings

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ExternalConnectionSettings especifica o nome do host, a porta e o tipo de criptografia que o Exchange usa quando os clientes IMAP4 se conectam a seus emails fora da rede corporativa.

Insira um valor usando o formato: <NomedoHost>:<Porta>:<Tipo de Criptografia>. A parte <Tipo de Criptografia> do valor multivalorado é opcional. Os valores válidos para <Tipo de Criptografia> são TLS (Transport Layer Security) ou SSL.

InternalConnectionSettings

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro InternalConnectionSettings especifica o nome do host, a porta e o tipo de criptografia usados quando os clientes IMAP4 se conectam a seus emails dentro da rede corporativa. Essa configuração também é usada para especificar o nome do host, a porta e o tipo de criptografia usados quando uma conexão de usuário é encaminhada para outro servidor de Acesso para Cliente.

Insira um valor usando o formato: <NomedoHost>:<Porta>: <Tipo de Criptografia>. A parte <Tipo de Criptografia> do valor multivalorado é opcional. Os valores válidos para <Tipo de Criptografia> são TLS ou SSL. Se o nome do servidor for Server01 e o domínio for Contoso.com, o valor padrão é Server01.Contoso.com:993:SSL, Server01.Contoso.com:143:TLS.

LiveIdBasicAuthReplacement

Opcional

System.Boolean

Esse parâmetro está reservado para uso interno da Microsoft.

LogFileLocation

Opcional

System.String

O parâmetro LogFileLocation especifica a localização dos arquivos de log do protocolo IMAP4. Por padrão, os arquivos de log do protocolo IMAP4 estão localizados no diretório C:\Program Files\Microsoft\Exchange Server\V15\Logging\Imap4.

LogFileRollOverSettings

Opcional

Microsoft.Exchange.Diagnostics.LogFileRollOver

O parâmetro LogFileRollOverSettings especifica a frequência com que o registro em log do protocolo IMAP4 cria um novo arquivo de log. Por padrão, é criado um novo arquivo de log diariamente. Você pode especificar o valor desse parâmetro, usando um valor número ou cadeia de caracteres de texto. Os valores possíveis são:

  • 1 ou Hourly

  • 2 ou Daily

  • 3 ou Weekly

  • 4 ou Monthly

Esta configuração só é aplicável quando o valor do parâmetro LogPerFileSizeQuota está definido como 0.

LoginType

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.LoginOptions

O parâmetro LoginType especifica a configuração de autenticação usada para o servidor de Acesso para Cliente onde o serviço Microsoft Exchange IMAP4 está em execução. O valor padrão é SecureLogin. Você pode especificar o valor desse parâmetro, usando um valor número ou cadeia de caracteres de texto. Os valores possíveis são:

  • 1 ou PlainTextLogin

  • 2 ou PlainTextAuthentication

  • 3 ou SecureLogin

LogPerFileSizeQuota

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro LogPerFileSizeQuota especifica o tamanho máximo de um arquivo de log de protocolo IMAP4 em bytes. Por padrão, esse valor é definido como 0. Quando este valor está definido como 0, um novo arquivo de log de protocolo é criado na frequência especificada pelo parâmetro LogFileRollOverSettings.

MaxCommandSize

Opcional

System.Int32

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

MaxConnectionFromSingleIP

Opcional

System.Int32

O parâmetro MaxConnectionFromSingleIP especifica o número de conexões que o servidor especificado aceita a partir de um único endereço IP. O valor padrão é 2147483647. Os valores possíveis vão de 1 a 2147483647.

MaxConnections

Opcional

System.Int32

O parâmetro MaxConnections especifica o número total de conexões aceitas pelo servidor especificado. Isso inclui conexões autenticadas e não autenticadas. O valor padrão é 2147483647. Os valores possíveis vão de 1 a 2147483647.

MaxConnectionsPerUser

Opcional

System.Int32

O parâmetro MaxConnectionsPerUser especifica o número máximo de conexões que o servidor de Acesso para Cliente aceita de um determinado usuário. O valor padrão é 16. Os valores possíveis vão de 1 a 2147483647.

MessageRetrievalMimeFormat

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.MimeTextFormat

O parâmetro MessageRetrievalMimeFormat especifica o formato das mensagens recuperadas do servidor. O valor padrão é BestBodyFormat. Você pode especificar o valor desse parâmetro, usando um valor número ou cadeia de caracteres de texto. Os valores possíveis são:

  • 0 ou TextOnly

  • 1 ou HtmlOnly

  • 2 ou HtmlAndTextAlternative

  • 3 ou TextEnrichedOnly

  • 4 ou TextEnrichedAndTextAlternative

  • 5 ou BestBodyFormat

  • 6 ou Tnef

Para mais informações, consulte Configurar as Opções de Formato de Recuperação de Mensagens POP3 e IMAP4.

OwaServerUrl

Opcional

System.Uri

O parâmetro OwaServerUrl especifica o servidor de Acesso para Cliente de onde recuperar informações de calendário para instâncias de itens de calendário do Microsoft A integração do Outlook Web App personalizadas.

PreAuthenticatedConnectionTimeout

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

O parâmetro PreAuthenticatedConnectionTimeout especifica o período para aguardar antes de encerrar uma conexão ociosa que não seja autenticada.

Para especificar um valor, digite-o como um período de tempo: dd.hh:mm:ss, em que d = dias, h = horas, m = minutos e s = segundos.

A entrada válida para este parâmetro é de 00:00:30 a 1:00:00. O valor padrão é 00:01:00 ou um minuto.

ProtocolLogEnabled

Opcional

System.Boolean

O parâmetro ProtocolLogEnabled especifica se é necessário habilitar o registro em log do protocolo. Para mais informações, consulte Configurar o log de protocolo para POP3 e IMAP4.

ProxyTargetPort

Opcional

System.Int32

O parâmetro ProxyTargetPort especifica a porta no servidor back-end do Exchange Server 2003 para a qual o serviço Microsoft Exchange IMAP4 em um servidor de Acesso para Cliente retransmite comandos. A porta padrão é 9933.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Server especifica um servidor de Acesso para Cliente individual na organização para o qual configurações IMAP4 estão sendo especificadas.

ShowHiddenFoldersEnabled

Opcional

System.Boolean

O parâmetro ShowHiddenFoldersEnabled especifica se as pastas ocultas devem ser visíveis. Se o valor for definido como $true, as pastas ocultas estarão visíveis. O valor padrão é $false.

SSLBindings

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro SSLBindings especifica se o comando define o endereço IP e o número da porta a serem usados na comunicação para uma sessão SSL. Essa é uma propriedade multivalorada. Insira um valor usando o formato: <Endereço IP>:<Número da porta>. O valor padrão é 0.0.0.0:993.

SuppressReadReceipt

Opcional

System.Boolean

O parâmetro SuppressReadReceipt especifica se o envio de notificações de leitura duplicadas deve ser interrompido para remetentes IMAP4 que estão usando a opção Enviar notificações de leitura para mensagens enviadas por mim em seu programa de email IMAP4. Por padrão, esta opção é definida como $false. Por padrão, remetentes IMAP4 que usam a opção Enviar notificações de leitura para mensagens enviadas por mim recebem uma notificação de leitura nas seguintes circunstâncias:

  • Quando as mensagens enviadas são baixadas pelo destinatário.

  • Quando o destinatário abre a mensagem.

Os seguintes itens são valores e descrições válidos para este parâmetro:

  • $false   Usuários IMAP4 recebem uma notificação de leitura cada vez que um destinatário baixa uma mensagem. Usuários IMAP4 também recebem uma notificação de leitura quando o usuário abre a mensagem.

  • $true   Os usuários IMAP4 que usam a opção Enviar notificação de leitura para mensagens enviadas por mim em seus programas de email só receberão uma notificação de leitura quando o destinatário abrir a mensagem.

UnencryptedOrTLSBindings

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro UnencryptedOrTLSBindings especifica o endereço IP e o número da porta para a comunicação pela conexão criptografada por TLS ou pela conexão que não está criptografada. Essa é uma propriedade multivalorada. Insira um valor usando o formato: <Endereço IP>:<Número da porta>. O valor padrão é 0.0.0.0:143.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

A opção WhatIf instrui o comando a simular as ações que ele executaria no objeto. Ao usar a opção WhatIf, você poderá exibir quais alterações ocorrerão, sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com a opção WhatIf.

X509CertificateName

Opcional

System.String

O parâmetro X509CertificateName especifica o nome do host no certificado SSL do campo Assunto Associado. Essa é uma propriedade multivalorada que contém o endereço IP e a configuração de porta. Insira um valor usando o formato: <Endereço IP>:<Número da porta>.

Para ver os tipos de entrada que este cmdlet aceita, consulte Tipos de Entrada e Saída de Cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, é porque o cmdlet não aceita dados de entrada.

Para ver os tipos de retorno, também conhecidos como tipos de saida, que este cmdlet aceita, consulte Tipos de Entrada e Saída de Cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.

 
Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários
Mostrar:
© 2014 Microsoft