Compartilhar via

Sincronização de dados do PowerShell for School

  • Artigo

Quando você está trabalhando com SDS (Sincronização de Dados Escolares) e Microsoft Entra ID, executar tarefas e ações no PowerShell é útil. O PowerShell permite que operações em massa e scripts sejam concluídas com facilidade. Este artigo explica a instalação e os pré-requisitos para começar a usar o PowerShell com Microsoft Entra ID e Sincronização de Dados Escolares, permitindo que os administradores usem o PowerShell como uma ferramenta para gerenciar melhor seus dados SDS sincronizados.

Para referência, você pode encontrar aqui scripts do PowerShell do SDS.

Instalar o SDK do Microsoft Graph PowerShell

Para o gerenciamento de objetos SDS no PowerShell, recomendamos instalar o Microsoft Graph PowerShell. Para examinar os pré-requisitos e instalar ambos os módulos, siga estas instruções:

Instale o Microsoft Graph PowerShell.

Confirmar a instalação e importar o módulo

Depois de instalado, confirme se o módulo foi instalado com êxito. O comando também é como você carrega o módulo no PowerShell. Carregar o módulo no PowerShell permite que você execute os cmdlets associados ao módulo.

Para confirmar se o módulo está instalado e importado no PowerShell, execute estas etapas:

  1. Inicie o PowerShell.

  2. Execute este comando para garantir que o módulo seja carregado e instalado com êxito.

    Get-InstalledModule Microsoft.Graph

    Observação

    O comando retorna a versão, o nome e o descritpion instalados do módulo do Microsoft Graph, se ele estiver instalado em seu sistema.

  3. Para importar o módulo do Microsoft Graph, execute o seguinte comando:

    Import-Module Microsoft.Graph

Conectar-se a Microsoft Entra ID usando o PowerShell

Depois que os Módulos forem importados, você precisará conectar o PowerShell a Microsoft Entra ID para executar os comandos associados a cada módulo no diretório Microsoft Entra.

Observação

Você usará o acesso delegado para entrar como usuário. Você só precisa entrar uma vez por sessão.

  1. Conecte o módulo do Microsoft Graph ao Microsoft Entra ID.

    Connect-MgGraph -Scopes 
"User.Read.All","Group.ReadWrite.All"

  2. O comando solicita que você navegue até uma página da Web para autenticação.

  3. Selecione no botão Avançar ou Entre para continuar. Ele pede permissões e consentimento em nome de sua organização para se conectar ao Microsoft Graph PowerShell.

  4. Habilite a caixa de seleção "Consentimento em nome da sua organização" e selecione o botão Aceitar.

  5. Após a verificação bem-sucedida, o terminal do PowerShell exibe 'Bem-vindo ao Microsoft Graph!'