Azure Active Directory (MSOnline)

  • Artigo

Importante

Os módulos do PowerShell do Azure AD e do MSOnline são 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.

Recomendamos migrar para o Microsoft Graph PowerShell para interagir com a ID do Microsoft Entra (antigo 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 cmdlets do MSOnline para tarefas administrativas do Azure AD, 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 módulo MSOnline tem suporte nos seguintes sistemas operacionais Windows com a versão padrão do Microsoft .NET Framework e do Windows PowerShell: Windows 8.1, Windows 8, Windows 7, Windows Server 2012 R2, Windows Server 2012 ou Windows Server 2008 R2.

Você pode instalar este módulo por meio da Galeria do PowerShell.

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 as credenciais e armazena-as como $Msolcred. O comando seguinte usa essas credenciais como $Msolcred para conectar ao serviço.

Para conectar-se a 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

Observação

O MSOnline PowerShell só pode ser usado por usuários que são membros do diretório. Os usuários convidados não podem usar o POWERShell do MSOnline.

Mais sobre o Windows PowerShell

O Windows PowerShell é um shell da linha de comando baseado em tarefas e uma linguagem de script desenvolvida para administração do sistema. Ao contrário de muitos shells, que aceitam e retornam texto, o Windows PowerShell se baseia no .NET Framework, aceita e retorna objetos do .NET Framework.

O Windows PowerShell apresenta o conceito de um cmdlet (pronuncia-se "command-let"), uma ferramenta de linha de comando de função única simples integrada ao shell.

Os cmdlets têm a seguinte convenção de nomenclatura: um verbo e um substantivo separados por um traço (-), como Get-Help, Get-Process e Start-Service.

O Windows PowerShell inclui mais de 100 cmdlets de núcleo básico. Para obter mais informações sobre o Windows PowerShell, consulte Introdução ao PowerShell do Microsoft Azure (a página pode estar em inglês).