Test-ImapConnectivity
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2010-08-18
Use o cmdlet Test-ImapConnectivity para verificar se o serviço IMAP4 está em execução conforme esperado. O cmdlet Test-ImapConnectivity pode ser usado para testar a funcionalidade do IMAP4 para um servidor de Acesso para Cliente especificado para todas as caixas de correio de servidores Exchange 2007 no mesmo site do Active Directory.
Sintaxe
Test-ImapConnectivity [-ClientAccessServer <ServerIdParameter>] [-Confirm [<SwitchParameter>]] [-ConnectionType <Plaintext | Tls | Ssl>] [-DomainController <Fqdn>] [-LightMode <SwitchParameter>] [-MailboxCredential <PSCredential>] [-MailboxServer <ServerIdParameter>] [-MonitoringContext <SwitchParameter>] [-PerConnectionTimeout <Int32>] [-PortClientAccessServer <Int32>] [-ResetTestAccountCredentials <SwitchParameter>] [-Timeout <UInt32>] [-TrustAnySSLCertificate <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Use o cmdlet Test-ImapConnectivity para verificar se o serviço IMAP4 está em execução conforme esperado. O cmdlet Test-ImapConnectivity pode ser usado para testar a funcionalidade do IMAP4 para um servidor de Acesso para Cliente especificado.
Para executar o cmdlet Test-PopConnectivity para testar a funcionalidade do IMAP4 em um servidor de Acesso para Cliente, você deve usar uma conta à qual esteja delegada a função de Administrador do Exchange Server e a associação no 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 |
|---|---|---|---|
ClientAccessServer |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Esse parâmetro especifica o nome do servidor de Acesso para Cliente para teste. Não use esse parâmetro com o parâmetro URL. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm 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. |
ConnectionType |
Opcional |
Microsoft.Exchange.Monitoring.ProtocolConnectionType |
Este parâmetro especifica o tipo de conexão usada para conectar ao servidor de Acesso para Cliente. |
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 cmdlet. |
LightMode |
Opcional |
System.Management.Automation.SwitchParameter |
Esse parâmetro não é implementado no cmdlet Test-PopConnectivity. Usar este parâmetro não altera o comportamento do cmdlet. Dica Este cmdlet é implementado para outros cmdlets de diagnóstico do Exchange 2007. |
MailboxCredential |
Opcional |
System.Management.Automation.PSCredential |
Esse parâmetro inclui a credencial de caixa de correio para um teste único de URL. |
MailboxServer |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Esse parâmetro especifica o nome do servidor de Caixa de Correio a ser testado. Se não for especificado, todos os servidores de Caixa de Correio no site local do Active Directory serão testados. |
MonitoringContext |
Opcional |
System.Management.Automation.SwitchParameter |
Se esse parâmetro estiver incluído, a tarefa será executada pelo agendamento do MOM (Microsoft Operations Manager). A execução da tarefa com esse parâmetro sem MOM provocará a falha da tarefa. Se esse parâmetro for excluído, a tarefa deverá ser executada por um administrador. |
PerConnectionTimeout |
Opcional |
System.Int32 |
Esse parâmetro especifica quanto tempo será preciso aguardar por conexão, em segundos, até a conclusão da operação de teste. O valor padrão do parâmetro PerConnectionTimeout é 24 segundos. Você deve especificar um valor de tempo limite maior que 0 segundos e menor que 120 segundos. Recomendamos que você sempre configure esse parâmetro com um valor de 5 segundos ou mais. |
PortClientAccessServer |
Opcional |
System.Int32 |
Esse parâmetro especifica a porta a ser utilizada para se conectar ao servidor de Acesso para Cliente que você usará com o cmdlet Test-ImapConnectivity. |
ResetTestAccountCredentials |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro ResetTestAccountCredentials redefine a senha da conta de teste usada para executar esse comando. Geralmente, a senha da conta de teste é redefinida a cada sete dias, caso você esteja usando o Microsoft System Center Operations Manager para gerenciar o ambiente do Exchange. O uso desse sinalizador força uma redefinição de senha a qualquer momento, se isso for necessário por razões de segurança. |
Timeout |
Opcional |
System.UInt32 |
Esse parâmetro especifica quanto tempo será preciso aguardar, em segundos, até a conclusão da operação de teste. O valor padrão de Timeout é 30 segundos. Você deve especificar um valor de tempo limite maior que 0 segundos e menor que 1 hora (3600 segundos). Recomendamos que você sempre configure esse parâmetro com um valor de 5 segundos ou mais. |
TrustAnySSLCertificate |
Opcional |
System.Management.Automation.SwitchParameter |
Se esse parâmetro for usado, as falhas de validação do certificado SSL (Secure Sockets Layer) não serão informadas. Esse parâmetro permite que o cmdlet Test-ImapConnectivity verifique o serviço IMAP4 sem gerar erro quando o certificado não corresponde à URL do servidor de Acesso para Cliente. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro WhatIf instrui o comando a simular as ações que ele executará 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. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exemplo
O primeiro exemplo de código testa a conectividade do IMAP4 para o servidor de Acesso para Cliente Contoso12, usando as credenciais do usuário contoso\kweku.
O segundo exemplo de código testa a conectividade do IMAP4 de um servidor de Acesso para Cliente específico chamado Contoso12 e testa todas as caixas de correio do Exchange 2007.
Test-ImapConnectivity -ClientAccessServer:Contoso12 -MailboxCredential:(get-credential contoso\kweku)
Test-ImapConnectivity -ClientAccessServer:Contoso12