Conectar o PowerShell ao Office 365: Tutorial Passo a Passo

Conectar ao Office 365 com o PowerShell pode ser complicado às vezes. Você precisa constantemente lembrar de comandos diferentes e módulos. Vamos mudar isso.

Neste artigo, você aprenderá como conectar o PowerShell ao Office 365. Você fará isso usando o módulo Azure AD PowerShell for Graph e o módulo Active Directory do Azure para o Windows PowerShell.

O eBook Microsoft 365 Backup For Dummies aborda os desafios de segurança de dados, destacando os recursos de segurança prontos para uso no Microsoft 365. Obtenha o eBook

Pré-requisitos

Para seguir qualquer um dos exemplos neste tutorial, certifique-se de ter os seguintes itens com antecedência:

• Windows PowerShell 5.1 ou PowerShell 7
• Um locatário do Office 365
• Microsoft Online Services Sign-In Assistant para Profissionais de TI RTW

Você pode baixar o PowerShell 7 do site da Microsoft

Usando o PowerShell para se conectar ao Office 365

O Office 365 inclui uma ampla gama de serviços que incluem, entre outros:

• Azure Active Directory.
• Exchange Online.
• Microsoft Teams.

Os serviços do Office 365 estão todos disponíveis por meio de um portal da web de acesso comum chamado https://portal.microsoft.com. Este portal oferece acesso à configuração de domínio, configuração do locatário, faturamento e gerenciamento das configurações do usuário. Mas se você precisa acessar os serviços do Office 365, como o Exchange Online ou o Microsoft Teams, você precisa clicar no nome do serviço no portal, o que o levará ao centro de administração do serviço, como o Centro de Administração do Exchange, e assim por diante.

Cada serviço tem seu próprio portal de centro de administração e módulo do PowerShell. Portanto, se você precisar se conectar para gerenciar usuários no Exchange Online, será necessário baixar o módulo do PowerShell do Exchange Online. Se desejar gerenciar usuários no Teams, será necessário baixar o módulo do Teams e também o módulo do PowerShell do Azure Active Directory.

Baixando e instalando o Módulo do PowerShell do Office 365

Uma abordagem fácil é usar o próprio PowerShell para encontrar, baixar e instalar o módulo do PowerShell. Vamos tentar obter o módulo do PowerShell do Exchange Online. Comece abrindo o PowerShell e digite o seguinte comando de linha do PowerShell para encontrar os módulos disponíveis relacionados ao Exchange Online.

Find-Module Exchangeonline*

Você pode usar um caractere curinga para pesquisar todos os módulos relacionados do PowerShell

Usar o comando Find-Module ajuda a procurar um módulo na galeria do PowerShell. Você pode encontrar vários módulos do PowerShell. O que estamos procurando é o ExchangeOnlineManagement. Para baixar e instalar o módulo, use o cmdlet install-module

. Se nenhum erro for retornado, então está pronto para começar a usar o módulo. O próximo passo é começar a usar o módulo

. Desde o PowerShell 3, o PowerShell pode importar automaticamente o módulo na primeira vez que você executa qualquer comando relacionado ao módulo instalado

. O mesmo método de download do módulo é aplicável a qualquer outro módulo, basta saber o nome do módulo e baixá-lo

. Conectar o PowerShell aos Serviços do Office 365

. Cada Office 365 tem seu próprio módulo do PowerShell, o que torna a gestão entre serviços um pouco desafiadora. Geralmente, qualquer módulo do Office 365 tem um cmdlet similar Connect-*NomeDoServiço*

• . Para se conectar ao Exchange Online, você pode usar o cmdlet Connect-ExchangeOnline, que está disponível no módulo ExchangeOnlineManagement
• . Para se conectar ao Microsoft Teams, use o seguinte cmdlet Connect-MicrosoftTeams, que está disponível no módulo MicrosoftTeams
• . Para se conectar ao Azure AD usando o Azure AD PowerShell para Graph, use Connect-AzureAD, disponível no módulo AzureAD
• . Conectar-se ao SharePoint Online, use Connect-PnPOnline, disponível no módulo Microsoft.Online.SharePoint.PowerShell.
• Conecte-se ao módulo Azure AD para o Windows PowerShell, use o Connect-MsolService que está disponível no módulo MSOnline

O PowerShell Core não suporta o módulo Azure AD para o Windows PowerShell e cmdlets com o nome Msol.

Por que dois módulos do Azure AD?

Ao trabalhar com o Office 365 usando o PowerShell, provavelmente você terá que usar dois módulos diferentes. Você usará o Azure Active Directory PowerShell para Graph com o nome do módulo AzureAD e o Módulo Azure Active Directory para o Windows PowerShell com o nome do módulo MSOnline

AzureAD e MSOnline ambos permitem que você trabalhe com os serviços do Office 365 usando o PowerShell, então por que dois? AzureAD é o sucessor do MSOnline e pelo que pude entender, substituirá o MSOnline em algum momento. Todas as novas funcionalidades estão no módulo AzureAD, mas ainda há alguma sobreposição com o módulo MSOnline.

Você encontrará tarefas como gerenciamento de usuários, grupos e administração de licenças ainda existentes no módulo MSOnline.

Se você precisa se conectar ao Exchange Online via MFA, a Microsoft fornece um ótimo guia intitulado Conectar ao Exchange Online PowerShell Usando Autenticação Multifator.

Usando o PowerShell para conectar a vários Serviços do Office 365

Os módulos do Office 365 PowerShell parecem uma grande lista, não é mesmo?! No entanto, é possível se conectar a todos os serviços em um único console e realizar todas as tarefas no mesmo console usando o seguinte código PowerShell.

$CloudCred=Get-Credential
$TenantName="Test for test.onmicrosoft.com"
Connect-AzureAD -Credential $CloudCred
Connect-PnPOnline -Url https://$TenantName.sharepoint.com -Credentials $CloudCred
Connect-ExchangeOnline -Credential $CloudCred
Connect-MicrosoftTeams -Credential $CloudCred

Você pode encontrar o seguinte erro ao se conectar ao SharePoint

Connect-PnPOnline: AADSTS65001: O usuário ou administrador não consentiu o uso da aplicação com ID ‘31359c7f-bd7e-8888-86db-fdb8c937548e’ chamada ‘PnP Management Shell’. Envie uma solicitação de autorização interativa para este usuário e recurso. ID de rastreamento: b9913a0b-b47d-4ffe-bdc7-70ed81143000

Para corrigir este problema, execute o cmdlet Register-PnPManagementShellAccess, digite o nome de usuário e a senha e certifique-se de marcar a opção “Consentir em nome da sua organização“.

Sempre certifique-se de que seus módulos estão atualizados, pois novos recursos e compatibilidades são adicionados frequentemente; a maioria dos módulos do Office 365 PowerShell agora suporta Autenticação Multifator.

O eBook Microsoft 365 Backup For Dummies aborda os desafios de segurança de dados, delineando os recursos de segurança prontos para uso no Microsoft 365. Obtenha o eBook

Resumo

O Office 365 possui muitos serviços, mas felizmente, você pode gerenciá-los todos com o PowerShell. Depois de instalar ambos os módulos e conectar usando os comandos Connect, você está pronto para gerenciar o Office 365 com o PowerShell!