Conectar-se ao Exchange Online usando o Windows PowerShell
O PowerShell do Exchange Online é o módulo que você pode usar para gerenciar objetos relacionados a email no Exchange Online, como caixas de correio, contatos e distribuição. Algumas das informações que você pode revisar e gerenciar usando o PowerShell do Exchange Online, como endereços de email, você também pode revisar nas propriedades de objetos de usuário com cmdlets AzureAD. No entanto, você só pode gerenciar propriedades relacionadas a email usando o PowerShell do Exchange Online.
Nota
No momento da escrita deste caminho de aprendizagem, o módulo Exchange Online PowerShell V2 (EXO v2) é a versão atual. Ao pesquisar como se conectar ao Exchange Online, as instruções que indicam que você precisa usar a comunicação remota do PowerShell ou o cmdlet Connect-EXOPSSession estão desatualizadas e não devem ser seguidas.
O módulo EXO v2 inclui todos os cmdlets originais para gerenciar o Exchange Online e vários cmdlets adicionais que incluem EXO no nome do cmdlet. Esses cmdlets EXO, como Get-EXOMailbox, são mais eficientes do que os cmdlets originais.
Instalação do módulo EXO v2
O módulo EXO v2 é suportado no Windows PowerShell 5.1 e no PowerShell 7. Como é suportado no PowerShell 7, é considerado multiplataforma. Você pode usar o módulo EXO v2 no Windows, macOS e Linux.
Para instalar o módulo EXO v2, execute o seguinte comando:
Install-Module -Name ExchangeOnlineManagement
Preparando-se para se conectar
Para usar o módulo EXO v2, você precisa permitir scripts. Você pode definir a política de execução como RemoteSigned ou Unrestricted. Se você não permitir scripts, notará que os arquivos de erro não podem ser carregados porque a execução de scripts está desabilitada neste sistema.
Você também precisa permitir a autenticação básica para o cliente WinRM. Isso é habilitado por padrão no Windows 10, mas algumas organizações desabilitaram a autenticação básica para o WinRM como parte da proteção de segurança. Se a autenticação Básica não estiver habilitada, você notará o erro O cliente WinRM não pode processar a solicitação. A autenticação básica está atualmente desativada na configuração do cliente.
Para revisar a configuração de autenticação para o cliente de Gerenciamento Remoto do Windows (WinRM), execute o seguinte comando:
winrm get winrm/config/client/auth
Para habilitar a autenticação básica para o cliente WinRM, execute o seguinte comando:
winrm set winrm/config/client/auth '@{Basic="true"}'
Nota
Se você executar esse comando a partir de um prompt de comando em vez de um prompt do PowerShell, não inclua as aspas simples em torno @{Basic="true"}do .
Embora você precise habilitar a autenticação Básica no cliente WinRM, o módulo EXO v2 autentica no Exchange Online usando a autenticação moderna. Em alguns casos raros, a autenticação moderna pode não estar habilitada para o Exchange Online e você precisará habilitá-la.
Nota
Todas as implantações do Exchange Online devem usar a autenticação moderna. Isso ocorre porque ele tem aprimoramentos de segurança significativos em relação à autenticação básica.
Conectando-se ao Exchange Online
Você pode se conectar ao Exchange Online usando o cmdlet Connect-ExchangeOnline sem parâmetros adicionais. Quando se liga ao Exchange Online, é-lhe pedido um nome de utilizador e uma palavra-passe para iniciar sessão. Você precisa entrar com uma conta de usuário que tenha privilégios suficientes para concluir as ações que deseja executar. Você também pode ser solicitado a fornecer autenticação multifator.
Nota
Para locatários na China ou na Alemanha, você precisa usar o parâmetro -ExchangeEnvironmentName e especificar O365China ou O365Germany, respectivamente. Para locatários seguros do governo dos EUA, você precisa especificar O365USGovGCCHigh ou O365USGovDOD.
Se você estiver atrás de um servidor proxy, talvez seja necessário fornecer opções de proxy como parte da conexão. Para fazer isso, forneça um objeto PSSessionOption as informações de configuração do proxy. O exemplo a seguir mostra como criar um novo objeto PSSessionOption e usá-lo ao se conectar ao Exchange Online:
$ProxyOptions = New-PSSessionOption -ProxyAccessType IEConfig
Connect-ExchangeOnline -PsSessionOption $ProxyOptions