Como se conectar ao PowerShell do Exchange Online

Veja como conferir o módulo ExchangeOnlineManagement, autenticar com MFA e testar uma conexão ao Exchange Online com consultas de leitura e exemplos fictícios.
Banner abstrato azul e branco com blocos tecnológicos

Neste artigo

Conectar o PowerShell ao Exchange Online permite consultar e administrar o ambiente de e-mail Microsoft 365 de maneira repetível. O ponto de partida atual é o módulo ExchangeOnlineManagement e um fluxo de autenticação moderna, compatível com MFA. Tutoriais antigos baseados em sessões remotas e autenticação básica não devem ser reaplicados sem revisão.

Este guia apresenta uma conexão interativa e consultas simples, sem modificar caixas postais. Todos os endereços de exemplo são fictícios e usam o domínio reservado example.com. A execução deve ocorrer somente por um administrador autorizado, em uma estação de administração confiável e seguindo as políticas da organização.

Antes de abrir a sessão

Confira a versão do PowerShell, o sistema operacional e os requisitos atuais do módulo na documentação Microsoft. Não existe uma recomendação segura de manter qualquer versão antiga apenas porque um comando já funcionou no passado. Os requisitos podem mudar conforme a versão de ExchangeOnlineManagement utilizada.

Também é necessário que a conta tenha as permissões apropriadas no Exchange Online. O controle de acesso baseado em funções, chamado RBAC, determina quais comandos e parâmetros estarão disponíveis. Conectar com sucesso não significa receber autorização para executar toda atividade administrativa.

Use uma conta administrativa identificável e com privilégios proporcionais à tarefa. Evite contas compartilhadas e não utilize uma conta de alto privilégio apenas por conveniência. A proteção das identidades deve fazer parte do mesmo processo descrito no guia de Microsoft Entra ID.

Referência oficial para esta orientação: Conectar ao Exchange Online PowerShell.

1. Verifique o ambiente e o módulo disponível

Os comandos abaixo consultam a versão da sessão e as instalações do módulo encontradas no computador:

$PSVersionTable.PSVersion
Get-Module ExchangeOnlineManagement -ListAvailable |
    Select-Object Name, Version, Path

Se forem encontradas várias versões, registre qual será utilizada. Isso facilita reproduzir um teste e identificar diferenças entre estações. Não remova versões ou altere dependências automaticamente em uma máquina usada por outras rotinas administrativas.

A comparação com os requisitos oficiais precisa considerar todo o conjunto: sistema, PowerShell e módulo. Uma falha de carregamento pode estar relacionada a compatibilidade e não a uma senha incorreta. Anotar essas informações antes da conexão evita tentativas desnecessárias sobre a conta.

2. Instale ou atualize quando necessário

Para uma primeira instalação no escopo do usuário atual, a documentação Microsoft utiliza a distribuição pela PowerShell Gallery:

Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser

Confira o repositório e os avisos exibidos antes de aceitar a instalação. Não substitua essa origem por arquivos recebidos por mensagem ou por um pacote de procedência desconhecida. Em organizações com distribuição centralizada, siga o procedimento de TI para obter o módulo aprovado.

Uma instalação existente pode ser atualizada com:

Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser

Use o mesmo escopo da instalação original. Em um ambiente controlado, avalie e teste a atualização antes de utilizá-la em rotinas de produção. Não é necessário desabilitar proteções da estação ou aplicar uma política de execução irrestrita para seguir este tutorial.

3. Carregue o módulo e autentique a conta

O carregamento explícito ajuda a deixar a etapa visível durante o procedimento:

Import-Module ExchangeOnlineManagement
Connect-ExchangeOnline -UserPrincipalName administrador@example.com

Substitua o endereço fictício pela conta autorizada da organização. Conclua o login apenas na janela ou no navegador legítimo apresentado pelo fluxo Microsoft. A senha e os fatores adicionais de autenticação não devem ser digitados em um arquivo de script, enviados ao atendimento ou copiados para um chat.

Se houver MFA, o método configurado será solicitado conforme as políticas do ambiente. Aprove somente uma solicitação que você acabou de iniciar e reconhece. Não trate uma aprovação inesperada como uma etapa normal nem tente contornar uma política de Acesso Condicional para fazer o comando funcionar.

4. Confirme a sessão com consultas de leitura

Depois de autenticar, confira as informações da conexão e faça uma consulta limitada:

Get-ConnectionInformation
Get-EXOMailbox -ResultSize 5 |
    Select-Object DisplayName, PrimarySmtpAddress

O primeiro comando ajuda a identificar o contexto da sessão. O segundo consulta uma pequena quantidade de caixas postais, conforme as permissões da conta. Esses exemplos não alteram caixas, mas os resultados podem conter dados corporativos e devem ser tratados como informação interna.

Não envie uma listagem real de usuários como comprovante público de funcionamento. Para registrar um teste, prefira um resultado controlado e com os dados necessários reduzidos. Se houver mais de uma organização administrada, confirme cuidadosamente o ambiente conectado antes de qualquer atividade posterior.

5. Encerre a conexão ao concluir

Finalize a sessão quando terminar:

Disconnect-ExchangeOnline

Leia e responda à confirmação exibida pelo comando, quando aplicável. Fechar uma janela pode encerrar a sessão local, mas um procedimento documentado de desconexão é mais claro para quem executa e revisa o trabalho. Também evita que uma sessão seja reaproveitada sem conferir seu contexto.

Como investigar erros sem enfraquecer a segurança

O módulo não carrega ou o comando não existe

Verifique as versões e os requisitos do ambiente. Confira também a origem da instalação e a sessão em que o módulo foi carregado. Não copie comandos de instalação com parâmetros desconhecidos apenas para eliminar uma mensagem de erro.

A autenticação falha

Registre o horário, a mensagem e o identificador de correlação, quando fornecido. A causa pode envolver conta, política, dispositivo, conectividade ou método de autenticação. Analise os registros autorizados do ambiente. Não desative MFA nem altere regras de acesso por tentativa e erro.

A sessão conecta, mas uma consulta é negada

Esse resultado pode indicar falta de permissão para a tarefa. Confira a função necessária e solicite o acesso adequado pelo fluxo da empresa. Conceder administração global como solução padrão amplia o risco e prejudica o princípio de menor privilégio.

Automação sem interação exige outro desenho

Uma tarefa agendada não deve guardar a senha de um usuário em texto puro para reproduzir o login manual. A Microsoft documenta modelos próprios de autenticação para aplicações e identidades gerenciadas, com requisitos específicos de permissões e administração.

Antes de automatizar, defina a finalidade, os comandos permitidos, o responsável e a proteção das credenciais ou certificados utilizados. Mantenha registros das execuções e um procedimento de revogação. Este tutorial não cria uma identidade de aplicação nem concede permissões: ele demonstra somente uma sessão interativa autorizada.

Como a PROSOL TI pode ajudar

Quando a necessidade envolve licenciamento Microsoft, equipamentos ou adequação do ambiente, a PROSOL TI pode apoiar a avaliação comercial. Serviços de configuração e administração técnica são executados por empresas parceiras, conforme o escopo contratado.

No contato comercial, descreva o objetivo e a dificuldade encontrada, sem enviar senhas, códigos MFA ou dados desnecessários dos usuários. Um procedimento seguro deixa claros o ambiente, a autorização e os limites da atividade, além de simplesmente obter uma conexão bem-sucedida.

Referências técnicas

Documentação consultada na revisão editorial de 30/10/2026. Recursos e licenciamento devem ser conferidos para o ambiente e a oferta vigente.

Precisa de uma solução para sua empresa?

Fale com a equipe da PROSOL TI e solicite uma cotação de produtos, serviços ou soluções de TI de acordo com a necessidade do seu negócio.

Serviços técnicos complementares são executados por empresas parceiras, conforme o escopo definido.

SOLICITAR ORÇAMENTO PELO WHATSAPP

Continue explorando os conteúdos da PROSOL TI.