Conectar-se ao Exchange Online PowerShell

O Exchange Online PowerShel permite o gerenciamento de suas configurações do Exchange Online por meio da linha de comando. Use o Windows PowerShell em seu computador local para criar uma sessão do PowerShell remoto para o Exchange Online. É um processo simples de três etapas em que você insere suas credenciais do Office 365, fornece as configurações de conexão necessárias e, então, importa os cmdlets do Exchange Online em sua sessão local do Windows PowewShell de forma que possa usá-los.

Important

Se você deseja usar uma MFA (autenticação multifator) para se conectar ao Exchange Online PowerShel, é preciso baixar e usar o Módulo do Exchange Online PowerShell Remoto. Para obter mais informações, confira Conectar-se ao Exchange Online PowerShell usando a autenticação multifator.

Se você é um cliente autônomo do Exchange Online Protection (EOP) (por exemplo, se você está usando o EOP para proteger seu ambiente de email local), use as instruções de conexão em Conectar ao PowerShell do Exchange Online Protection. Se sua assinatura autônoma de EOP for Exchange Enterprise CAL with Services (inclui prevenção de perda de dados (DLP) e relatórios usando serviços da Web), as instruções de conexão neste tópico funcionarão para você.

O que você precisa saber antes de começar?

  • Tempo estimado para conclusão: 5 minutos

  • Você pode usar as seguintes versões do Windows:

  • O Windows PowerShell precisa ser configurado para executar scripts e, por padrão, ele não é. Ao tentar se conectar, você obtém o seguinte erro:

    Files cannot be loaded because running scripts is disabled on this system. Provide a valid certificate with which to sign the files.

    Para permitir que todos os scripts do PowerShell que você baixar da Internet sejam assinados por um fornecedor confiável, execute o seguinte comando em uma janela elevada do Windows PowerShell (uma janela do Windows PowerShell que você abre selecionando Executar como administrador):

    Set-ExecutionPolicy RemoteSigned
    

    Você só precisa definir essa configuração uma vez em seu computador, e não sempre que se conectar.

  • O Gerenciamento Remoto do Windows (WinRM) no seu computador precisa permitir a autenticação básica (habilitada por padrão). Para verificar se a autenticação básica está habilitada, execute este comando em um Prompt de Comando:

    winrm get winrm/config/client/auth
    

    Caso não veja o valor Basic = true, será necessário executar este comando para habilitar a autenticação básica do WinRM:

    winrm set winrm/config/client/auth @{Basic="true"}
    

    Se a autenticação básica estiver desabilitada, você receberá este erro ao tentar se conectar:

    The WinRM client cannot process the request. Basic authentication is currently disabled in the client configuration. Change the client configuration and try the request again.

Tip

Está com problemas? Peça ajuda nos fóruns do Exchange. Visite os fóruns em: Exchange Online ou Proteção do Exchange Online.

Important

Em 13 de outubro de 2020, desativaremos a autenticação básica do PowerShell Remoto (RPS) no Exchange Online.

Conectar-se ao Exchange Online

  1. Em seu computador local, abra o Windows PowerShell e execute o comando a seguir.

    $UserCredential = Get-Credential
    

    Na caixa de diálogo Solicitação de Credencial do Windows PowerShell, digite sua conta corporativa ou de estudante e senha, e clique em OK.

  2. Execute o seguinte comando:

    $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection
    

    Observações:

    • Para o Office 365 operado pela 21Vianet, use o valor ConnectionUri: https://partner.outlook.cn/PowerShell

    • Para o Office 365 Germany, use o valor ConnectionUri: https://outlook.office.de/powershell-liveid/

    • Para a GCC Superior (Nuvem Superior da Comunidade Governamental) do Office 365, use o valor ConnectionUri: https://outlook.office365.us/powershell-liveid/

    • Se você estiver atrás de um servidor proxy, execute este comando primeiro: $ProxyOptions = New-PSSessionOption -ProxyAccessType <Value>, no qual o valor ProxyAccessType é IEConfig, WinHttpConfig ou AutoDetect.

      Em seguida, adicione o seguinte parâmetro e valor ao final do comando $Session = ...: -SessionOption $ProxyOptions.

      Para saber mais, confira New-PSSessionOption.

  3. Execute o seguinte comando:

    Import-PSSession $Session -DisableNameChecking
    

Note

Certifique-se de desconectar a sessão do PowerShell remoto quando terminar. Se você fechar a janela do Windows PowerShell sem se desconectar da sessão, poderá esgotar todas as sessões do PowerShell remoto disponíveis para você e será necessário aguardar a expiração das sessões. Para desconectar a sessão remota do PowerShell, execute o comando a seguir.

Remove-PSSession $Session

Como saber se funcionou?

Após a etapa 3, os cmdlets do Exchange Online são importados para sua sessão local do Windows PowerShell e é possível acompanhar por uma barra de progresso. Se nenhum erro aparecer, a conexão terá sido estabelecida. Execute um cmdlet do Exchange Online como um teste rápido; por exemplo, o Get-Mailbox, e confira os resultados.

Caso você receba erros, verifique os seguintes requisitos:

  • Um problema comum é uma senha incorreta. Execute as três etapas novamente e preste muita atenção ao nome de usuário e à senha inseridos na Etapa 1.

  • Para ajudar a impedir DoS (ataques de negação de serviço), existe um limite de três conexões remotas abertas do PowerShell para a sua organização do Exchange Online.

  • A conta que você usa para se conectar ao Exchange Online deve estar habilitada para o PowerShell remoto. Para saber mais, confira o artigo Habilitar ou desabilitar o acesso ao PowerShell no Exchange Online.

  • O tráfego da porta TCP 80 precisa estar aberto entre seu computador local e o Office 365. Provavelmente ele está aberto, mas é algo a ser considerado caso a sua organização tenha uma política de acesso à Internet restritiva.

  • Se sua organização usa autenticação federada e seu provedor de identidade (IDP) e/ou serviço de token de segurança (STS) não estiver disponível ao público, você não poderá usar uma conta federada para se conectar ao PowerShell do Exchange Online. Em vez disso, crie e use uma conta não federada no Office 365 para se conectar ao PowerShell do Exchange Online.

Confira também

Os cmdlets utilizados neste tópico são do Windows PowerShell. Para saber mais sobre esses cmdlets, veja os tópicos a seguir.

Para obter mais informações sobre como gerenciar o Office 365, confira Gerenciar o Office 365.