O que é o Microsoft Entra PowerShell?

O módulo PowerShell Microsoft Entra é uma ferramenta de linha de comandos que permite aos administradores gerir e automatizar os recursos do Microsoft Entra de forma programática. Estas capacidades incluem a gestão eficiente de utilizadores, grupos, aplicações, princípios de serviço, políticas e muito mais. O módulo baseia-se e faz parte do SDK do PowerShell nos Microsoft Graph. É totalmente interoperável com todos os cmdlets do SDK do PowerShell nos Microsoft Graph, permitindo-lhe executar operações complexas com comandos simples e bem documentados.

O módulo também oferece uma opção de retrocompatibilidade para agilizar a migração a partir do módulo PowerShell AzureAD que está a ser retirado. O Microsoft Entra PowerShell funciona com Windows PowerShell 5.1 e PowerShell 7+. Para uma melhor experiência no Windows, Linux e macOS, recomendamos usar o PowerShell 7 ou versões posteriores.

Benefícios do Microsoft Entra PowerShell

O Microsoft Entra PowerShell oferece os seguintes benefícios:

  • Foco na usabilidade: O Microsoft Entra PowerShell oferece parâmetros legíveis por humanos, especificação deliberada de conjuntos de parâmetros, documentação inline e fundamentos essenciais do PowerShell como pipeline.
  • Compatibilidade retroativa com o módulo PowerShell do Azure AD: O Microsoft Entra PowerShell simplifica a migração do módulo PowerShell do Azure AD que está a ser retirado.
  • Autorização flexível e detalhada: Em conformidade com o SDK do PowerShell nos Microsoft Graph, o Microsoft Entra PowerShell permite consentimento administrativo para as permissões que pretende conceder à aplicação. Também suporta a execução do Microsoft Entra PowerShell usando o seu próprio principal de serviço ou identidade gerida atribuída pelo utilizador.
  • Open source: O módulo PowerShell da Microsoft Entra é open source, permitindo a colaboração comunitária para melhorar o PowerShell e partilhar inovações. Pode explorar as personalizações da Microsoft e adaptá-las às suas necessidades.

Migrar do módulo PowerShell do Azure AD

O Microsoft Entra PowerShell tem uma compatibilidade superior a 98% com o módulo Azure AD PowerShell e uma paridade superior a 80% com os cmdlets do MSOnline. Ao usar o comando Enable-EntraAzureADAlias, só precisa de atualizar uma ou duas linhas nos seus scripts existentes, tornando a migração para o Microsoft Entra PowerShell rápida e fácil. Para mais informações sobre como migrar dos módulos legados para o Microsoft Entra PowerShell, consulte o guia de Migração.

Instalação e início

O módulo PowerShell Microsoft Entra está publicado na Galeria do PowerShell. Para saber como instalar o módulo, consulte o guia de instalação do Microsoft Entra PowerShell.

Para começar a gerir recursos do Microsoft Entra, como criar utilizadores, grupos e outras tarefas, consulte o guia Navegar no módulo.

Boas práticas do PowerShell para o Microsoft Entra

Pode aplicar as melhores práticas para otimizar o uso do Microsoft Entra PowerShell, garantir scripts eficientes, acesso seguro e gestão eficaz de recursos. Este guia ajuda-o a seguir os métodos recomendados, evitando armadilhas comuns e aumentando a produtividade global.

Problemas conhecidos

A secção seguinte descreve os problemas conhecidos com o módulo PowerShell da Microsoft Entra, juntamente com soluções alternativas recomendadas.

Feature Issue Workaround/Comments
-All Parâmetro Não suportamos -All parâmetros booleanos como foi o caso do módulo PowerShell do Azure AD. -All é suportado como parâmetro de comutador. Substitui -All:$true por -All parâmetro nos teus scripts.
-SearchString Parâmetro O parâmetro -SearchString pode não funcionar como esperado. Não há solução alternativa.

Conteúdo relacionado

  • Last updated on