.png)
Set-ImapSettings
Aplica-se a: Exchange Server 2013, Exchange Online
Tópico modificado em: 2012-12-10
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 | ||
| 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 é
Se estiver usando | ||
| 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
| ||
| 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 | ||
| 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 A configuração padrão é | ||
| 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
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 é | ||
| 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:
Esta configuração só é aplicável quando o valor do parâmetro LogPerFileSizeQuota está definido como | ||
| 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 é
| ||
| 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 | ||
| 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 é
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 | ||
| 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 | ||
| 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 é | ||
| 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
Os seguintes itens são valores e descrições válidos para este parâmetro:
| ||
| 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 é | ||
| 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>. |
Observação: Para ver os tipos de entrada que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlets. 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 saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlets. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.
Deseja participar?
