Conectar ao Exchange Server usando o PowerShell remoto

Artigo
04/06/2022
3 minutos para o fim da leitura

Se você não tiver as ferramentas de gerenciamento do Exchange instaladas em seu computador local, poderá usar o Windows PowerShell para criar uma sessão remota do PowerShell para um servidor Exchange. É um processo simples de três etapas, em que você insere suas credenciais, fornece as configurações de conexão necessárias e importa os cmdlets do Exchange para sua sessão local do Windows PowerShell para que você possa usá-las.

Observação

Recomendamos que você use o Exchange Management Shell em qualquer computador que você usa para administrar extensivamente os servidores do Exchange. Você obterá o Shell de Gerenciamento do Exchange ao instalar as ferramentas de gerenciamento do Exchange. Para obter mais informações, confira Instalar as Ferramentas de Gerenciamento do Exchange Server e Abrir o Exchange Management Shell. Para obter mais informações sobre o Exchange Management Shell, confira Exchange Server PowerShell (Exchange Management Shell).
O cmdlet Get-ExchangeCertificate não oferece suporte completo ao PowerShell remoto. Recomendamos que ao invés disso, você use o Exchange Management Shell para obter todas as propriedades deste cmdlet.

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

Tempo estimado para conclusão: menos de 5 minutos
Depois de se conectar, os cmdlets e os parâmetros aos quais você tem ou não acesso são controlados pelo controle de acesso baseado em função (RBAC). Para obter mais informações, consulte Permissões do Exchange Server.
Você pode usar as seguintes versões do Windows:
- Windows 11
- Windows 10
- Windows 8.1
- Windows Server 2019
- Windows Server 2016
- Windows Server 2012 ou Windows Server 2012 R2
- Windows 7 Service Pack 1 (SP1) ^*
- Windows Server 2008 R2 SP1^*
^* Esta versão do Windows atingiu o fim do suporte. Agora, só há suporte para a execução em máquinas virtuais do Azure. Para usar esta versão do Windows, é necessário instalar o Microsoft .NET Framework 4.5 ou posterior e uma versão atualizada do Windows Management Framework: 3.0, 4.0 ou 5.1 (somente uma). Para obter mais informações, confira Instalar o .NET Framework, Windows Management Framework 3.0, Windows Management Framework 4.0 e Windows Management Framework 5.1.
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:

Não é possível carregar arquivos porque a execução de scripts está desabilitada neste sistema. Forneça um certificado válido para assinar os arquivos.

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
```
Para obter mais informações sobre as políticas de execução, confira Sobre Políticas de Execução.

Dica

Ter problemas? Peça ajuda no fórum do Exchange Server.

Conectar a um servidor remoto do Exchange

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 Credenciais do Windows PowerShell, digite seu nome de usuário principal (UPN) (por exemplo, chris@contoso.com) e senha e, em seguida, clique em OK.
Substitua <ServerFQDN> pelo totalmente qualificado nome de domínio do seu servidor Exchange (por exemplo, mailbox01.contoso.com) e execute o seguinte comando:
```
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://<ServerFQDN>/PowerShell/ -Authentication Kerberos -Credential $UserCredential
```
Observação: O valor de ConnectionUri httpé nãohttps.

Execute o seguinte comando:

Import-PSSession $Session -DisableNameChecking

Observação

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 são importados para sua sessão local do Windows PowerShell e rastreados por uma barra de progresso. Se você não receber nenhum erro, você se conectou com sucesso. Um teste rápido é executar um cmdlet do Exchange (por exemplo, Get-Mailbox) e analisar 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.
A conta que você usou para conectar-se ao servidor Exchange precisa estar habilitada para acesso do PowerShell remoto. Para obter mais informações, consulte Controlar acesso do PowerShell remoto para servidores Exchange.
O tráfego na porta 80 TCP precisa estar aberto entre o seu computador local e o servidor do Exchange. Ele provavelmente está aberto, mas é algo a ser considerado caso a sua organização tenha uma política de acesso à Internet restritiva.

Confira também

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