Set-ImapSettings

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

Use o cmdlet Set-ImapSettings para modificar as configurações do serviço Microsoft Exchange IMAP4 em servidores Exchange. Esse serviço existe em servidores Exchange que têm a função de servidor Acesso para Cliente instalada e é usado por clientes IMAP4 para se conectar ao Exchange.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Default (Default)

Set-ImapSettings
    [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>]
    [-Banner <String>]
    [-CalendarItemRetrievalOption <CalendarItemRetrievalOptions>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-EnableExactRFC822Size <Boolean>]
    [-EnableGSSAPIAndNTLMAuth <Boolean>]
    [-EnforceCertificateErrors <Boolean>]
    [-ExtendedProtectionPolicy <ExtendedProtectionTokenCheckingMode>]
    [-ExternalConnectionSettings <MultiValuedProperty>]
    [-InternalConnectionSettings <MultiValuedProperty>]
    [-LogFileLocation <String>]
    [-LogFileRollOverSettings <LogFileRollOver>]
    [-LoginType <LoginOptions>]
    [-LogPerFileSizeQuota <Unlimited>]
    [-MaxCommandSize <Int32>]
    [-MaxConnectionFromSingleIP <Int32>]
    [-MaxConnections <Int32>]
    [-MaxConnectionsPerUser <Int32>]
    [-MessageRetrievalMimeFormat <MimeTextFormat>]
    [-OwaServerUrl <Uri>]
    [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>]
    [-ProtocolLogEnabled <Boolean>]
    [-ProxyTargetPort <Int32>]
    [-Server <ServerIdParameter>]
    [-ShowHiddenFoldersEnabled <Boolean>]
    [-SSLBindings <MultiValuedProperty>]
    [-SuppressReadReceipt <Boolean>]
    [-UnencryptedOrTLSBindings <MultiValuedProperty>]
    [-WhatIf]
    [-X509CertificateName <String>]
    [<CommonParameters>]

Description

Você pode executar o cmdlet Set-ImapSettings para um único servidor Exchange que esteja executando o serviço Microsoft Exchange IMAP4 ou para todos os servidores Exchange que estejam executando o serviço Microsoft Exchange IMAP4.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Set-ImapSettings -Server "MBX01" -UnencryptedOrTLSBindings 10.0.0.0:143

Este exemplo configura a conexão IMAP4 não criptografada ou criptografada por STARTTLS com o servidor chamado MBX01 usando o endereço IP local 10.0.0.0 na porta TCP 143.

Exemplo 2

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

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.

Exemplo 3

Set-ImapSettings -LogPerFileSizeQuota 2MB

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).

Exemplo 4

Set-ImapSettings -LogPerFileSizeQuota 0 -LogFileRollOverSettings Hourly

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

Exemplo 5

Set-ImapSettings -X509CertificateName mail.contoso.com

Este exemplo especifica o certificado que contém mail.contoso.com é usado para criptografar conexões de cliente IMAP4.

Observação: para certificados de entidade única ou certificados SAN, você também precisa atribuir o certificado ao serviço IMAP do Exchange usando o cmdlet Enable-ExchangeCertificate. Para certificados curinga, você não precisa atribuir o certificado ao serviço IMAP do Exchange (você receberá um erro se tentar).

Parâmetros

-AuthenticatedConnectionTimeout

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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).

Propriedades do parâmetro

Tipo:EnhancedTimeSpan
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Banner

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CalendarItemRetrievalOption

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 valor é o padrão.
  • 1 ou IntranetUrl
  • 2 ou InternetUrl
  • 3 ou Personalizado

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

Propriedades do parâmetro

Tipo:CalendarItemRetrievalOptions
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DomainController

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Tipo:Fqdn
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EnableExactRFC822Size

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

  • $true: Calcule o tamanho exato da mensagem. Como essa configuração pode afetar negativamente o desempenho, você deve configurá-la somente se ela for exigida por seus clientes IMAP4.
  • $false: use um tamanho estimado de mensagem. Esse valor é o padrão.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EnableGSSAPIAndNTLMAuth

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro EnableGSSAPIAndNTLMAuth especifica se as conexões podem usar a autenticação do Windows integrada (NTLM) usando a interface de programação de aplicativos 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 valor é o padrão.
  • $false: NTLM para conexões IMAP4 está desabilitado.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EnforceCertificateErrors

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro EnforceCertificateErrors especifica se é necessário impor falhas de validação de certificado TLS (Transport Layer Security). Os valores válidos são:

  • $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 valor é o padrão.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExtendedProtectionPolicy

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

  • Nenhum: a Proteção Estendida para Autenticação não é usada. Esse valor é o padrão.
  • Permitir: a Proteção Estendida para Autenticação será usada somente se tiver suporte da conexão IMAP4 de entrada. Se não estiver, a Proteção Estendida para Autenticação não será usada.
  • Exigir: a Proteção Estendida para Autenticação é necessária para todas as conexões IMAP4. Se a conexão IMAP4 de entrada não for compatível, a conexão será rejeitada.

A Proteção Estendida para Autenticação aprimora a proteção e o manuseio de credenciais por autenticação do Windows Integrada (também conhecida como NTLM), portanto, é altamente recomendável usá-la se ela for compatível com seus clientes (as instalações padrão do Windows 7 ou posterior e do Windows Server 2008 R2 ou posterior dão suporte a ela).

Propriedades do parâmetro

Tipo:ExtendedProtectionTokenCheckingMode
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExternalConnectionSettings

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro ExternalConnectionSettings especifica o nome do host, a porta e o método de criptografia usados 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 é em branco ($null), o que significa que nenhuma configuração de conexão IMAP4 externa foi definida.

Para inserir vários valores e substituir as 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 de criptografia e portas correspondentes especificados pelos parâmetros SSLBindings e UnencryptedOrTLSBindings.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InternalConnectionSettings

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro InternalConnectionSettings especifica o nome do host, a porta e o método de criptografia usados 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 esteja executando o serviço IMAP4 do Microsoft Exchange.

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 as 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 de criptografia e portas correspondentes especificados pelos parâmetros SSLBindings e UnencryptedOrTLSBindings.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LogFileLocation

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LogFileRollOverSettings

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 valor é o padrão no Exchange 2019 e no Exchange 2016.
  • 2 ou Daily. Esse valor é o 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.

Propriedades do parâmetro

Tipo:LogFileRollOver
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LoginType

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 valor é o padrão.

Propriedades do parâmetro

Tipo:LoginOptions
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LogPerFileSizeQuota

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro LogPerFileSizeQuota especifica o tamanho máximo de um arquivo de log do 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)

Valores não qualificados normalmente são tratados como bytes, mas valores pequenos podem ser arredondados para cima para o kilobyte mais próximo.

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

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

Propriedades do parâmetro

Tipo:Unlimited
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MaxCommandSize

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MaxConnectionFromSingleIP

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MaxConnections

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MaxConnectionsPerUser

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MessageRetrievalMimeFormat

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 valor é o padrão.
  • 6 ou Tnef.

Propriedades do parâmetro

Tipo:MimeTextFormat
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OwaServerUrl

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Propriedades do parâmetro

Tipo:Uri
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PreAuthenticatedConnectionTimeout

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro PreAuthenticatedConnectionTimeout especifica o período de tempo a 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.

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

Propriedades do parâmetro

Tipo:EnhancedTimeSpan
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProtocolLogEnabled

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProxyTargetPort

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Server

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Propriedades do parâmetro

Tipo:ServerIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ShowHiddenFoldersEnabled

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro ShowHiddenFoldersEnabled especifica se as pastas ocultas da caixa de correio 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 valor é o padrão.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SSLBindings

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro SSLBindings especifica o endereço IP e a porta TCP usados para a conexão IMAP4 sempre criptografada por 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 as 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"...}.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SuppressReadReceipt

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro SuppressReadReceipt especifica se as confirmações de leitura duplicadas devem ser impedidas de serem enviadas para clientes IMAP4 que têm a configuração Enviar confirmações de leitura para mensagens que envio configurada no programa de email IMAP4. Os valores válidos são:

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

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UnencryptedOrTLSBindings

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

O parâmetro UnencryptedOrTLSBindings especifica o endereço IP e a porta TCP usados para conexões IMAP4 não criptografadas ou conexões IMAP4 criptografadas usando TLS oportunista (STARTTLS) após o handshake inicial do protocolo não criptografado. 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 as 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"...}.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-X509CertificateName

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 entidade única ou um certificado de SAN (nome alternativo de entidade), 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á atribuí-lo ao serviço IMAP do Exchange.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, 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.