Set-POPSettings

  • 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-POPSettings permite definir as configurações específicas do protocolo POP3 para o servidor que está executando o Microsoft Exchange Server 2007 que tem a função de servidor Acesso para Cliente instalada e está executando o serviço POP3.

Sintaxe

Set-PopSettings [-AuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-Banner <String>] [-CalendarItemRetrievalOption <iCalendar | intranetUrl | InternetUrl | Custom>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-EnableExactRFC822Size <$true | $false>] [-Instance <Pop3AdConfiguration>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat | Tnef>] [-MessageRetrievalSortOrder <Ascending | Descending>] [-OwaServerUrl <String>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-SSLBindings <MultiValuedProperty>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-X509CertificateName <String>]

Descrição detalhada

O cmdlet Set-POPSettings permite especificar as propriedades de POP3 em um servidor de Acesso para Cliente. Você pode executar este cmdlet para um único servidor de Acesso para Cliente que tenha o serviço POP3 instalado ou para todos os computadores do Exchange 2007 na organização que tenham a função de servidor Acesso para Cliente e o serviço POP3 instalados.

Para executar o cmdlet Set-POPSettings, 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 Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Obrigatório Tipo Descrição

AuthenticatedConnectionTimeout

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

Este parâmetro especifica o tempo de espera antes de fechar 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

Este parâmetro especifica o tipo de item de calendário retornado quando o acesso ao calendário é feito com o POP3. Os seguintes valores estão disponíveis:

  • 0:Calendar

  • 1:IntranetUrl

  • 2:InternetUrl

  • 3:Custom

Se estiver usando 3:Custom, você deverá especificar a configuração OWAServerUrl.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro 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 nome de domínio totalmente qualificado (FQDN) 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 RFC822.SIZE correto de cada mensagem de email em uma caixa de correio.

Por padrão, o Exchange 2007 estima o valor RFC822.SIZE pois o Exchange 2007 deve reconstruir o MIME para determinar o tamanho exato. A reconstrução do MIME pode ter impacto sobre o 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 RFC822.SIZE seja o valor exato e não um valor estimado.

Para habilitar o tamanho exato para todos, use o seguinte comando:

Set-ImapSettings -EnableExactRFC822Size:$true

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

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

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.Pop3AdConfiguration

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

Este parâmetro especifica a configuração de autenticação usada para o servidor de Acesso para Cliente executando o serviço POP3. 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 sã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

MessageRetrievalSortOrder

Opcional

Microsoft.Exchange.Data.SortOrder

Este parâmetro especifica a ordem de classificação das mensagens recuperadas. O valor pode ser 0 (Crescente) ou 1 (Decrescente).

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

Este parâmetro especifica o tempo de espera antes de fechar uma conexão ociosa não autenticada. A configuração padrão é de 60 segundos. Os valores possíveis são de 10 a 3600 segundos.

ProxyTargetPort

Opcional

System.Int32

Este parâmetro especifica a porta no servidor back-end do Exchange Server 2003 para a qual o serviço POP3 em um servidor de Acesso para Cliente retransmitirá comandos.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Este parâmetro especifica um servidor de Acesso para Cliente individual na organização para o qual você está especificando configurações de POP3.

SSLBindings

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Se este parâmetro for especificado, o cmdlet retornará a porta IP a ser usada em uma sessão SSL (Secure Sockets Layer).

UnencryptedOrTLSBindings

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parâmetro especifica a porta IP para comunicação pela conexão criptografada por protocolo TLS ou pela conexão que não está criptografada.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Este parâmetro instrui o comando a simular as ações que ele executaria 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

Este 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-PopSettings -Server "CAS01" -UnencryptedOrTLSBindings IPaddress:953