Set-ImapSettings

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

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

Os valores válidos são 00:00:30 a 1:00:00. A configuração padrão é 00:30:00 (30 minutos).

O parâmetro Banner especifica a cadeia de caracteres de texto exibida para conectar clientes IMAP4. O valor padrão é: The Microsoft Exchange IMAP4 service is ready.

O parâmetro CalendarItemRetrievalOption especifica como os itens de calendário são apresentados aos clientes IMAP4. Os valores válidos são:

• 0 ou iCalendar. Esse é o valor padrão.
• 1 ou IntranetUrl
• 2 ou InternetUrl
• 3 ou Personalizado

Se você especificar 3 ou Personalizado, precisará especificar um valor para a configuração do parâmetro OwaServerUrl.

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

• Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

O parâmetro EnableExactRFC822Size especifica como os tamanhos de mensagem são apresentados aos clientes IMAP4. Os valores válidos são:

• $true: calcular o tamanho exato da mensagem. Como essa configuração pode afetar negativamente o desempenho, você deve configurá-lo somente se for exigido pelos clientes IMAP4.
• $false: use um tamanho estimado da mensagem. Esse é o valor padrão.

O parâmetro EnableGSSAPIAndNTLMAuth especifica se as conexões podem usar o NTLM (Integrated autenticação do Windows) usando a interface de programação de aplicativo dos Serviços de Segurança Genérica (GSSAPI). Esta configuração se aplica a conexões em que o protocolo TLS está desabilitado. Os valores válidos são:

• $true: o NTLM para conexões IMAP4 está habilitado. Esse é o valor padrão.
• $false: o NTLM para conexões IMAP4 está desabilitado.

O parâmetro EnforceCertificateErrors especifica se deve impor falhas de validação de certificado SSL (Secure Sockets Layer) válidas. Os valores válidos são:

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

• $true: se o certificado não for válido ou não corresponder ao FQDN do servidor IMAP4 de destino, a tentativa de conexão falhará.
• $false: o servidor não nega conexões IMAP4 com base em erros de certificado. Esse é o valor padrão.

O parâmetro ExtendedProtectionPolicy especifica como a Proteção Estendida para Autenticação é usada. Os valores válidos são:

• Nenhum: Proteção Estendida para Autenticação não é usada. Esse é o valor padrão.
• Permitir: Proteção Estendida para Autenticação só será usada se for compatível com a conexão IMAP4 de entrada. Se não for, a Proteção Estendida para Autenticação não será usada.
• Exigir: proteção estendida para autenticação é necessária para todas as conexões IMAP4. Se a conexão IMAP4 de entrada não der suporte a ela, a conexão será rejeitada.

A Proteção Estendida para Autenticação aprimora a proteção e o tratamento de credenciais por autenticação do Windows integrado (também conhecido como NTLM), portanto, recomendamos que você a use se for compatível com seus clientes (instalações padrão do Windows 7 ou posterior e windows Server 2008 R2 ou posteriores o dão suporte).

O parâmetro ExternalConnectionSettings especifica o nome do host, a porta e o método de criptografia usado por clientes IMAP4 externos (conexões IMAP4 de fora da rede corporativa).

Esse parâmetro usa a sintaxe HostName:Port:[<TLS | SSL>]. O valor do método de criptografia é opcional (em branco indica conexões não criptografadas).

O valor padrão está em branco ($null), o que significa que nenhuma configuração de conexão IMAP4 externa está configurada.

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

A combinação de métodos de criptografia e portas especificadas para esse parâmetro precisa corresponder aos métodos e portas de criptografia correspondentes especificados pelos parâmetros SSLBindings e UnencryptedOrTLSBindings.

O parâmetro InternalConnectionSettings especifica o nome do host, a porta e o método de criptografia usado por clientes IMAP4 internos (conexões IMAP4 de dentro de sua rede corporativa). Essa configuração também é usada quando uma conexão IMAP4 é encaminhada para outro servidor exchange que está executando o serviço Microsoft Exchange IMAP4.

Esse parâmetro usa a sintaxe HostName:Port:[<TLS | SSL>]. O valor do método de criptografia é opcional (em branco indica conexões não criptografadas).

O valor padrão é <ServerFQDN>:993:SSL,<ServerFQDN>:143:TLS.

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

A combinação de métodos de criptografia e portas especificadas para esse parâmetro precisa corresponder aos métodos e portas de criptografia correspondentes especificados pelos parâmetros SSLBindings e UnencryptedOrTLSBindings.

O parâmetro LogFileLocation especifica a localização dos arquivos de log do protocolo IMAP4. O local padrão é %ExchangeInstallPath%Logging\Imap4.

Esse parâmetro só é significativo quando o valor do parâmetro ProtocolLogEnabled é $true.

O parâmetro LogFileRollOverSettings especifica a frequência com que o registro em log do protocolo IMAP4 cria um novo arquivo de log. Os valores válidos são:

• 1 ou Hourly. Esse é o valor padrão no Exchange 2019 e no Exchange 2016.
• 2 ou Daily. Esse é o valor padrão no Exchange 2013 e no Exchange 2010.
• 3 ou Weekly.
• 4 ou Monthly.

Esse parâmetro só é significativo quando o valor do parâmetro LogPerFileSizeQuota é 0 e o valor do parâmetro ProtocolLogEnabled é $true.

O parâmetro LoginType especifica o método de autenticação para conexões IMAP4. Os valores válidos são:

• 1 ou PlainTextLogin.
• 2 ou PlainTextAuthentication.
• 3 ou SecureLogin. Esse é o valor padrão.

O parâmetro LogPerFileSizeQuota especifica o tamanho máximo de um arquivo de log de protocolo IMAP4.

Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).

• B (bytes)
• KB (quilobytes)
• MB (megabytes)
• GB (gigabytes)
• TB (terabytes)

TB (terabytes)

O valor padrão é 0, o que significa que um novo arquivo de log de protocolo IMAP4 é criado na frequência especificada pelo parâmetro LogFileRollOverSettings.

Esse parâmetro só é significativo quando o valor do parâmetro ProtocolLogEnabled é $true.

O parâmetro MaxCommandSize especifica o tamanho máximo em bytes de um único comando IMAP4. Os valores válidos são de 1024 a 16384. O valor padrão é 10240.

O parâmetro MaxConnectionFromSingleIP especifica o número máximo de conexões IMAP4 aceitas pelo servidor Exchange de um único endereço IP. Os valores válidos são de 1 a 2147483647. O valor padrão é 2147483647.

O parâmetro MaxConnections especifica o número máximo de conexões IMAP4 aceitas pelo servidor exchange. Os valores válidos são de 1 a 2147483647. O valor padrão é 2147483647.

O parâmetro MaxConnectionsPerUser especifica o número máximo de conexões IMAP4 permitidas para cada usuário. Os valores válidos são de 1 a 2147483647. O valor padrão é 16.

O parâmetro MessageRetrievalMimeFormat especifica a codificação MIME de mensagens. Os valores válidos são:

• 0 ou TextOnly.
• 1 ou HtmlOnly.
• 2 ou HtmlAndTextAlternative.
• 3 ou TextEnrichedOnly.
• 4 ou TextEnrichedAndTextAlternative.
• 5 ou BestBodyFormat. Esse é o valor padrão.
• 6 ou Tnef.

O parâmetro OwaServerUrl especifica a URL usada para recuperar informações de calendário para instâncias de itens de calendário Outlook na Web personalizados.

O parâmetro PreAuthenticatedConnectionTimeout especifica o período de tempo para aguardar antes de fechar uma conexão IMAP4 ociosa que não é autenticada.

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

Valores válidos são00:00:30 a 1:00:00. O valor padrão é 00:01:00 (um minuto).

O parâmetro ProtocolLogEnabled especifica se deve habilitar o registro em log de protocolo para IMAP4. Os valores válidos são:

• $true: o registro em log de protocolo IMAP4 está habilitado.
• $false: o registro em log de protocolo IMAP4 está desabilitado. Esse é o valor padrão.

O parâmetro ProxyTargetPort especifica a porta no serviço de back-end do Microsoft Exchange IMAP4 que escuta conexões de cliente que são proxiedas do serviço Microsoft Exchange IMAP4. O valor padrão é 1993.

O parâmetro Servidor especifica o servidor Exchange em que você deseja executar esse comando. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

• Nome
• FQDN
• DN (nome diferenciado)
• DN Herdado do Exchange

DN Herdado do Exchange

O parâmetro ShowHiddenFoldersEnabled especifica se as pastas de caixa de correio ocultas estão visíveis. Os valores válidos são:

• $true: as pastas ocultas estão visíveis.
• $false: pastas ocultas não estão visíveis. Esse é o valor padrão.

O parâmetro SSLBindings especifica o endereço IP e a porta TCP usada para conexão IMAP4 que sempre é criptografada pelo SSL/TLS. Esse parâmetro usa a sintaxe IPv4OrIPv6Address:Port.

O valor padrão é [::]:993,0.0.0.0:993.

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

O parâmetro SuppressReadReceipt especifica se é necessário impedir que recibos de leitura duplicados sejam enviados para clientes IMAP4 que têm os recibos de leitura para mensagens que envio configurado em seu programa de email IMAP4. Os valores válidos são:

• $true: o remetente recebe um recibo de leitura somente quando o destinatário abre a mensagem.
• $false: o remetente recebe um recibo de leitura quando o destinatário baixa a mensagem e quando o destinatário abre a mensagem. Esse é o valor padrão.

O parâmetro UnencryptedOrTLSBindings especifica o endereço IP e a porta TCP usadas para conexões IMAP4 não criptografadas ou conexões IMAP4 criptografadas usando TLS (STARTTLS) oportunistas após o aperto de mão de protocolo não criptografado inicial. Esse parâmetro usa a sintaxe IPv4OrIPv6Address:Port.

O valor padrão é [::]:143,0.0.0.0:143.

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

O parâmetro X509CertificateName especifica o certificado usado para criptografar conexões de cliente IMAP4.

Um valor válido para esse parâmetro é o FQDN dos parâmetros ExternalConnectionSettings ou InternalConnectionSettings (por exemplo, mail.contoso.com ou mailbox01.contoso.com).

Se você usar um certificado de assunto único ou um certificado SAN (nome alternativo de assunto), também precisará atribuir o certificado ao serviço IMAP do Exchange usando o cmdlet Enable-ExchangeCertificate.

Se você usar um certificado curinga, não precisará atribuir o certificado ao serviço IMAP do Exchange.