O que é Microsoft Entra PowerShell?

O módulo Microsoft Entra PowerShell é uma ferramenta de linha de comando que permite que os administradores gerenciem e automatizem Microsoft Entra recursos programaticamente. Esses recursos incluem o gerenciamento eficiente de usuários, grupos, aplicativos, entidades de serviço, políticas e muito mais. O módulo se baseia e faz parte do SDK do PowerShell do Microsoft Graph. Ele é totalmente interoperável com todos os cmdlets no SDK do PowerShell do Microsoft Graph, permitindo que você execute operações complexas com comandos simples e bem documentados.

O módulo também oferece uma opção de compatibilidade com versões anteriores para simplificar a migração do módulo AzureAD PowerShell desativado. Microsoft Entra PowerShell funciona com Windows PowerShell 5.1 e PowerShell 7+. Para obter a melhor experiência em Windows, Linux e macOS, recomendamos usar o PowerShell 7 ou posterior.

Benefícios do Microsoft Entra PowerShell

Microsoft Entra PowerShell oferece os seguintes benefícios:

  • Foco na usabilidade: Microsoft Entra PowerShell oferece parâmetros legíveis por humanos, especificação deliberada do conjunto de parâmetros, documentação embutida e conceitos básicos básicos do PowerShell, como pipelining.
  • Compatibilidade retroativa com o módulo Azure AD PowerShell: o Microsoft Entra PowerShell simplifica a migração do módulo Azure AD PowerShell que será descontinuado.
  • Autorização flexível e granular: consistente com SDK do PowerShell do Microsoft Graph, Microsoft Entra PowerShell permite o consentimento administrativo para as permissões que você deseja conceder ao aplicativo. Também oferece suporte à execução do Microsoft Entra PowerShell usando sua própria entidade de serviço ou uma identidade gerenciada atribuída pelo usuário.
  • Open source: Microsoft Entra módulo do PowerShell é código aberto, permitindo a colaboração da comunidade para aprimorar o PowerShell e compartilhar inovações. Você pode explorar as personalizações de Microsoft e adaptá-las às suas necessidades.

Migrar do módulo do PowerShell do Azure AD

O Microsoft Entra PowerShell é mais de 98% compatível com o módulo Azure AD PowerShell e tem mais de 80% de paridade com os cmdlets do MSOnline. Usando o comando Enable-EntraAzureADAlias, você só precisa atualizar uma ou duas linhas em seus scripts existentes, tornando a migração para Microsoft Entra PowerShell rápida e fácil. Para obter mais informações sobre como migrar dos módulos herdados para Microsoft Entra PowerShell, consulte o guia de migração.

Instalação e introdução

O módulo do PowerShell do 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 gerenciar Microsoft Entra recursos, como criar usuários, grupos e outras tarefas, consulte o guia Navegar no módulo.

práticas recomendadas do Microsoft Entra PowerShell

Você pode aplicar as práticas recomendadas para otimizar o uso de Microsoft Entra PowerShell, garantir scripts eficientes, acesso seguro e gerenciamento eficaz de recursos. Este guia ajuda você a seguir os métodos recomendados, evitando armadilhas comuns e aumentando a produtividade geral.

Problemas conhecidos

A seção a seguir descreve os problemas conhecidos com o módulo Microsoft Entra PowerShell, juntamente com as soluções alternativas recomendadas.

Característica Questão Workaround/Comments
-All Parâmetro Não oferecemos suporte a -All parâmetro booleano, como acontecia com o módulo do PowerShell do Azure AD. -All tem suporte como um parâmetro de comutador. Substitua -All:$true pelo -All parâmetro em seus scripts.
-SearchString Parâmetro O parâmetro -SearchString pode não funcionar conforme o esperado. Nenhuma solução alternativa disponível.