Instalando o Módulo do PowerShell para Microsoft 365

O Microsoft Graph PowerShell SDK é a evolução natural dos módulos Azure AD PowerShell e MSOnline. Ele é recomendado para interagir com o Microsoft 365 e outros serviços da Microsoft. Vamos explorar o que torna o Microsoft Graph PowerShell SDK uma escolha poderosa.

Mas antes de começarmos, certifique-se de que seu ambiente atenda aos seguintes pré-requisitos:

Versão do PowerShell: 5.1 ou superior.
NET Framework: 4.7.2 ou superior.

Além de abranger o Microsoft 365, o Microsoft Graph incorpora APIs de uma ampla gama de serviços, incluindo SharePoint, Exchange e Teams. Ele oferece suporte à autenticação moderna, é constantemente atualizado e permite a integração de usuários externos de outros Tenants.

Chega de conversa, vamos preparar o terreno?

Alguns agentes exigem que a política de execução do PowerShell seja definida como RemoteSigned, isso permite que os scripts do PowerShell sejam executados. Abra o Powershell como Administrador:

Set-ExecutionPolicy RemoteSigned

Ou se desejar saber politica de execução atual, caso esteja RemoteSigned então não é necessário executar o comando informado acima.

Get-ExecutionPolicy

Instalando, atualizando e removendo os módulos

Para instalar os módulos necessários, utilize os comandos abaixo:

Install-Module Microsoft.Graph -Scope CurrentUser

Para o módulo beta (Microsoft.Graph.Beta):

Install-Module Microsoft.Graph.Beta -force

Para consultar se a instalação foi bem-sucedida execute:

Get-Module Microsoft.Graph

Para atualizar ou remover os módulos, você pode executar os seguintes comandos:

Update-Module Microsoft.Graph

Uninstall-Module Microsoft.Graph -AllVersions

Conectando-se ao Microsoft 365 pelo PowerShell

Antes de prosseguir, assegure-se de ter uma conta corporativa com a função de administrador do Microsoft 365. Em seguida, conecte-se ao Microsoft Graph utilizando o PowerShell com privilégios de administrador:

Connect-MgGraph -Scopes “User.Read.All”,”Group.ReadWrite.All”

Após executar o comando, será necessário autenticar-se com a sua conta. Como administrador, é requisito estar com o MFA (Multifator de Autenticação) ativado, conforme demonstrado nas imagens a seguir.

Se esta for sua primeira autenticação no powershell é necessário conceder as permissões solicitadas, conforme demonstrado abaixo:

Após autenticar verifique a conexão estabelecida:

Get-MgContext

A partir daí, o mundo do Microsoft Graph está ao seu alcance. Brinque um pouco, experimente comandos como Get-MgUser para listar todas as contas e comece a explorar o vasto potencial que o PowerShell oferece para simplificar e automatizar suas tarefas diárias.

Embora os comandos possam parecer desafiadores inicialmente, com prática e tempo, você se tornará mais familiarizado e eficiente. O Microsoft Graph PowerShell SDK é uma ferramenta poderosa para gerenciar suas operações no Microsoft 365 e além.

Recomendo a leitura oficial da Microsoft:

Instalando o Microsoft Graph PowerShell SDK
Usando Connect-MgGraph
Conecte-se ao Microsoft 365 com o Microsoft Graph PowerShell

Compartilhe suas experiências com o PowerShell e conte suas histórias!