Azure Active Directory (MSOnline)

  • Artigo

Azure AD e módulos do PowerShell do MSOnline foram preteridos a partir de 30 de março de 2024. Para saber mais, leia a atualização de substituição. Após essa data, o suporte para esses módulos é limitado à assistência de migração para o SDK do Microsoft Graph PowerShell e correções de segurança. Os módulos preteridos continuarão funcionando até 30 de março de 2025.

É recomendável migrar para o Microsoft Graph PowerShell para interagir com Microsoft Entra ID (anteriormente Azure AD). Para perguntas comuns sobre migração, consulte as Perguntas frequentes sobre migração. Nota: As versões 1.0.x do MSOnline podem sofrer interrupções após 30 de junho de 2024.

Você pode usar o MSOnline para Azure AD tarefas administrativas, como gerenciamento de usuários, gerenciamento de domínio e para configurar o logon único. Este tópico inclui informações sobre como instalar esses cmdlets para usar com seu diretório.

Instalar o MSOnline

O MSonline tem suporte nos seguintes sistemas operacionais Windows com a versão padrão do Microsoft .NET Framework e Windows PowerShell: Windows 8.1, Windows 8, Windows 7, Windows Server 2012 R2, Windows Server 2012 ou Windows Server 2008 R2.

A maneira mais fácil de instalar o módulo é da Galeria do PowerShell. Você pode instalar o módulo com o cmdlet Install-Module:

Install-Module MSOnline

Conecte-se ao AD do Azure

Antes de executar qualquer um dos cmdlets analisados neste artigo, primeiro você deve conectar seu serviço online. Para fazer isso, execute o cmdlet Connect-MsolService no prompt de comando do Windows PowerShell. Então, serão solicitadas suas credenciais. Se você quiser, poderá fornecer suas credenciais antecipadamente, por exemplo:

$Msolcred = Get-credential
Connect-MsolService -Credential $MsolCred

O primeiro comando solicita credenciais e as armazena como $Msolcred. O próximo comando usa essas credenciais como $Msolcred para se conectar ao serviço.

Para conectar um ambiente específico do Azure Active Directory, use o parâmetro AzureEnvironment da seguinte maneira:

Connect-MsolService -AzureEnvironment "AzureGermanyCloud"

Este exemplo conecta sua sessão do PowerShell ao ambiente do AzureAD alemão.

Confira Connect-MsolService para saber mais.

Para saber mais sobre os cmdlets, faça o seguinte:

  • Para criar uma pasta para obter ajuda, liste os cmdlets e, em seguida, abra o arquivo no bloco de notas, execute os seguintes comandos no prompt de comando do Windows PowerShell:
New-Item c:\MsolHelp -Type directory
Get-command | Where-Object {$_.name -like "*msol*"} | Format-List | Out-File c:\MsolHelp\msolcmdlets.txt
Notepad c:\MsolHelp\msolcmdlets.txt

  • Veja os exemplos de um cmdlet, execute o seguinte comando no prompt de comando do Windows PowerShell: Get-Help <cmdlet-name> -Examples

  • Exiba o nome, sinopse, descrição, descrições de parâmetro e quaisquer exemplos fornecidos para um cmdlet, execute o seguinte comando no prompt de comando do Windows PowerShell: Get-Help <cmdlet-name> -Detailed

  • Exiba o nome, sinopse, descrição, parâmetros detalhados e quaisquer exemplos fornecidos para um cmdlet, execute o seguinte comando no prompt de comando do Windows PowerShell: Get-Help <cmdlet-name> -Full

Confira também