Compartilhar via

Set-POPSettings (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-11

O cmdlet Set-POPSettings permite especificar as configurações 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>] [-DomainController <Fqdn>] [-Instance <Pop3AdConfiguration>] [-LoginType <PlainTextLogin | PlainTextAuthentication | SecureLogin>] [-MaxCommandSize <Int32>] [-MaxConnectionFromSingleIP <Int32>] [-MaxConnections <Int32>] [-MaxConnectionsPerUser <Int32>] [-MessageRetrievalMimeFormat <TextOnly | HtmlOnly | HtmlAndTextAlternative | TextEnrichedOnly | TextEnrichedAndTextAlternative | BestBodyFormat>] [-MessageRetrievalSortOrder <Ascending | Descending>] [-OwaServerUrl <String>] [-PreAuthenticatedConnectionTimeout <EnhancedTimeSpan>] [-ProxyTargetPort <Int32>] [-Server <ServerIdParameter>] [-SSLBindings <MultiValuedProperty>] [-UnencryptedOrTLSBindings <MultiValuedProperty>] [-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 a conta à qual esteja delegado o seguinte:

  • Função de Administrador do Exchange Server e grupo Administradores local para o 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 Necessá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 você estiver usando 3:Custom, deverá especificar a configuração OWAServerUrl.

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.

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 é 40 bytes. Os valores possíveis são de 40 a 1024 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 bytes. 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:UUEncode

  • 5:UUEncodeBinHex

  • 6: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.

X509CertificateName

Opcional

System.String

Esse 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